Die Phrase Localization Platform ermöglicht den Zugriff auf die verschiedenen Phrase-Produkte über eine zentrale Anmelde- und 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 navigieren, ohne sich bei jedem einzeln authentifizieren zu müssen.
Nach der Anmeldung bei der Plattform lässt sich über das Dropdown-Menü oben links bei Bedarf zwischen allen abonnierten Produkten 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 wird durch den erworbenen Plan definiert
-
Phrase TMS und Phrase Strings
-
Benutzereinladung
-
-
Phrase Orchestrator
-
Zugriff auf TMS oder Strings
-
-
Phrase Custom AI, Phrase Language AI und Phrase Analytics
-
Zugriff auf TMS
-
Hinweis
Weitere Informationen zu Plattform-Plänen, den in jedem Plan verfügbaren Funktionen und Nutzungsgrenzen stehen auf der Phrase-Preisseite.
Bestehende TMS- oder Strings-Benutzer können sich über die Plattform-Anmeldeseite anmelden, indem sie Benutzername und Passwort eingeben oder Platform SSO verwenden.
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ätsmitgliedschaft
Benutzer können Mitglied in mehreren verschiedenen Phrase-Organisationen sein und bei Bedarf zwischen ihnen wechseln. Um Datenaufbewahrungsrichtlinien einzuhalten, werden die persönlichen Daten (z. B. Name und E-Mail) von Benutzern (außer Eigentümern), 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 einen Identitätsmitgliedschaftsstatus von entweder oder , basierend darauf, wie sein 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 einer anderen Organisation mit dem Status „Intern“ angehö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 nur in einer Organisation den Status „Intern“ haben (oder in mehreren, wenn diese derselben Organisationsgruppe angehören) und in anderen als „Extern“ erscheinen.
Der Mitgliedschaftsstatus wird auf der Seite des Plattform-Dashboards angezeigt.
Bei Anmeldeproblemen können die folgenden Schritte zur Fehlerbehebung helfen:
-
Inkognito-Modus versuchen
Zunächst ein Inkognito-Fenster (anonymer Modus des Browsers) öffnen und versuchen, sich anzumelden. Wenn die Anmeldung gelingt, den Browser-Cache, die Cookies und den Browserverlauf für Phrase-Websites löschen.
-
Anmeldedaten überprüfen
Wenn das Löschen der Cookies und des Caches nicht hilft, prüfen, ob die richtigen Anmeldedaten verwendet werden.
-
Wenn mehrere Konten bei Phrase vorhanden sind, den Benutzernamen statt der E-Mail-Adresse eingeben.
-
Prüfen, ob die Anmeldung beim richtigen Rechenzentrum erfolgt.
-
-
Passwort zurücksetzen
Wenn 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 prüfen, ob der Browser die Anmeldefelder automatisch mit veralteten Anmeldedaten ausfüllt. Prüfen, ob die Tastatur auf die richtige Sprache 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 das reCAPTCHA weiterhin nicht geladen wird, den Phrase-Support kontaktieren.
-
Organisationen wechseln (falls zutreffend)
Ein Konto kann mit mehreren Organisationen verknüpft sein. Wenn die Anmeldung bei der falschen Organisation erfolgt ist, zu einer anderen Organisation wechseln.
-
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 Verbindungsfehler, selbst bei korrekten Anmeldedaten.
Wenn die Anmeldung trotz korrekter Anmeldedaten weiterhin fehlschlägt, beim Administrator der Organisation nachfragen, ob das aktuelle Netzwerk oder die IP-Adresse auf der Liste der zulässigen Adressen steht.
Die Phrase-Plattform unterstützt Social Login über die folgenden Anbieter:
-
Google
-
Microsoft
-
GitHub
Zur Registrierung oder Anmeldung über ein Konto bei einem sozialen Netzwerk https://eu.phrase.com oder https://us.phrase.com aufrufen und das gewünschte Konto verknüpfen. Auch Konten bei sozialen Netzwerken, die bereits mit Phrase TMS oder Phrase Strings verknüpft sind, können zur Anmeldung bei der Phrase-Plattform verwendet werden.
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 ein soziales Netzwerk 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 lässt sich Social Login über den gewünschten Anbieter eines sozialen Netzwerks in den Benutzerprofileinstellungen der Plattform 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 ist die Anmeldung über die bestehende Verknüpfung mit dem Konto bei einem sozialen Netzwerk möglich.
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:
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.
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, um mit dem im IdP des Kunden vorhandenen Wert übereinzustimmen, 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:
-
Im linken Navigationsmenü des Plattform-Dashboards Organization settings auswählen.
Die Seite öffnet sich und die Registerkarte wird angezeigt.
-
Die Registerkarte auswählen und auf Enable SSO klicken.
Die SSO-Konfigurationsseite wird angezeigt.
-
Den Abschnitt ausfüllen:
-
Im Feld einen eindeutigen Bezeichner eingeben (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ü Identifier type die erforderliche Option auswählen:
:
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:
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
-
-
Mit den vom IdP bereitgestellten Informationen die erforderlichen Felder im Abschnitt ausfüllen und anschließend auf Save klicken.
Die Felder im Abschnitt werden automatisch ausgefüllt.
-
Die Links im Abschnitt kopieren und in der SAML-Konfiguration des IdP eingeben.
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 die Claim-Zuordnung nicht aktualisiert wird, erhalten Benutzer, die eine Einladung annehmen, einen Fehler vom Typ „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 mit dem Vornamen des Benutzers
firstnamezuordnen. -
Den ausgehenden Claim mit dem Nachnamen des Benutzers
lastnamezuordnen. -
Einen
username-Claim hinzufügen und ihn beispielsweise dem User Principal Name zuordnen.
Phrase erwartet, dass die SAML-Attribute firstname, lastname und username heißen. Einige Identitätsanbieter verwenden andere Standardnamen (z. B. givenname und surname), die nicht automatisch zugeordnet werden. Wenn diese Werte übermittelt werden sollen, muss die Claim-Zuordnung im Identitätsanbieter 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:
-
Neuer Benutzer, der eine Einladung annimmt: firstname und lastname. Wenn kein username gesendet wird, generiert Phrase einen Benutzernamen aus der E-Mail-Adresse.
-
JIT-Bereitstellung: firstname, lastname und username.
-
SCIM-Benutzererstellung: username.
Wenn ein erforderliches Attribut fehlt, wird dem Benutzer die Fehlermeldung „missing required attributes“ angezeigt. Bei der SAML-Anmeldung werden Vor- und Nachname im Benutzerprofil nur aktualisiert, wenn beide übermittelt werden. Um das Überschreiben bestehender Profile zu vermeiden, beide Attribute aus der SAML-Anfrage entfernen.
Wenn ausgewählt ist, müssen sich Benutzer mit SSO anmelden.
Wenn Benutzer sich mit SSO anmelden müssen, können diejenigen, die sich zuvor nicht über SSO angemeldet haben, nicht auf die Organisation zugreifen.
Wenn externe Mitwirkende Zugriff ohne SSO benötigen, die Option auswählen.
Optionen:
-
-
-
Die Bezeichner und den Bezeichnertyp eingeben und auf Save klicken.
Alle Benutzer, die sich mit SSO anmelden müssen, werden auf der Seite des Plattform-Dashboards angezeigt.
Die automatische Benutzerbereitstellung verwaltet in Phrase nur unternehmensverwaltete Benutzer, keine selbst registrierten 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 Eigentümer oder Administrator der Plattform-Organisation muss sie separat zum erforderlichen Produkt einladen.
Bei Bedarf kann die Standardzuweisung von Produkt und Rolle in den Einstellungen der Plattform-Organisation geändert werden, wenn die automatische Bereitstellung eingerichtet wird.
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.
Bereitgestellte Benutzer dürfen ihre Phrase-Anmeldedaten nicht ändern, da diese im IdP verwaltet werden.
Wenn die Bereitstellung eines Benutzers über den IdP aufgehoben wird und er dadurch aus seiner letzten Organisation in Phrase entfernt wird, beginnt für das Konto automatisch eine 30-tägige Aufbewahrungsfrist. Während dieser Frist wird die Identität nicht sofort gelöscht, sodass sie wiederhergestellt werden kann, falls die Entfernung versehentlich erfolgte.
Um die Auto-Bereitstellung 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 von Benutzern werden die folgenden Best Practices empfohlen:
-
Mit einem kleinen Test beginnen.
Vor der Einführung der Auto-Bereitstellung in der gesamten Organisation empfiehlt es sich, zunächst eine kleine Gruppe von Benutzern bereitzustellen, um zu prüfen, ob alles korrekt funktioniert.
-
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 Bereitstellung und Benutzeraktualisierungen im gesamten Unternehmen.
-
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, weshalb dieser Schritt unerlässlich ist.
Vor der Umwandlung prüfen, ob 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.
-
Benutzer, die vor der Aktivierung von SCIM hinzugefügt wurden, der Organisation über den IdP zuweisen.
Benutzer, die vor der Aktivierung der automatischen SCIM-Bereitstellung 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.
Die Just-in-Time-Bereitstellung (JIT) ist eine auf dem SAML-Protokoll basierende Methode, mit der Benutzer erstellt werden, wenn sie sich zum ersten Mal über SAML-SSO bei einer Anwendung anmelden. Dies macht es überflüssig, Benutzer manuell bereitzustellen oder Benutzerkonten manuell zu erstellen, und alle erstellten 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.
Zur Konfiguration der JIT-Bereitstellung über SAML-SSO die folgenden Schritte ausführen:
-
Im Platform-Dashboard im linken Navigationsmenü Organization settings auswählen.
Die Seite öffnet sich und die Registerkarte wird angezeigt.
-
Die Registerkarte auswählen.
Die SSO-Konfigurationsseite wird angezeigt.
-
Zu nach unten scrollen und Contact support auswählen, um die Konfigurationseinstellungen zu aktivieren.
Hinweis
SAML-Auto-Bereitstellung und SCIM können nicht gleichzeitig aktiviert werden.
-
Sobald die Einstellungen aktiviert sind, SAML Auto-provisioning (Just in time) aus dem Dropdown-Menü auswählen.
-
Unter die Art der Rollenverwaltung auswählen.
-
gewährt bei der Bereitstellung Zugriff auf alle Phrase-Produkte mit den jeweiligen Standardrollen.
-
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 die Benutzer nicht für das Produkt bereitgestellt.
-
-
Die Attribute in der Tabelle verwenden, um Attribute aus dem IdP den Daten in Phrase zuzuordnen.
Dies ist erforderlich, um sicherzustellen, dass die Benutzerdaten zwischen den beiden Systemen abgeglichen sind.
-
Klicke auf Speichern.
Die Konfiguration ist gespeichert.
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 Auto-Bereitstellung in den Einstellungen der Platform-Organisation geändert werden.
-
Eine SCIM-erstellte Benutzeridentität kann nicht mit einer bestehenden zusammengeführt werden. Es werden nur neue Identitäten unterstützt.
-
Eine SCIM-bereitgestellte Identität kann keiner anderen Organisation unter derselben E-Mail-Adresse beitreten, es sei denn, die zweite Organisation gehört zum selben Kunden. In diesem Fall den Phrase-Support kontaktieren, um eine Organisationsgruppe anzufordern. Sobald diese konfiguriert ist, stellt SCIM die Identität für jede Organisation innerhalb der 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 Benutzerlöschanforderung sendet, wird die Mitgliedschaft dieses Benutzers aus der Phrase-Organisation entfernt. Wenn dies die letzte Organisation ist, der er angehört, beginnt für das Konto eine 30-tägige Aufbewahrungsfrist vor der endgültigen Löschung.
-
Wenn ein SCIM-verwalteter Benutzer Mitglied mehrerer Organisationen ist, entfernt die Löschanforderung einer Organisation seine Mitgliedschaft aus dieser Organisation. Erst nach Erhalt einer Löschanforderung von der letzten Organisation, der er angehört, beginnt die 30-tägige Frist bis zur Löschung.
-
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.
Zur Konfiguration der SCIM-Eigenschaften die folgenden Schritte ausführen:
-
Im Platform-Dashboard im linken Navigationsmenü Organization settings auswählen.
Die Seite öffnet sich und die Registerkarte wird angezeigt.
-
Die Registerkarte auswählen.
Die SSO-Konfigurationsseite wird angezeigt.
-
Zu nach unten scrollen und Contact support auswählen, um die Konfigurationseinstellungen zu aktivieren.
Hinweis
SAML-Auto-Bereitstellung und SCIM können nicht gleichzeitig aktiviert werden.
-
Sobald die Einstellungen aktiviert sind, SCIM aus dem Dropdown-Menü auswählen.
Die SCIM-Konfigurationsdetails werden angezeigt.
-
Das gewünschte für die Codierung eingeben und auf Save klicken.
Hinweis
Das ist aufgrund der Architektur der Phrase-Plattform erforderlich, bei der mehrere Organisationen SCIM verwenden können. Die Organisations-ID wird im Sicherheits-Token codiert, um die Verwendung der UID in der URL zu verhindern.
Das Feld wird mit einem eindeutigen Token gefüllt.
-
Das Token und die kopieren.
Diese werden in den Einstellungen des Identitätsanbieters verwendet.
-
Unter die Art der Rollenverwaltung auswählen.
-
weist bei der Bereitstellung Zugriff auf alle Phrase-Produkte mit Standardrollen zu.
-
ermöglicht die Auswahl einer Rolle für bestimmte Phrase-Produkte, die bei der Bereitstellung auf alle neuen Benutzer angewendet wird.
-
ermöglicht die Konfiguration von Produktzugriff und Rolle für jeden Benutzer anhand der im IdP hinterlegten Informationen bei der Bereitstellung.
-
-
Klicke auf Speichern.
Die Konfiguration wird gespeichert.
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 über SCIM bereitgestellte Identität kann unter einer bestimmten E-Mail-Adresse nur für eine Organisation 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 pro Organisation ein separates Konto mit jeweils einer eigenen E-Mail-Adresse oder einem eigenen Alias. Gehören die Organisationen zur selben Gruppe, kann der Phrase-Support sie als Organisationsgruppe konfigurieren, damit eine einzige Identität für alle bereitgestellt werden kann.
SCIM verwaltet nur das Home-Konto (intern) eines Benutzers in einer Organisation. Eine externe Mitgliedschaft, bei der sich die Home-Organisation des Kontos von der Organisation unterscheidet, die den SCIM-Push durchführt, kann nicht über die SCIM-Konfiguration dieser Organisation aktualisiert oder verwaltet werden.
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 mitphrase__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__platformist obligatorisch. -
Mit
nonelässt sich der Zugriff auf ein Produkt ausschließen. -
Alle Rollen müssen mit denjenigen übereinstimmen, die konfiguriert und im entsprechenden Phrase-Produkt verfügbar sind. 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.
Bei Fragen zur Einrichtung der rollenbasierten SCIM-Bereitstellung oder zur Behebung von Konfigurationsfehlern hilft der zuständige Solution Architect weiter.
Beispielkonfiguration in Okta
Die SCIM-Rollenbereitstellung in Okta wird wie folgt konfiguriert:
-
Für jedes Phrase-Produkt ein benutzerdefiniertes Attribut erstellen:
-
phrase__platform -
phrase__tms -
phrase__strings
-
-
Gültige Rollenwerte für jedes Attribut festlegen.
-
Diese Attribute der SCIM-App in Okta zuordnen.
-
Bei Bedarf bedingte Logik verwenden, um Rollen anhand des Benutzerprofils oder der Gruppenzugehörigkeit dynamisch zuzuordnen.
-
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 Werte übereinstimmen, einschließlich der Groß-/Kleinschreibung. Das Präfix phrase__<product> selbst unterscheidet nicht zwischen Groß- und Kleinschreibung.
-
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
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 bisherige 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 einen IdP integrieren. Wenn mehrere IdPs verwendet werden, vor der Migration einen IdP für die Einrichtung von Plattform-SSO auswählen.
Migrationsschritte
-
Plattform-SSO im IdP einrichten (Okta, Azure, TrustBuilder oder andere IdPs).
-
Damit es bei den Benutzern nicht zu Verwirrung kommt, den global eindeutigen Bezeichner in Plattform-SSO auf denselben Wert wie im bisherigen SSO setzen.
-
-
Bestehende Benutzer und Gruppen aus der bisherigen SSO-Integration zur neuen Plattform-SSO-Integration im IdP einladen.
-
Die Änderungen am Anmeldeablauf kommunizieren:
-
Benutzer müssen die Plattform-Anmeldeseite verwenden:
-
https://eu.phrase.com/ (EU-Rechenzentrum)
-
https://us.phrase.com/ (US-Rechenzentrum)
-
-
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.
Probleme bei der SSO-Anmeldung mit derselben E-Mail-Adresse für mehrere Konten beheben
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, wird dieses Konto angemeldet. 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 (JIT)-Bereitstellung 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 eigenen 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 den Benutzernamen-Bezeichner mit einem eigenen Benutzernamen pro Konto nutzen.
Wenn ein einziges Konto und eine einzige Anmeldung für alle Organisationen gewünscht sind, kann der Phrase-Support kontaktiert werden. Konten, die derselben Person in verschiedenen Organisationen gehören, können zu einem Konto zusammengeführt werden, das Mitglied aller Organisationen ist. Die Zusammenführung ist für 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 in die Organisation einladen, bevor SSO aktiviert wird, um die unbeabsichtigte Erstellung von Konten zu vermeiden.