Si vous ou les membres de votre équipe avez du mal à vous connecter à AI Studios avec le SSO SAML, le problème vient généralement d’une erreur de configuration dans les paramètres de votre fournisseur d’identité (IdP). Ce guide présente les causes les plus fréquentes et la façon de les résoudre.
Vérifiez que vous utilisez bien le SSO SAML
AI Studios prend en charge le SSO basé sur SAML 2.0. Les autres protocoles, comme OAuth ou OpenID, ne sont pas pris en charge.
Pour utiliser le SSO, votre entreprise doit disposer :
d’un fournisseur d’identité compatible SAML (par exemple Okta, Microsoft Entra ID / Azure AD) ;
d’une application SAML correctement configurée.
Si vous ne savez pas si votre espace de travail utilise le SSO, contactez votre équipe informatique ou l’administrateur de l’espace de travail.
Problèmes fréquents et solutions
1. Le compte de connexion de l’IdP et l’adresse e-mail de connexion à AI Studios ne correspondent pas exactement (sensible à la casse)
• Lors d’une connexion via MS Entra ID, une valeur Unique User Identifier est transmise à AI Studios • Cette valeur doit correspondre exactement (y compris la casse) à l’adresse e-mail de connexion à AI Studios
Solution
Cas 1. Modifier la valeur définie dans Unique User Identifier
Remplacez Unique User Identifier par user.displayname
Définissez le nom d’affichage (Display name) de chaque utilisateur pour qu’il corresponde exactement (y compris la casse) à son adresse e-mail de connexion à AI Studios
Guide de modification de l’identifiant utilisateur unique dans Microsoft Entra ID
Guide de modification de l’identifiant utilisateur unique dans Microsoft Entra ID
Étape 1 : Accédez à Attributes & Claims de votre application AI Studios dans Microsoft Entra ID.
Repérez la ligne Unique User Identifier et cliquez sur Edit.
Étape 2 : Sur la page de modification, retrouvez le champ Unique User Identifier.
Cliquez sur le menu à trois points à droite de cette ligne.
Étape 3 : Dans le menu Manage Claim, repérez la zone de texte Source attribute.
Elle est probablement définie sur user.userprincipalname par défaut. Remplacez cette valeur par :
user.displayname
Étape 5 : Cliquez sur Save.
Étape 6 : Assurez-vous que chaque utilisateur a son adresse e-mail de connexion à AI Studios comme nom d’affichage.
Cas 2. Configurer la transmission de Unique User Identifier en minuscules !! Prérequis !!
Cette méthode n’est possible que si le User principal name correspond exactement à l’adresse e-mail de connexion à AI Studios, à la casse près
Définissez la transformation sur ToLowercase(user.userprincipalname)
Guide de gestion des transformations dans Microsoft Entra ID
Guide de gestion des transformations dans Microsoft Entra ID
Étape 1 : Accédez à Attributes & Claims de votre application AI Studios dans Microsoft Entra ID.
Repérez la ligne Unique User Identifier et cliquez sur Edit.
Étape 2 : Sur la page de modification, retrouvez le champ Unique User Identifier.
Cliquez sur le menu à trois points à droite de cette ligne.
Étape 3 : Remplacez le paramètre Source par Transformation. Il est défini sur Attribute par défaut.
Étape 4 : dans le menu Manage Transformation, définissez la transformation sur ToLowercase() .
Étape 5 : définissez Parameter 1 sur attribute. Sélectionnez ensuite user.userprincipalname dans le menu Attribute Name.
Étape 6 : enregistrez (Save) et vérifiez que cette transformation est bien enregistrée sous Unique User Identifier. Elle doit s’afficher ainsi : ToLowercase (user.userprincipalname)
2. La configuration de votre espace de travail est incomplète
Si votre lien de connexion SSO ne fonctionne pas, la configuration SSO de l’espace de travail est peut-être incomplète ou inactive.
Solution
L’administrateur de l’espace de travail doit :
cliquer sur son image de profil, sélectionner Setting, puis cliquer sur SAML SSO dans le menu de gauche ;
vérifier que tous les champs IdP sont remplis ;
s’assurer que le bouton SSO est activé ;
vérifier que l’ACS URL et l’Entity ID ont été correctement copiés dans l’IdP.
3. Informations IdP ou certificat incorrects
Le SSO peut échouer si l’un des éléments suivants est incorrect :
SSO Login URL
IdP Issuer
Certificat X.509
Expiration du certificat
Solution
Comparez la configuration de votre fournisseur d’identité avec les champs fournis dans AI Studios :
ACS URL / Callback URL
Audience URI / SP Entity ID
Certificat X.509
Besoin d’aide supplémentaire ?
Si vous avez vérifié tous les points ci-dessus et que le SSO ne fonctionne toujours pas :
faites une capture d’écran de la configuration SAML de votre IdP ;
notez l’adresse e-mail utilisée lors de la connexion ;
contactez votre gestionnaire de compte dédié en lui transmettant ces informations.
Nous vous aiderons à résoudre le problème à partir de là.