Wenn Sie oder Ihre Teammitglieder Probleme bei der Anmeldung bei AI Studios über SAML SSO haben, liegt das meist an einer Fehlkonfiguration in den Einstellungen Ihres Identity Providers (IdP). Diese Anleitung zeigt die häufigsten Ursachen und wie Sie sie beheben.
Prüfen Sie, ob Sie SAML SSO verwenden
AI Studios unterstützt SSO auf Basis von SAML 2.0. Andere Protokolle wie OAuth oder OpenID werden nicht unterstützt.
Für SSO benötigt Ihr Unternehmen:
Einen SAML-kompatiblen Identity Provider (z. B. Okta, Microsoft Entra ID / Azure AD)
Eine korrekt konfigurierte SAML-Anwendung
Wenn Sie nicht sicher sind, ob Ihr Workspace SSO verwendet, wenden Sie sich an Ihr IT-Team oder den Administrator des Workspaces.
Häufige Probleme und ihre Lösung
1. IdP-Anmeldekonto und AI Studios-Anmelde-E-Mail stimmen nicht genau überein (Groß-/Kleinschreibung)
• Bei der Anmeldung über MS Entra ID wird ein Wert für den Unique User Identifier an AI Studios übergeben • Dieser Wert muss genau (einschließlich Groß-/Kleinschreibung) mit der Anmelde-E-Mail in AI Studios übereinstimmen
So beheben Sie das Problem
Fall 1. Den im Unique User Identifier angegebenen Wert ändern
Ändern Sie den Unique User Identifier in user.displayname
Legen Sie den Display name jedes Nutzers so fest, dass er genau (einschließlich Groß-/Kleinschreibung) mit seiner AI Studios-Anmelde-E-Mail übereinstimmt
Anleitung zum Ändern des Unique User Identifier in Microsoft Entra ID
Anleitung zum Ändern des Unique User Identifier in Microsoft Entra ID
Schritt 1: Öffnen Sie in Microsoft Entra ID die Attributes & Claims Ihrer AI Studios-App.
Suchen Sie die Zeile Unique User Identifier und klicken Sie auf Edit.
Schritt 2: Suchen Sie auf der Bearbeitungsseite erneut das Feld Unique User Identifier.
Klicken Sie rechts in dieser Zeile auf das Drei-Punkte-Menü.
Schritt 3: Suchen Sie im Menü Manage Claim das Textfeld Source attribute.
Standardmäßig ist es meist auf user.userprincipalname gesetzt. Ändern Sie diesen Wert in:
user.displayname
Schritt 5: Klicken Sie auf Save.
Schritt 6: Stellen Sie sicher, dass bei allen Nutzern die AI Studios-Anmelde-E-Mail als Display name eingetragen ist.
Fall 2. Unique User Identifier in Kleinbuchstaben übergeben !! Voraussetzung !!
Diese Methode funktioniert nur, wenn der User principal name genau mit der AI Studios-Anmelde-E-Mail übereinstimmt und sich nur in der Groß-/Kleinschreibung unterscheidet
Setzen Sie die Transformation auf ToLowercase(user.userprincipalname)
Anleitung zum Verwalten der Transformation in Microsoft Entra ID
Anleitung zum Verwalten der Transformation in Microsoft Entra ID
Schritt 1: Öffnen Sie in Microsoft Entra ID die Attributes & Claims Ihrer AI Studios-App.
Suchen Sie die Zeile Unique User Identifier und klicken Sie auf Edit.
Schritt 2: Suchen Sie auf der Bearbeitungsseite erneut das Feld Unique User Identifier.
Klicken Sie rechts in dieser Zeile auf das Drei-Punkte-Menü.
Schritt 3: Ändern Sie die Einstellung Source in Transformation. Standardmäßig ist sie auf Attribute gesetzt.
Schritt 4: Legen Sie im Menü Manage Transformation die Transformation ToLowercase() fest.
Schritt 5: Setzen Sie Parameter 1 auf attribute. Wählen Sie dann im Menü Attribute Name den Wert user.userprincipalname.
Schritt 6: Speichern Sie und prüfen Sie, ob die Transformation unter Unique User Identifier korrekt gespeichert wurde. Sie sollte als ToLowercase (user.userprincipalname) angezeigt werden.
2. Die Einrichtung Ihres Workspaces ist unvollständig
Wenn Ihr SSO-Anmeldelink nicht funktioniert, ist die SSO-Konfiguration des Workspaces möglicherweise unvollständig oder inaktiv.
So beheben Sie das Problem
Der Administrator des Workspaces sollte:
Auf das Profilbild klicken, Setting auswählen und dann im linken Menü auf SAML SSO klicken
Prüfen, ob alle IdP-Felder ausgefüllt sind
Sicherstellen, dass der SSO-Schalter aktiviert ist
Prüfen, ob ACS URL und Entity ID korrekt in den IdP übernommen wurden
3. Falsche IdP-Angaben oder falsches Zertifikat
SSO kann fehlschlagen, wenn eine der folgenden Angaben falsch ist:
SSO Login URL
IdP Issuer
X.509 Certificate
Ablauf des Zertifikats
So beheben Sie das Problem
Gleichen Sie die Konfiguration Ihres Identity Providers mit den Feldern in AI Studios ab:
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 Certificate
Benötigen Sie weitere Hilfe?
Wenn Sie alle oben genannten Punkte geprüft haben und SSO weiterhin nicht funktioniert:
Erstellen Sie einen Screenshot der SAML-Konfiguration Ihres IdP
Notieren Sie die bei der Anmeldung verwendete E-Mail-Adresse
Wenden Sie sich mit diesen Angaben an Ihren zuständigen Account Manager
Wir helfen Ihnen dann bei der Fehlerbehebung.