Administration

Phrase Identity Management

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

Zentrale Anmeldung über die Plattform

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 authentifizieren zu müssen.

Nach der Anmeldung bei der Plattform oben links das Dropdown-Menü Dashboard auswählen, um bei Bedarf zwischen allen abonnierten Produkten zu wechseln. Der Produktwechsler ist auch innerhalb jeder Produktoberfläche für alle Benutzer mit einem Platform-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 Plattformtarifen, den in jedem Tarif verfügbaren Funktionen und Nutzungsgrenzen sind auf der Phrase-Preisseite zu finden.

Bestehende TMS- oder Strings-Benutzer können sich über die Plattform-Anmeldeseite mit ihrem Benutzernamen 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 Mitglieder mehrerer verschiedener Phrase-Organisationen sein und bei Bedarf zwischen ihnen wechseln. Um Datenaufbewahrungsrichtlinien einzuhalten, werden die persönlichen Daten (z. B. Name und E-Mail-Adresse) von Benutzern (außer Inhabern), 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 den Status der Identitätszugehörigkeit Intern oder Extern. Er richtet sich danach, wie das Konto erstellt wurde und welche Organisation es verwaltet.

  • 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 als Intern zu einer anderen Organisation gehört und zur Zusammenarbeit in einer zusätzlichen Organisation eingeladen wurde. Die externe Organisation kann Aufgaben zuweisen, aber das Profil oder die Anmeldedaten des Benutzers nicht bearbeiten.

Benutzer können jeweils in einer Organisation Intern sein (oder in mehreren, wenn diese derselben Organisationsgruppe angehören) und in anderen als Extern erscheinen.

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

    Zunächst ein Inkognito-Fenster (den privaten Modus des Browsers) öffnen und die Anmeldung versuchen. Wenn die Anmeldung so funktioniert, den Browser-Cache, die Cookies und den Browserverlauf für Phrase-Websites löschen.

  2. Anmeldedaten überprüfen

    Wenn das Löschen von Cookies und Cache nicht hilft, prüfen, ob die richtigen Anmeldedaten verwendet werden.

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

    • Sicherstellen, dass die Anmeldung beim richtigen Rechenzentrum erfolgt.

  3. Passwort zurücksetzen

    Falls das Passwort vergessen wurde, auf der Anmeldeseite auf Passwort vergessen? klicken und den Schritten 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. Sicherstellen, dass die richtige Tastatursprache eingestellt ist, damit die Anmeldedaten korrekt eingegeben werden.

    Das reCAPTCHA auf der Seite zur Passwortwiederherstellung wird möglicherweise aufgrund regionaler Netzwerkeinschränkungen nicht geladen. In diesem Fall eine andere Netzwerkverbindung ausprobieren, etwa ein VPN oder eine mobile Datenverbindung. Wenn 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 bei der falschen Organisation zu einer anderen 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 eine Verbindung von einem Netzwerk außerhalb dieser Liste herstellt, erhält eine Sperrmeldung oder sieht Verbindungsfehler, selbst bei korrekten Anmeldedaten.

    Wenn die Anmeldung trotz korrekter Anmeldedaten dauerhaft fehlschlägt, beim Administrator der Organisation nachfragen, ob das aktuelle Netzwerk oder die aktuelle IP-Adresse auf der Liste zulässiger Adressen steht.

Social Login auf der Plattform

Die Phrase-Plattform unterstützt die Anmeldung über die folgenden Anbieter sozialer Netzwerke:

  • Google

  • Microsoft

  • GitHub

Zur Registrierung oder Anmeldung mit einem Konto bei einem sozialen Netzwerk https://eu.phrase.com oder https://us.phrase.com aufrufen und das gewünschte Konto verknüpfen. Auch mit sozialen Netzwerken verknüpfte Konten aus älteren Versionen von TMS oder Strings werden für die Anmeldung bei der Phrase-Plattform unterstützt.

Angemeldete Benutzer können ihr Phrase-Profil in den Benutzerprofileinstellungen mit einem der verfügbaren Anbieter sozialer Netzwerke verknüpfen oder die Verknüpfung aufheben.

Die Registrierung oder Anmeldung über soziale Netzwerke 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 die Anmeldung über den gewünschten Anbieter eines sozialen Netzwerks 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 Konto bei einem sozialen Netzwerk anmelden.

Plattform-SSO

Single Sign-on (SSO) ermöglicht es Plattform-Benutzern, 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 bestehende Anmeldedaten (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 Plattforminhaber können die SSO-Einrichtung in Phrase konfigurieren.

Bei der SAML-Anmeldung werden die Attribute first_name und last_name im Benutzerprofil der Phrase-Organisation immer aktualisiert, sodass ihre Werte mit denen im IdP des Kunden übereinstimmen, sofern die entsprechenden 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 Plattform-Dashboards Organisationseinstellungen auswählen.

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

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

    Die SSO-Konfigurationsseite wird angezeigt.

  3. Den Abschnitt SSO autorisieren ausfüllen:

    • Im Feld Global eindeutiger Bezeichner einen eindeutigen Bezeichner angeben (z. B. den Organisationsnamen oder eine zufällige Zeichenfolge).

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

    • Im Dropdown-Menü Identifikatortyp die erforderliche Option auswählen:

      Benutzername:

      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

      E-Mail-Adresse:

      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

      Der ausgewählte Identifikatortyp muss mit der NameID übereinstimmen, die der Identitätsanbieter sendet. Dies wird durch die NameID-Formateinstellungen der SAML-Anwendung gesteuert.

      Eine Nichtübereinstimmung zwischen dem Identifikatortyp in Phrase und dem im Identitätsanbieter konfigurierten NameID-Format führt zu Anmeldefehlern.

  4. Die vom IdP bereitgestellten Informationen in die erforderlichen Felder im Abschnitt SAML in Phrase konfigurieren eintragen und anschließend auf Speichern klicken.

    Die Felder im Abschnitt Phrase zum Identitätsanbieter hinzufügen werden automatisch ausgefüllt.

  5. Die Links im Abschnitt Phrase zum Identitätsanbieter hinzufügen kopieren und in der SAML-Konfiguration des IdP eintragen.

Hinweis

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

Wenn eine Diskrepanz zwischen dem Zertifikat, das der Identitätsanbieter derzeit zum Signieren von SAML-Antworten verwendet, und dem in Phrase gespeicherten IdP-Zertifikat besteht, wird bei der Anmeldung über SSO der Fehler „The IdP response could not be verified due to faulty signature“ ausgegeben. Zur Behebung als Organisationsinhaber bei der Phrase-Plattform anmelden, anschließend Organisationseinstellungen, SSO und SAML in Phrase konfigurieren öffnen und sicherstellen, dass das aktuell beim Identitätsanbieter aktive X.509-Zertifikat verwendet wird.

Weitere Informationen stehen in der Dokumentation des jeweiligen IdP (z. B. unter Optionen für die Zertifikatsignierung in 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 die Claim-Zuordnung nicht aktualisiert wird, erhalten Benutzer, die eine Einladung annehmen, die Fehlermeldung „missing required attributes“ und können sich nicht anmelden.

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

  • Den ausgehenden Claim, der den Vornamen des Benutzers enthält, dem Attribut firstname zuordnen.

  • Den ausgehenden Claim, der den Nachnamen des Benutzers enthält, dem Attribut lastname zuordnen.

  • Einen username-Claim hinzufügen und ihn beispielsweise dem User Principal Name zuordnen.

Phrase erwartet, dass die SAML-Attribute firstname, lastname und username genannt werden. Einige Identitätsanbieter verwenden andere Standardnamen (z. B. givenname und surname), die nicht automatisch zugeordnet werden. Wenn diese Werte gesendet werden sollen, muss die Claim-Zuordnung im Identitätsanbieter entsprechend angepasst werden.

Die E-Mail-Adresse stammt immer aus der SAML-NameID. Bestehende Benutzer werden darüber abgeglichen, und kein anderes Attribut wird bei der Anmeldung überprüft. Bestehende Benutzer, die eine Einladung annehmen, benötigen keine Attribute. Die anderen Attribute sind nur wie folgt erforderlich:

  • Neue Benutzer, die eine Einladung annehmen: firstname und lastname. Wenn kein Benutzername gesendet wird, generiert Phrase einen aus der E-Mail-Adresse.

  • JIT-Bereitstellung: firstname, lastname und username.

  • SCIM-Benutzererstellung: username.

Wenn ein erforderliches Attribut fehlt, sieht der Benutzer die Fehlermeldung „missing required attributes“. Bei der SAML-Anmeldung werden Vor- und Nachname im Benutzerprofil nur aktualisiert, wenn beide gesendet werden. Um das Überschreiben bestehender Profile zu vermeiden, beide Attribute aus der SAML-Anfrage entfernen.

SSO erzwingen

Die Auswahl von Benutzer müssen sich mit SSO anmelden zwingt Benutzer dazu, sich mit SSO anzumelden.

Das Erzwingen der SSO-Anmeldung verhindert, dass Benutzer, die sich zuvor nicht über SSO angemeldet haben, auf die Organisation zugreifen können.

Wenn ein externer Mitwirkender Zugriff ohne SSO benötigt, die Option SSO-Anmeldung für bestimmte Domänen erforderlich auswählen.

Optionen:

  • Alle Anmeldemethoden zulassen

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

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

    Kennungen und Kennungstyp angeben und auf Speichern klicken.

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

Automatische Benutzerbereitstellung

Die automatische Benutzerbereitstellung gilt in Phrase nur für unternehmensverwaltete Benutzer, nicht für selbst registrierte 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 Plattform-Organisation erstellt, sobald ihnen beim gewählten Identitätsanbieter (IdP) Zugriff auf Phrase gewährt wurde.

Alle neuen Benutzer werden als Mitglieder der entsprechenden Plattform-Organisation erstellt und haben standardmäßig keinen Zugriff auf die Produkte. Der Inhaber oder Administrator der Plattform-Organisation muss sie separat zum erforderlichen Produkt einladen.

Bei Bedarf kann die Standardzuweisung von Produkt und Rolle bei der Einrichtung der automatischen Benutzerbereitstellung in den Einstellungen der Plattform-Organisation 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 provisionierten Benutzer gesendet. Vor der Verifizierung ist eine Anmeldung mit SSO nicht möglich.

Hinweis

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

Provisionierten Benutzern ist es nicht gestattet, ihre Phrase-Anmeldedaten zu ä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 Übergangsfrist 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. Zunächst mit einer kleinen Gruppe testen.

    Vor der Einführung der Auto-Provisionierung in der gesamten Organisation empfiehlt es sich, zunächst eine kleine Gruppe von Benutzern zu provisionieren und zu prüfen, ob alles ordnungsgemäß 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 Provisionierung und Benutzeraktualisierungen in der gesamten Organisation.

  3. Vorhandene Benutzer in unternehmensverwaltete Benutzer umwandeln.

    Den technischen Support von Phrase kontaktieren, um vorhandene 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 sicherstellen, dass E-Mail-Adresse, Benutzername, Vorname und Nachname jeder bestehenden Phrase-Identität exakt mit den entsprechenden Werten im Identitätsanbieter übereinstimmen. Nicht übereinstimmende Attribute verhindern, dass SCIM Identitäten korrekt verknüpft oder aktualisiert.

  4. Vor der SCIM-Aktivierung hinzugefügte Benutzer über den IdP der Organisation 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 bei der SCIM-Synchronisierung gelöscht werden.

Just-in-Time (JIT)-Provisionierung

Die Just-in-Time (JIT)-Provisionierung 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 die manuelle Provisionierung von Benutzern oder die manuelle Erstellung von Benutzerkonten überflüssig, und alle erstellten Benutzer haben automatisch Zugriff auf die Produkte dieser Organisation.

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

Zum Konfigurieren der JIT-Provisionierung über SAML-SSO die folgenden Schritte ausführen:

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

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

  2. Die Registerkarte 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. Die Art der Role management auswählen.

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

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

      Wenn die Benutzerrolle leer ist, erhalten die Benutzer keinen Zugriff auf das Produkt.

  6. Die Attribute in der Tabelle Attribute statements verwenden, um Attribute aus dem IdP den Daten in Phrase zuzuordnen.

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

  7. Klicke auf Speichern.

    Die Konfiguration wurde gespeichert.

SCIM-Bereitstellung

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

Unterstützte SCIM-Funktionen:

  • Unternehmensverwalteten Benutzer erstellen

    • Der Benutzer wird für alle Anwendungen bereitgestellt, die in seiner Plattform-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 beim Einrichten der automatischen Bereitstellung in den Einstellungen der Plattform-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. Wenden Sie sich in diesem Fall an den Phrase-Support, um eine Organisationsgruppe anzufordern; sobald diese konfiguriert ist, stellt SCIM die Identität für jede Organisation innerhalb dieser Gruppe bereit. Wenn die zweite Organisation zu einem anderen Kunden gehört, 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.

  • Unternehmensverwaltete Benutzerattribute bearbeiten

    Änderungen an Attributen im IdP werden 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 Aufbewahrungsfrist von 30 Tagen.

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

SCIM-Bereitstellung einrichten

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.

Zum Konfigurieren der SCIM-Eigenschaften die folgenden Schritte ausführen:

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

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

  2. Die Registerkarte 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. Die Authentifizierung wie unten beschrieben einrichten.

  6. Die SCIM v2 base URL und die generierten Anmeldedaten kopieren. Diese werden in den IdP-Einstellungen verwendet.

  7. Unter Role management eine Option 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.

    • SCIM ermöglicht es, Produktzugriff und Rolle für jeden Benutzer anhand der bei der Provisionierung im IdP festgelegten Informationen zu konfigurieren.

  8. Unter Deletion policy eine Option auswählen.

    • User-Deaktivierung

    • Endgültig Löschen

  9. Klicke auf Importieren.

    Die Konfiguration ist gespeichert.

SCIM-Authentifizierung

Phrase unterstützt drei Authentifizierungsoptionen für SCIM-Anfragen von einem Identitätsanbieter (IdP). Unter Organization settings > SSO > Auto-Provisioning Configuration > SCIM authentication eine Option auswählen.

SCIM_authentication_options.png

Option

Wann welche Option verwenden?

OAuth2 (empfohlen)

Der IdP unterstützt den OAuth-2.0-Client-Credentials-Grant, zum Beispiel Okta OAuth 2 oder Microsoft Entra ID OAuth2 Client Credentials Grant. OAuth2 verwendet kurzlebige Zugriffstoken, und der geheime Schlüssel wird niemals mit SCIM-Anfragen gesendet.

Bearer v2

Der IdP unterstützt nur ein statisches Bearer-Token (HTTP-Header oder Secret Token).

Legacy

Nur für bestehende Konfigurationen verfügbar. Zu OAuth2 oder Bearer v2 migrieren.

Wichtig

Das Generieren von Anmeldedaten für Bearer v2 oder OAuth2 führt dazu, dass der Legacy-SCIM-Endpunkt keine Anfragen mehr für die Organisation akzeptiert. Die Konfiguration im IdP umgehend aktualisieren. Ein Wechsel zurück zu Legacy ist nicht möglich.

OAuth2 einrichten

Zum Einrichten von OAuth2 die folgenden Schritte ausführen:

  1. Sicherstellen, dass SSO aktiviert und die SCIM-Bereitstellung eingeschaltet ist (zur Aktivierung von SCIM den Phrase-Support kontaktieren).

  2. Unter SCIM-Authentifizierung OAuth2 auswählen und auf Anmeldedaten generieren klicken.

  3. Die Client-ID und das Client-Secret kopieren.

    Das Client-Secret wird nur einmal angezeigt. Das Client-Secret sicher aufbewahren.

  4. Die SCIM-v2-Basis-URL kopieren, zum Beispiel https://eu.phrase.com/idm/scim/v2/<id>.

  5. Im IdP die SCIM-Anwendung mit diesen Werten konfigurieren:

    • SCIM-Connector-Basis-URL: die SCIM-v2-Basis-URL aus Schritt 3

    • Authentifizierungsmodus: OAuth-2.0-Client-Credentials

    • Token-Endpunkt-URL: https://eu.phrase.com/idm/oauth/token für das EU-Rechenzentrum oder https://us.phrase.com/idm/oauth/token für das US-Rechenzentrum

    • Client-ID und Client-Secret: die Werte aus Schritt 2, die im Anfragerumpf übermittelt werden (client_secret_post)

    • Scope: leer lassen

  6. In Phrase auf Speichern klicken und die Verbindung im IdP testen.

Zugriffstoken sind 4 Stunden lang gültig. Wenn das aktuelle Token abläuft, fordert der IdP mit der Client-ID und dem Client-Secret ein neues an.

Hinweis

Phrase stellt keine Aktualisierungstokens aus.

Bearer V2 einrichten

Zum Einrichten von Bearer v2 die folgenden Schritte ausführen:

  1. Sicherstellen, dass SSO aktiviert und die SCIM-Bereitstellung eingeschaltet ist (zur Aktivierung von SCIM den Phrase-Support kontaktieren).

  2. Unter SCIM-Authentifizierung die Option Bearer v2 auswählen und auf Anmeldedaten generieren klicken.

  3. Das generierte Token und die SCIM-v2-Basis-URL kopieren.

    Das Token wird nur einmal angezeigt. Das Token sicher aufbewahren.

  4. Im IdP die SCIM-v2-Basis-URL eingeben, HTTP-Header oder Bearer-Token als Authentifizierungsmethode auswählen und das kopierte Token eingeben.

  5. Klicke auf Importieren.

Anmeldedaten erneuern oder ändern
  • Ein erneuter Klick auf Anmeldedaten generieren erstellt neue Anmeldedaten und macht die vorherigen sofort ungültig. Es gibt keinen Überschneidungszeitraum. Den IdP direkt nach dem erneuten Generieren der Anmeldedaten aktualisieren, um Fehler bei der Bereitstellung zu vermeiden.

  • Das Wechseln zwischen Bearer v2 und OAuth2 macht die Anmeldedaten und aktiven Zugriffstokens der vorherigen Methode ungültig.

  • Beim Deaktivieren von SCIM bleiben die Anmeldedaten erhalten, aber Phrase lehnt alle SCIM-Anfragen ab, bis SCIM wieder aktiviert wird.

Fehlerbehebung
  • 401 „Not valid authorization token.” bei SCIM-Anfragen.

    Mögliche Ursachen:

    • Die Anmeldedaten sind falsch oder wurden neu generiert.

    • Das Zugriffstoken ist abgelaufen.

    • Die Basis-URL gehört zu einer anderen Organisation.

    • SCIM oder SSO ist deaktiviert.

  • 400 invalid_client vom Token-Endpunkt: Die Client-ID oder das Client-Secret ist falsch, oder die Anmeldeinformationen wurden neu generiert.

Hinweis

Häufige SCIM-Bereitstellungsfehler lassen sich in einige Kategorien einteilen.

Ein Benutzerkonto, das manuell oder durch Benutzersynchronisierung und nicht über SCIM erstellt wurde, kann später nicht von SCIM übernommen werden. Die Aktualisierungsanfrage des Identitätsanbieters wird mit einem Fehler wie „Identity is not managed by organization” abgelehnt. Um ein solches bestehendes Konto unter die SCIM-Verwaltung zu bringen, ist ein unterstützter Migrationsschritt erforderlich; das Konto kann nicht allein durch eine spätere SCIM-Aktualisierung beansprucht werden.

Eine SCIM-bereitgestellte Identität kann nur für eine Organisation unter einer bestimmten E-Mail-Adresse bereitgestellt werden, es sei denn, die Organisationen gehören zum selben Kunden und sind als Organisationsgruppe eingerichtet. Wenn dieselbe Person unabhängige Konten in zwei verschiedenen Organisationen unter derselben E-Mail-Adresse hat, schlagen SCIM-Push-Anfragen von einer oder beiden Organisationen fehl. Für Organisationen unterschiedlicher Kunden benötigt jede Person ein separates Konto pro Organisation, jeweils mit einer eigenen E-Mail-Adresse oder einem eigenen Alias. Gehören die Organisationen zur selben Gruppe, den Phrase-Support kontaktieren, damit sie als Organisationsgruppe konfiguriert werden und eine einzelne Identität für alle bereitgestellt werden kann.

SCIM verwaltet nur das (interne) Hauptkonto eines Benutzers in einer Organisation. Eine externe Mitgliedschaft, bei der sich die Hauptorganisation des Kontos von der Organisation unterscheidet, die den SCIM-Push durchführt, kann nicht durch die SCIM-Konfiguration dieser Organisation aktualisiert oder verwaltet werden.

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, der das Zielprodukt angibt (muss mit phrase__ beginnen)

  • Ein value, der 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 Rolle phrase__platform ist obligatorisch.

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

  • Alle Rollen müssen mit den konfigurierten Rollen übereinstimmen und in der des jeweiligen Phrase-Produkts verfügbar sein. Die Rolle Phrase Portal ist nicht konfigurierbar und wird automatisch aus der TMS-Rolle des Benutzers abgeleitet.

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

  • Anfragen, in denen erforderliche Felder fehlen oder ungültige Rollen enthalten sind, schlagen fehl.

Falls bei der Einrichtung der rollenbasierten SCIM-Bereitstellung oder der Behebung von Konfigurationsfehlern Unterstützung benötigt wird, den zuständigen Solution Architect kontaktieren.

Beispielkonfiguration in Okta

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

  1. Für jedes Phrase-Produkt benutzerdefinierte Attribute 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

Rollenwerte unterscheiden zwischen Groß- und Kleinschreibung. Der vom IdP gesendete Wert muss exakt mit einem der folgenden ü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

Vom bisherigen SSO migrieren

Wichtig

Ab dem 4. März 2025 gelten die bisherigen 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 alte SSO verwenden, zum Plattform-SSO migrieren.

Die Migration zum 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 an einen IdP angebunden werden. Wenn mehrere IdPs verwendet werden, vor der Migration einen IdP für die Einrichtung von Plattform-SSO auswählen.

Migrationsschritte

  1. Plattform-SSO im IdP einrichten (Okta, Azure, TrustBuilder oder andere IdPs).

    • Um Verwirrung bei den Benutzern zu vermeiden, den global eindeutigen Bezeichner in Plattform-SSO genauso festlegen wie im bisherigen SSO.

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

  3. Änderungen am Anmeldeablauf kommunizieren:

    • Benutzer müssen die Plattform-Anmeldeseite verwenden:

    • Wenn die Anmeldung über ein IdP-Dashboard-Symbol erfolgt, müssen Benutzer das aktualisierte Plattform-SSO-Symbol auswählen.

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

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

Zuordnung von SSO-Anmeldungen bei Verwendung derselben E-Mail-Adresse in mehreren Konten

Wenn der E-Mail-Bezeichner 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, erfolgt die Anmeldung mit diesem Konto. Wenn kein übereinstimmendes Konto gefunden wird, schlägt die Anmeldung mit einem „Identität nicht gefunden“-Fehler fehl, es sei denn, die Just-in-Time-Bereitstellung (JIT) ist für die Organisation aktiviert. Wenn mehr als ein übereinstimmendes Konto innerhalb derselben Organisation gefunden wird, 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 stehen nicht in Konflikt.

Empfohlene Setups:

  • Ein Konto pro Organisation, dieselbe E-Mail-Adresse: funktioniert ohne Änderungen – den E-Mail-Bezeichner 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 eigenen Benutzer beim Identitätsanbieter oder den Benutzernamen-Bezeichner mit einem unterschiedlichen Benutzernamen pro Konto verwenden.

Wenn ein einziges Konto und eine einzige Anmeldung für alle Organisationen gewünscht sind, 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 mittels 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.