Administration

Phrase Identity Management

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Platform Single Login

Die Phrase Localization Platform ermöglicht die zentrale Anmeldung bei den verschiedenen Phrase-Produkten über eine einzige Anmelde- oder Registrierungsseite. Zur Registrierung oder Anmeldung über die Plattform https://eu.phrase.com (für EU-Rechenzentren) oder https://us.phrase.com (für das US-Rechenzentrum) aufrufen.

Neue Benutzer, die sich bei der Plattform registrieren, sowie bestehende Phrase-Benutzer können im Plattform-Dashboard zwischen allen verfügbaren Produkten wechseln, ohne sich bei jedem einzeln anmelden zu müssen.

Nach der Anmeldung bei der Plattform oben links das Dropdown-Menü Dashboard auswählen, um nach Bedarf zwischen den abonnierten Produkten zu wechseln. Der Produktwechsler ist auch in jeder Produktoberfläche für alle Benutzer mit einem Plattform-Benutzerprofil verfügbar.

Voraussetzungen für den Produktzugriff

  • Der Zugriff auf Produkte richtet sich nach dem erworbenen Tarif

  • Phrase TMS und Phrase Strings

  • Phrase Orchestrator

    • Zugriff auf TMS oder Strings

  • Phrase Custom AI, Phrase Language AI und Phrase Analytics

Hinweis

Weitere Informationen zu Plattform-Tarifen, den darin verfügbaren Funktionen und Nutzungsgrenzen sind auf der Phrase-Preisseite zu finden.

Bestehende TMS- oder Strings-Benutzer können sich auf der Plattform-Anmeldeseite mit Benutzername und Passwort oder über Platform SSO anmelden.

Wichtig

Wenn SSO aktiviert ist, wird das Ändern einer Benutzer-E-Mail-Adresse in der Benutzeroberfläche nicht unterstützt. Bei SCIM-verwalteten Benutzern werden E-Mail-Änderungen über den Identitätsanbieter vorgenommen.

Status der Identitätszugehörigkeit

Benutzer können Mitglied mehrerer Phrase-Organisationen sein und bei Bedarf zwischen ihnen wechseln. Um die Richtlinien zur Datenaufbewahrung einzuhalten, werden die persönlichen Daten (z. B. Name und E-Mail) von Benutzern (außer Organisationsinhabern), die Mitglied einer Organisation sind, aber keinen Zugriff auf Produkte haben, nach 12 Monaten Inaktivität automatisch anonymisiert.

Jeder Benutzer auf der Phrase-Plattform hat je nach Erstellung seines Kontos und der Organisation, die es verwaltet, entweder den Identitätsmitgliedschaftsstatus Intern oder Extern.

  • Interner User

    Ein Benutzer, der direkt in einer Organisation erstellt oder über SSO/SCIM bereitgestellt wurde. Die interne Organisation (Stammorganisation) verwaltet die Identität des Benutzers vollständig, einschließlich Profilinformationen und Anmeldeeinstellungen.

  • Externer User

    Ein Benutzer, der in einer anderen Organisation den Status „Intern“ hat und zur Zusammenarbeit in einer weiteren Organisation eingeladen wurde. Die externe Organisation kann Aufgaben zuweisen, aber das Profil oder die Anmeldedaten des Benutzers nicht bearbeiten.

Benutzer können jeweils nur in einer Organisation den Status „Intern“ haben (oder in mehreren, wenn diese derselben Organisationsgruppe angehören) und in anderen den Status „Extern“ haben.

Der Mitgliedschaftsstatus wird auf der Seite Benutzer des Plattform-Dashboards angezeigt.

Fehlerbehebung bei Anmeldeproblemen

Bei Anmeldeproblemen helfen die folgenden Schritte zur Fehlerbehebung:

  1. Inkognitomodus ausprobieren

    Als ersten Schritt ein Inkognito-Fenster (im privaten Modus des Browsers) öffnen und die Anmeldung versuchen. Wenn die Anmeldung gelingt, Browser-Cache, Cookies und Browserverlauf für Phrase-Websites löschen.

  2. Anmeldedaten überprüfen

    Falls das Löschen der Cookies und des Caches nicht hilft, prüfen, ob die korrekten Anmeldedaten verwendet werden.

    • Wenn mehrere Phrase-Konten vorhanden sind, statt der E-Mail-Adresse den Benutzernamen eingeben.

    • Sicherstellen, dass die Anmeldung im richtigen Rechenzentrum erfolgt.

  3. Passwort zurücksetzen

    Wenn das Passwort vergessen wurde, auf der Anmeldeseite auf Passwort vergessen? klicken und den Anweisungen zum Zurücksetzen des Passworts folgen.

    Nach dem Zurücksetzen des Passworts sicherstellen, dass der Browser die Anmeldefelder nicht automatisch mit veralteten Anmeldedaten ausfüllt. Prüfen, ob die Tastatur auf die richtige Sprache eingestellt ist, um eine fehlerhafte Eingabe der Anmeldedaten zu vermeiden.

    Das reCAPTCHA auf der Seite zur Passwortwiederherstellung wird aufgrund regionaler Netzwerkeinschränkungen möglicherweise nicht geladen. In diesem Fall eine andere Netzwerkverbindung versuchen, etwa über ein VPN oder das Mobilfunknetz. Wenn das reCAPTCHA weiterhin nicht geladen wird, den Phrase-Support kontaktieren.

  4. Organisationen wechseln (falls zutreffend)

    Ein Konto kann mit mehreren Organisationen verknüpft sein. Bei Anmeldung in der falschen Organisation die Organisation wechseln.

  5. Einschränkungen für vertrauenswürdige IP-Adressen prüfen

    Ein Administrator kann den Zugriff auf Phrase TMS einschränken, indem er die Einstellung Vertrauenswürdige IP-Adressen unter Einstellungen → Zugriff und Sicherheit → Benutzerzugriff aktiviert und die Anmeldung auf eine definierte Liste zulässiger IP-Bereiche beschränkt. Ein Benutzer, der sich von einem Netzwerk außerhalb dieser Liste aus verbindet, erhält eine Sperrmeldung oder Verbindungsfehler, selbst bei korrekten Anmeldedaten.

    Wenn die Anmeldung trotz korrekter Anmeldedaten wiederholt fehlschlägt, beim Administrator der Organisation nachfragen, ob das aktuelle Netzwerk oder die IP-Adresse in der Liste der zulässigen Adressen enthalten ist.

Social Login auf der Plattform

Die Phrase-Plattform unterstützt Social Login über die folgenden Anbieter:

  • Google

  • Microsoft

  • GitHub

Zur Registrierung oder Anmeldung https://eu.phrase.com oder https://us.phrase.com aufrufen und das gewünschte Social-Login-Konto verbinden. Bestehende Social-Login-Konten von TMS oder Strings können ebenfalls zur Anmeldung bei der Phrase-Plattform verwendet werden.

Angemeldete Benutzer können ihr Phrase-Profil in den Benutzerprofileinstellungen mit einem der verfügbaren Social-Login-Anbieter verbinden oder die Verbindung zu diesem trennen.

Die Registrierung oder Anmeldung über Social Login ist für Benutzer nicht verfügbar, die eingeladen wurden, einer Phrase-Organisation beizutreten:

  • Neue Benutzer können sich auf der Registrierungsseite der Phrase-Plattform mit ihrem Benutzernamen und Passwort oder über SSO registrieren.

    Nach der Anmeldung in den Benutzerprofileinstellungen der Plattform Social Login über den gewünschten Anbieter aktivieren.

  • Bestehende Benutzer, die eingeladen wurden, einer anderen Phrase-Organisation beizutreten, müssen ihr Passwort zurücksetzen, um die Einladung anzunehmen.

    Nach dem Zurücksetzen des Passworts über das bereits verknüpfte Social-Login-Konto anmelden.

Plattform-SSO

Single Sign-on (SSO) ermöglicht es Plattformbenutzern, sich über Anwendungen von Drittanbietern anzumelden. Die Phrase-Plattform ermöglicht Integrationen mit Identitätsanbietern (IdPs), die mit SCIM 2.0 und dem SAML 2.0-Protokoll kompatibel sind (Microsoft Entra ID, Okta, Google Workspace usw.).

Benutzer haben Zugriff, solange sie im IdP-System der Organisation angemeldet sind.

Standardmäßig können sich Benutzer sowohl über SSO als auch über vorhandene Anmeldeinformationen (Benutzername und Passwort) bei der Phrase-Plattform anmelden. Bei Bedarf kann die SSO-Nutzung erzwungen werden, um die Möglichkeit der Anmeldung mit Benutzername und Passwort einzuschränken.

uniqueID-Parameter

Die SSO-Anmeldeseite unterstützt den URL-Parameter uniqueId, der die eindeutige globale Kennung für Benutzer vorab ausfüllt. Das Einfügen einer Zeichenfolge in diesen Parameter bewirkt, dass das Feld für die eindeutige Kennung für den Benutzer vorab ausgefüllt wird.

Beispiel:

https://eu.phrase.com/idm-ui/signin/sso?uniqueId=YOUR_ID

Kunden können die URL mit diesem Parameter in ihrem Browser als Lesezeichen speichern, damit sie sich diesen ID-Wert nicht merken müssen, um die SSO-Anmeldung zu starten.

SSO mit SAML 2.0 aktivieren

Die SSO-Einrichtung sollte von IT-Administratoren mit Administratorzugriff auf den gewählten IdP durchgeführt werden. Nur Plattform-Eigentümer können die SSO-Einrichtung in Phrase konfigurieren.

Bei der SAML-Anmeldung werden first_name und last_name der Benutzer im Benutzerprofil der Phrase-Organisation immer aktualisiert, damit sie mit den entsprechenden Werten im IdP des Kunden übereinstimmen, sofern die jeweiligen Attribute in der SAML-Anmeldeanforderung vorhanden sind. Um dies zu vermeiden, wird empfohlen, diese Attribute aus der SAML-Anmeldeanforderung zu entfernen.

Zum Einrichten von SSO die folgenden Schritte ausführen:

  1. Im linken Navigationsmenü des Platform-Dashboards Organization settings auswählen.

    Die Seite Organization settings öffnet sich und die Registerkarte SSO wird angezeigt.

  2. Die Registerkarte SSO auswählen und auf Enable SSO klicken.

    Die SSO-Konfigurationsseite wird angezeigt.

  3. Den Abschnitt Authorize SSO ausfüllen:

    • Im Feld Globally unique identifier einen eindeutigen Bezeichner eingeben (z. B. den Namen der Organisation oder eine zufällige Zeichenfolge).

      Organisationsbenutzer müssen den eindeutigen Bezeichner verwenden, wenn sie sich bei der Phrase-Plattform anmelden.

    • Im Dropdown-Menü Identifier type die benötigte Option auswählen:

      Username:

      Plattform-Benutzer werden anhand des Benutzernamens mit IdP-Benutzeridentitäten abgeglichen. Das NameID-Formatattribut wird verwendet, um Benutzer abzugleichen:

      urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

      Email address:

      Plattform-Benutzer werden anhand der E-Mail-Adresse mit IdP-Benutzeridentitäten abgeglichen. Das NameID-Formatattribut wird verwendet, um Benutzer abzugleichen:

      urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

  4. Mit den vom IdP bereitgestellten Informationen die erforderlichen Felder im Abschnitt Configure SAML in Phrase ausfüllen und anschließend auf Save klicken.

    Die Felder im Abschnitt Add Phrase to your identity provider werden automatisch ausgefüllt.

  5. Die Links aus dem Abschnitt Add Phrase to your identity provider kopieren und in die SAML-Konfiguration des IdP eintragen.

Hinweis

Das Signieren der SAML-Antwort ist erforderlich, um das Plattform-SSO erfolgreich einzurichten.

Weitere Informationen stehen in der Dokumentation des jeweiligen IdP (z. B. unter Certificate signing options für Microsoft Azure AD).

Hinweis

Phrase erfordert, dass die SAML-Claims die Attributnamen firstname, lastname und username verwenden. Einige Identitätsanbieter senden diese Werte unter anderen Standard-Claim-Namen. Ein Identitätsanbieter sendet beispielsweise standardmäßig den Vor- und Nachnamen des Benutzers unter den Claim-Namen givenname und surname und sendet keinen username-Claim. Diese werden nicht automatisch den Attributnamen zugeordnet, die Phrase erwartet. Wenn das Claim-Mapping nicht aktualisiert wird, erhalten Benutzer, die eine Einladung annehmen, die Fehlermeldung „missing required attributes“ und können sich nicht anmelden.

Um dies zu verhindern, das SAML-Claim-Mapping für die Phrase-Anwendung im IdP wie folgt konfigurieren:

  • Den ausgehenden Claim mit dem Vornamen des Benutzers firstname zuordnen.

  • Den ausgehenden Claim mit dem Nachnamen des Benutzers lastname zuordnen.

  • Einen username-Claim hinzufügen, der beispielsweise dem User Principal Name zugeordnet ist.

SSO erzwingen

Bei Auswahl von Require users to sign in with SSO müssen sich Benutzer mit SSO anmelden.

Wenn eine Anmeldung mit SSO erforderlich ist, können Benutzer, die sich zuvor noch nicht über SSO angemeldet haben, nicht auf die Organisation zugreifen.

Wenn externe Mitwirkende Zugriff ohne SSO benötigen, die Option Require SSO login for specified domains auswählen.

Optionen:

  • Alle Anmeldemethoden zulassen

  • Alle User müssen sich über SSO anmelden.

  • SSO-Anmeldung für bestimmte Domänen erforderlich machen.

    Die Bezeichner und den Bezeichnertyp eingeben und auf Save klicken.

Alle Benutzer, die sich mit SSO anmelden müssen, werden auf der Seite Users des Plattform-Dashboards angezeigt.

Automatische Benutzerbereitstellung

Die automatische Benutzerbereitstellung verwaltet nur vom Unternehmen verwaltete Benutzer in Phrase, keine selbstregistrierten Benutzer.

Die Phrase-Plattform unterstützt zwei Arten der Benutzerbereitstellung unter Verwendung von SAML/SSO-Funktionen, um den Zugriff auf die Plattformanwendungen zu automatisieren:

  • Just-in-Time (JIT)

  • SCIM

Neue Benutzer werden automatisch in der Plattformorganisation erstellt, sobald ihnen beim ausgewählten Identitätsanbieter (IdP) Zugriff auf Phrase gewährt wurde.

Alle neuen Benutzer werden als Mitglieder der relevanten Plattformorganisation erstellt und haben standardmäßig keinen Zugriff auf die Produkte. Der Eigentümer oder Administrator der Plattformorganisation muss sie separat zum erforderlichen Produkt einladen.

Bei Bedarf können die Standardzuweisungen für Produkte und Rollen bei der Einrichtung der Auto-Provisionierung in den Einstellungen der Plattformorganisation geändert werden.

Erstellte Benutzer müssen ihre Zugehörigkeit zur Organisation bestätigen. Dazu wird eine E-Mail mit einem Bestätigungslink an den bereitgestellten Benutzer gesendet. Vor der Verifizierung darf sich der Benutzer nicht mit SSO anmelden.

Hinweis

Um die Bestätigung der Zugehörigkeit zu überspringen, den zuständigen Customer Success Manager kontaktieren.

Automatisch angelegte Benutzer dürfen ihre Phrase-Anmeldedaten nicht ändern, da diese im IdP verwaltet werden.

Wenn ein Benutzer über den IdP deprovisioniert und folglich aus seiner letzten Organisation in Phrase entfernt wird, beginnt für das Konto automatisch eine 30-tägige Aufbewahrungsfrist. Während dieser Kulanzfrist wird die Identität nicht sofort gelöscht, was eine Wiederherstellung ermöglicht, falls die Entfernung versehentlich erfolgte.

Auto-Provisionierung einrichten

Um die Auto-Provisionierung zu aktivieren oder zu deaktivieren, ist eine Zusammenarbeit mit dem technischen Support von Phrase erforderlich, um eine ordnungsgemäße Konfiguration sicherzustellen und potenzielle Probleme wie doppelte Konten oder nicht zugewiesene Benutzer zu vermeiden.

Für eine reibungslose Einrichtung und laufende Verwaltung der Benutzer werden die folgenden Best Practices empfohlen:

  1. Mit einem kleinen Test beginnen.

    Vor der Einführung der Auto-Provisionierung in der gesamten Organisation empfiehlt es sich, zunächst eine kleine Gruppe von Benutzern automatisch anzulegen und zu prüfen, ob alles korrekt funktioniert.

  2. Alle Benutzer über den Identitätsanbieter (IdP) zuweisen.

    Nach einem erfolgreichen Test alle Benutzer über den IdP der Phrase-Anwendung zuweisen. SCIM automatisiert dann die Anlage und Aktualisierung von Benutzern in der gesamten Organisation.

  3. Bestehende Benutzer in unternehmensverwaltete Benutzer umwandeln.

    Den technischen Support von Phrase kontaktieren, um bestehende Benutzer in unternehmensverwaltete Benutzer umzuwandeln. SCIM kann nur Benutzer aktualisieren und löschen, die als unternehmensverwaltet markiert sind, was diesen Schritt unerlässlich macht.

    Vor der Umwandlung prüfen, ob E-Mail-Adresse, Benutzername, Vorname und Nachname jeder bestehenden Phrase-Identität exakt mit den entsprechenden Werten beim Identitätsanbieter übereinstimmen. Abweichungen bei den Attributen verhindern, dass SCIM Identitäten korrekt verknüpft oder aktualisiert.

  4. Benutzer, die vor der Aktivierung von SCIM hinzugefügt wurden, der Organisation über den IdP zuweisen.

    Benutzer, die vor der Aktivierung der SCIM-Auto-Provisionierung hinzugefügt wurden, müssen der Organisation über den IdP zugewiesen werden. Werden diese Benutzer nicht zugewiesen, können sie während der SCIM-Synchronisierung gelöscht werden.

Just-in-Time (JIT)-Bereitstellung

Die Just-in-Time (JIT)-Bereitstellung ist eine auf dem SAML-Protokoll basierende Methode, mit der Benutzer bei ihrer ersten Anmeldung an einer Anwendung über SAML-SSO erstellt werden. Dies macht das manuelle Anlegen von Benutzern oder Benutzerkonten überflüssig, und alle so angelegten Benutzer erhalten automatisch Zugriff auf die Produkte dieser Organisation.

Die Konfiguration der JIT-Bereitstellung sollte von IT-Administratoren mit Administratorzugriff auf den gewählten IdP durchgeführt werden.

Die JIT-Bereitstellung über SAML-SSO wird wie folgt konfiguriert:

  1. Im Platform-Dashboard im linken Navigationsmenü Organization settings auswählen.

    Die Seite Organization settings öffnet sich und der Tab SSO wird angezeigt.

  2. Den Tab SSO auswählen.

    Die SSO-Konfigurationsseite wird angezeigt.

  3. Zu Auto-Provisioning Configuration scrollen und Contact support auswählen, um die Konfigurationseinstellungen zu aktivieren.

    Hinweis

    SAML-Auto-Provisionierung und SCIM können nicht gleichzeitig aktiviert werden.

  4. Sobald die Einstellungen aktiviert sind, im Dropdown-Menü Auto-provisioning die Option SAML Auto-provisioning (Just in time) auswählen.

  5. Eine Option für Role management auswählen.

    • Default weist bei der Bereitstellung Zugriff auf alle Phrase-Produkte mit Standardrollen zu.

    • Custom ermöglicht die Auswahl einer Rolle für bestimmte Phrase-Produkte, die bei der Bereitstellung auf alle neuen Benutzer angewendet wird.

      Wenn die Benutzerrolle leer ist, werden Benutzer nicht für das Produkt bereitgestellt.

  6. Mithilfe der Attribute in der Tabelle Attribute statements die Attribute aus dem IdP den Daten in Phrase zuordnen.

    Dies ist erforderlich, um sicherzustellen, dass die Benutzerdaten zwischen den beiden Systemen abgeglichen sind.

  7. Klicke auf Speichern.

    Die Konfiguration wurde gespeichert.

SCIM-Bereitstellung

Das SCIM-Protokoll ist ein Standard auf Anwendungsebene, der eine sichere Verwaltung und den Austausch von Identitätsdaten über Domänen hinweg ermöglicht.

Unterstützte SCIM-Funktionalität:

  • Unternehmensverwalteten Benutzer erstellen

    • Der Benutzer wird für alle Anwendungen bereitgestellt, die in seiner Platform-Organisation aktiv sind.

    • Der Benutzer hat die Rolle „Linguist“ in Phrase TMS und die Rolle „Translator“ in Phrase Strings.

      Bei Bedarf können die Standardzuweisungen für Produkt und Rolle bei der Einrichtung der automatischen Bereitstellung in den Einstellungen der Platform-Organisation geändert werden.

    • Eine per SCIM erstellte Benutzeridentität kann nicht mit einer bestehenden zusammengeführt werden. Es werden nur neue Identitäten unterstützt.

    • Eine per SCIM bereitgestellte Identität kann nicht unter derselben E-Mail-Adresse einer anderen Organisation beitreten, es sei denn, die zweite Organisation gehört zum selben Kunden. In diesem Fall den Phrase-Support kontaktieren und eine Organisationsgruppe anfordern. Sobald diese konfiguriert ist, stellt SCIM die Identität für jede Organisation innerhalb der Gruppe bereit. Gehört die zweite Organisation zu einem anderen Kunden, die Einladung an eine andere E-Mail-Adresse oder einen Alias der Adresse senden, um ein separates Profil für die neue Organisation zu erstellen.

  • Attribute für unternehmensverwaltete Benutzer bearbeiten

    Die Bearbeitung von Attributen im IdP wird in der Phrase-Plattform übernommen.

  • Unternehmensverwalteten Benutzer löschen

    • Wenn der IdP eine Anforderung zur Benutzerlöschung sendet, wird die Mitgliedschaft dieses Benutzers aus der Phrase-Organisation entfernt. Wenn dies die letzte Organisation ist, der der Benutzer angehört, beginnt für das Konto vor der endgültigen Löschung eine 30-tägige Aufbewahrungsfrist.

    • Wenn ein SCIM-verwalteter Benutzer Mitglied mehrerer Organisationen ist, entfernt die Löschanfrage einer Organisation seine Mitgliedschaft aus dieser Organisation. Die 30-tägige Frist bis zur Löschung beginnt erst nach Eingang einer Löschanfrage von der letzten Organisation, der der Benutzer angehört.

Hinweis

Aufgrund kontinuierlicher Verbesserungen kann die Benutzeroberfläche nicht genau so aussehen wie im Video dargestellt.

Die SCIM-Konfiguration sollte von IT-Administratoren mit Administratorzugriff auf den gewählten IdP durchgeführt werden.

Die SCIM-Eigenschaften werden wie folgt konfiguriert:

  1. Im Platform-Dashboard im linken Navigationsmenü Organization settings auswählen.

    Die Seite Organization settings öffnet sich und der Tab SSO wird angezeigt.

  2. Den Tab SSO auswählen.

    Die SSO-Konfigurationsseite wird angezeigt.

  3. Zu Auto-Provisioning Configuration scrollen und Contact support auswählen, um die Konfigurationseinstellungen zu aktivieren.

    Hinweis

    SAML-Auto-Provisionierung und SCIM können nicht gleichzeitig aktiviert werden.

  4. Sobald die Einstellungen aktiviert sind, im Dropdown-Menü Auto-provisioning die Option SCIM auswählen.

    Die Details zur SCIM-Konfiguration werden angezeigt.

  5. Das gewünschte SCIM secret für die Codierung eingeben und auf Save klicken.

    Hinweis

    Das SCIM secret ist aufgrund der Architektur der Phrase-Plattform erforderlich, da mehrere Organisationen SCIM verwenden können. Die Organisations-ID wird im Sicherheitstoken codiert, um die Verwendung der UID in der URL zu verhindern.

    Das Feld SCIM bearer token wird mit einem eindeutigen Token gefüllt.

  6. Das Token und die SCIM base URL kopieren.

    Diese werden in den Einstellungen des Identitätsanbieters verwendet.

  7. Eine Option für Role management auswählen.

    • Default weist bei der Bereitstellung Zugriff auf alle Phrase-Produkte mit Standardrollen zu.

    • Custom ermöglicht die Auswahl einer Rolle für bestimmte Phrase-Produkte, die bei der Bereitstellung allen neuen Benutzern zugewiesen wird.

    • SCIM ermöglicht die Konfiguration von Produktzugriff und Rolle pro Benutzer anhand der bei der Bereitstellung im IdP hinterlegten Informationen.

  8. Klicke auf Speichern.

    Die Konfiguration wurde gespeichert.

SCIM-Rollenverwaltung konfigurieren

Wenn SCIM verwendet wird, können Rollenzuweisung und Produktzugriff direkt in der IdP-Bereitstellungsanfrage mithilfe des Attributs roles definiert werden.

Jeder Eintrag im roles-Array der SCIM-User Create-Anfrage muss Folgendes enthalten:

  • Ein type-Feld, das das Zielprodukt angibt (muss mit phrase__ beginnen)

  • Ein value-Feld, das den genauen Rollennamen für dieses Produkt angibt

Beispiel für eine SCIM-Anfrage

"roles": [
  { "type": "phrase__platform", "value": "MEMBER" },
  { "type": "phrase__tms", "value": "ADMIN" },
  { "type": "phrase__strings", "value": "none" }
]
  • Die phrase__platform-Rolle ist obligatorisch.

  • none verwenden, um den Zugriff auf ein Produkt auszuschließen.

  • Alle Rollen müssen mit den konfigurierten und im entsprechenden Phrase-Produkt verfügbaren Rollen übereinstimmen. Die Phrase Portal-Rolle ist nicht konfigurierbar und wird automatisch aus der TMS-Rolle des Benutzers abgeleitet.

  • Rollennamen unterscheiden zwischen Groß- und Kleinschreibung. Großschreibung wird empfohlen.

  • Anfragen, bei denen Pflichtfelder fehlen oder die ungültige Rollen enthalten, schlagen fehl.

Bei Fragen zur Einrichtung der rollenbasierten Bereitstellung mit SCIM oder zur Behebung von Konfigurationsfehlern den zuständigen Solution Architect kontaktieren.

Beispielkonfiguration in Okta

Für die Konfiguration der SCIM-Rollenbereitstellung in Okta die folgenden Schritte ausführen:

  1. Benutzerdefinierte Attribute für jedes Phrase-Produkt erstellen:

    • phrase__platform

    • phrase__tms

    • phrase__strings

  2. Gültige Rollenwerte für jedes Attribut definieren.

  3. Diese Attribute der SCIM-App in Okta zuordnen.

  4. Bei Bedarf bedingte Logik verwenden, um Rollen anhand des Benutzerprofils oder der Gruppenzugehörigkeit dynamisch zuzuordnen.

  5. Zuordnungen nur bei der Benutzererstellung anwenden.

    Hinweis

    Aktualisierungen bestehender Benutzerrollen über SCIM werden nicht unterstützt.

Unterstützte Rollenwerte pro Produkt

Bei Rollenwerten wird zwischen Groß- und Kleinschreibung unterschieden. Der vom IdP gesendete Wert muss exakt mit einem der folgenden Werte übereinstimmen, einschließlich der Groß- und Kleinschreibung. Beim Präfix phrase__<product> selbst wird nicht zwischen Groß- und Kleinschreibung unterschieden.

  • Plattform (phrase__platform): MEMBER, ADMIN

  • TMS (phrase__tms): LINGUIST, PROJECT_MANAGER, ADMIN, GUEST, SUBMITTER, PORTAL_MEMBER

  • Strings (phrase__strings): Owner, Admin, ProjectManager, Developer, Designer, Translator, Guest

  • Studio (phrase__studio): OWNER, ADMIN, MEMBER

Migration von Legacy-SSO

Wichtig

Ab dem 4. März 2025 gelten die Legacy-SSO-Anmeldeseiten für TMS und Strings als veraltet. Um einen unterbrechungsfreien Zugriff auf Phrase-Produkte zu gewährleisten, müssen alle Organisationen, die das Legacy-SSO verwenden, auf das Plattform-SSO migrieren.

Die Migration auf das Plattform-SSO erfordert Administratorzugriff auf den Identitätsanbieter (IdP). Die Zusammenarbeit mit dem IT-Team ist unerlässlich, um eine neue Plattform-SSO-Integration im IdP zu konfigurieren.

Jede Phrase-Organisation kann nur einen IdP integrieren. Wenn mehrere IdPs verwendet werden, vor der Migration einen davon für die Einrichtung von Plattform-SSO auswählen.

Migrationsschritte

  1. im IdP einrichten (Okta, Azure, TrustBuilder oder anderen IdPs).

    • Um Verwirrung bei den Benutzern zu vermeiden, die global eindeutige Kennung in Plattform-SSO auf denselben Wert wie in Legacy-SSO setzen.

  2. Vorhandene Benutzer und Gruppen aus der Legacy-SSO-Integration zur neuen Plattform-SSO-Integration im IdP einladen.

  3. Über die Änderungen am Anmeldeablauf informieren:

    • Benutzer müssen die Plattform-Anmeldeseite verwenden:

    • Wenn sich Benutzer über ein IdP-Dashboard-Symbol anmelden, müssen sie das aktualisierte Plattform-SSO-Symbol auswählen.

    • Benutzeranmeldedaten (E-Mail/Benutzername) bleiben unverändert.

Sobald die Migration abgeschlossen ist, bleiben alle vorhandenen Inhalte und Benutzerrollen in Phrase TMS und Phrase Strings unverändert.

Behebung von Problemen bei der SSO-Anmeldung, wenn dieselbe E-Mail-Adresse für mehrere Konten verwendet wird

Wenn die E-Mail-Kennung verwendet wird, gleicht Phrase die vom Identitätsanbieter gesendete E-Mail mit den Konten ab, die aktive Mitglieder der Organisation sind, deren SSO-Konfiguration verwendet wird. Konten mit derselben E-Mail-Adresse in anderen Organisationen werden nicht berücksichtigt.

Wenn genau ein übereinstimmendes Konto gefunden wird, wird dieses Konto angemeldet. Wird kein passendes Konto gefunden, schlägt die Anmeldung mit dem Fehler „Identität nicht gefunden“ fehl, es sei denn, die Just-in-Time-Bereitstellung (JIT) ist für die Organisation aktiviert. Wird innerhalb derselben Organisation mehr als ein passendes Konto gefunden, schlägt die Anmeldung fehl, da die E-Mail-Adresse innerhalb dieser Organisation nicht eindeutig ist.

Konten mit derselben E-Mail-Adresse in verschiedenen Organisationen führen nicht zu Konflikten.

Empfohlene Konfigurationen:

  • Ein Konto pro Organisation, gleiche E-Mail-Adresse: Funktioniert ohne Änderungen – die E-Mail-Kennung verwenden. Auf der Seite des Identitätsanbieters sind keine Änderungen erforderlich.

  • Eine andere E-Mail-Adresse pro Organisation: Pro Organisation einen Alias verwenden und den Identitätsanbieter so konfigurieren, dass er diesen Alias für die entsprechende Anwendung sendet. Die E-Mail-Adresse in Phrase muss exakt mit der übereinstimmen, die der Identitätsanbieter sendet.

  • Zwei Konten in derselben Organisation (zum Beispiel ein Administratorkonto und ein Projektmanagerkonto): Für jedes Konto einen separaten Benutzer beim Identitätsanbieter verwenden oder die Kennung „Benutzername“ mit einem eigenen Benutzernamen pro Konto nutzen.

Falls ein einziges Konto mit einer einzigen Anmeldung für alle Organisationen gewünscht ist, den Phrase-Support kontaktieren. Konten, die derselben Person in verschiedenen Organisationen gehören, können zu einem Konto zusammengeführt werden, das Mitglied in allen diesen Organisationen ist. Die Zusammenführung ist für über SCIM erstellte Identitäten nicht verfügbar.

Wenn die JIT-Bereitstellung für eine Organisation aktiviert ist und ein Benutzer, der versucht, sich per SSO anzumelden, noch kein Mitglied dieser Organisation ist, erstellt SSO ein neues Konto unter Verwendung der bereitgestellten E-Mail-Adresse. Bestehende Mitglieder vor der Aktivierung von SSO in die Organisation einladen, um eine unbeabsichtigte Kontoerstellung zu vermeiden.

War dieser Beitrag hilfreich?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.