RocketChat/Rocket.Chat · error · Error

SAML User Map: Invalid configuration for ${spFieldName} fiel

Error message

SAML User Map: Invalid configuration for ${spFieldName} field.

What it means

Error "SAML User Map: Invalid configuration for ${spFieldName} field." thrown in RocketChat/Rocket.Chat.

Source

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

			},
			name: {
				fieldName: 'cn',
			},
			identifier: {
				type: '',
			},
		};

		let identifier = immutableProperty.toLowerCase();

		for (const spFieldName in map) {
			if (!map.hasOwnProperty(spFieldName)) {
				continue;
			}

			const attribute = map[spFieldName];
			if (typeof attribute !== 'string' && typeof attribute !== 'object') {
				throw new Error(`SAML User Map: Invalid configuration for ${spFieldName} field.`);
			}

			if (spFieldName === '__identifier__') {
				if (typeof attribute !== 'string') {
					throw new Error('SAML User Map: Invalid identifier.');
				}

				identifier = attribute;
				continue;
			}

			let attributeMap: IAttributeMapping | null = null;

			// If it's a complex type, let's check what's in it
			if (typeof attribute === 'object') {
				// A fieldName is mandatory for complex fields. If it's missing, let's skip this one.
				if (!attribute.hasOwnProperty('fieldName') && !attribute.hasOwnProperty('fieldNames')) {
					continue;

View on GitHub (pinned to 2a7de45707)

Solutions

1. Correct the SAML user data map entry for the field; each entry must define a valid attribute, plus an optional regex or template.

When it happens

Trigger: Thrown when a SAML user map entry for a service provider field has an invalid or incomplete configuration.

Common situations: See trigger scenarios.

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