RocketChat/Rocket.Chat · error · Error

SAML User Data Map: invalid Identifier configuration receive

Error message

SAML User Data Map: invalid Identifier configuration received.

What it means

Error "SAML User Data Map: invalid Identifier configuration received." thrown in RocketChat/Rocket.Chat.

Source

Thrown at apps/meteor/server/lib/saml/lib/Utils.ts:459

	public static normalizeUsername(name: string): string {
		const { globalSettings } = this;

		switch (globalSettings.usernameNormalize) {
			case 'Lowercase':
				name = name.toLowerCase();
				break;
		}

		return name;
	}

	public static mapProfileToUserObject(profile: Record<string, any>): ISAMLUser {
		const userDataMap = this.getUserDataMapping();
		SAMLUtils.log({ msg: 'Mapping SAML Profile to User Object', userDataMap });

		if (userDataMap.identifier.type === 'custom') {
			if (!userDataMap.identifier.attribute) {
				throw new Error('SAML User Data Map: invalid Identifier configuration received.');
			}
			if (!profile[userDataMap.identifier.attribute]) {
				throw new Error(`SAML Profile did not have the expected identifier (${userDataMap.identifier.attribute}).`);
			}
		}

		const attributeList = new Map();
		for (const attributeName of userDataMap.attributeList) {
			if (profile[attributeName] === undefined) {
				this.log({ msg: 'SAML user profile is missing the attribute.', attribute: attributeName });
				continue;
			}
			attributeList.set(attributeName, profile[attributeName]);
		}
		const email = this.getProfileValue(profile, userDataMap.email);
		const profileUsername = this.getProfileValue(profile, userDataMap.username, true);
		const name = this.getProfileValue(profile, userDataMap.name, true);

View on GitHub (pinned to 2a7de45707)

Solutions

1. Configure the identifier section of the SAML user data map with a valid attribute name from the IdP profile.

When it happens

Trigger: Thrown when the SAML user data map identifier configuration received from settings is invalid.

Common situations: See trigger scenarios.

AI-assisted analysis of RocketChat/Rocket.Chat@2a7de45707 (2026-08-18). Data as JSON: /api/errors/81b815110425f543. Report an issue: GitHub.