Phrase TMS API

API-Authentifizierung (TMS)

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

Die meisten API-Aufrufe erfordern einen authentifizierten Benutzer. Die APIs verwenden keine speziellen Benutzerprofile. Jede API kann im Namen eines beliebigen bestehenden Benutzers unter Verwendung dessen Benutzernamens und Passworts aufgerufen werden.

Es gibt zwei Methoden zur Authentifizierung bei der API:

  • Tokenbasierte Authentifizierung

  • OAuth-2.0-Authentifizierung

Tokenbasierte Authentifizierung

Vor dem Aufruf einer API, die einen authentifizierten Benutzer voraussetzt, die auth/login-API aufrufen, um ein Authentifizierungs-Token zu erhalten. Das Token ist 24 Stunden lang gültig und kann für alle nachfolgenden Aufrufe verwendet werden, läuft jedoch ab, wenn sich der Benutzer über die Benutzeroberfläche abmeldet. Nicht für jeden Aufruf ein neues Token erstellen.

Mitglieder mehrerer TMS-Organisationen haben denselben Benutzernamen und dasselbe Passwort für mehrere Konten. Wenn mehrere Konten verwendet werden, muss der Parameter userUid zum Anfragetext hinzugefügt werden, um anzugeben, bei welcher Organisation sich der Benutzer anmelden möchte. Wenn dies nicht angegeben ist, wird der Benutzer bei dem Standardkonto angemeldet, das mit dem angegebenen Benutzernamen und Passwort verknüpft ist.

Bei nachfolgenden API-Aufrufen wird das erhaltene Token im Authorization-Header verwendet. Das Header-Wertfeld wird mit ApiToken eingeleitet, gefolgt von einem Leerzeichen und dem Token selbst.

Wenn sich ein Benutzer über die Benutzeroberfläche abmeldet, ist das API-Token nicht mehr gültig.

Wenn sich ein Profil im US-Rechenzentrum befindet, us. vor cloud.memsource.com einfügen, zum Beispiel https://us.cloud.memsource.com/web/api2/v3/auth/login.

Beispiel: 

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

OAuth-2.0-Authentifizierung

In Anwendungen OAuth 2.0 verwenden, statt bei jedem Aufruf Token zu senden. Phrase TMS unterstützt den standardmäßigen OAuth 2.0-Autorisierungscode-Grant-Typ. Dieser OAuth 2.0-Flow ist ein Autorisierungscode-Grant für öffentliche Clients, der nur durch die Redirect-URI validiert wird, ohne Client Secret und ohne PKCE (code_challenge)-Unterstützung. Vor dem Fortfahren sicherstellen, dass ein Drittanbieter-Tool allein mit Client ID und Redirect-URI funktioniert.

Hinweis

OAuth-Login wird für Benutzerkonten, die zu mehr als einer Organisation gehören, nicht unterstützt.

Das Benutzerkonto entweder aus einer der Organisationen entfernen, sodass es nur noch einer Organisation angehört, oder stattdessen die tokenbasierte Authentifizierung verwenden.

Zum Herstellen der OAuth-2.0-Verbindung die folgenden Schritte ausführen:

  1. Auf der Seite Settings Setup_gear.png nach unten zum Bereich Integrations scrollen und auf Registered OAuth Apps klicken.

    Die Seite Registered OAuth Apps wird geöffnet.

  2. Klicke auf Neu.

    Die Seite Create OAuth App wird geöffnet.

  3. Die Felder Name und Redirect URI (Callback) sowie optional Description ausfüllen.

  4. Klicke auf Importieren.

    Die Seite Registered OAuth Apps wird geöffnet, wobei die neue Verbindung in der Liste erscheint und eine zugehörige Client ID aufweist.

    Die ID wird in der Anwendung verwendet, die eine Verbindung zu Phrase herstellt, um die Verbindung aufzubauen. Sie wird in der Datenbank gespeichert und dazu verwendet, Anfragen dem richtigen Anfragesteller zuzuordnen.

  5. Zur Autorisierung diese URLs zusammen mit der generierten Client ID verwenden:

    • Auth URL 

      https://cloud.memsource.com/web/oauth/authorize 

    • Token URL 

      https://cloud.memsource.com/web/oauth/token 

    Wenn sich ein Profil im US-Rechenzentrum befindet, us. vor cloud.memsource.com einfügen, zum Beispiel https://us.cloud.memsource.com/web/oauth/authorize.

  6. Bei der Autorisierung mit dem Administratorprofil anmelden und auf Allow klicken.

    Die Anwendung ist nun verknüpft und der Authentifizierungs-API-Aufruf ist nicht mehr erforderlich.

Sobald die OAuth-2.0-Verbindung hergestellt ist, wird ein Bearer-Token für die Verwendung in der Anwendung generiert.

Beispiel für die Verwendung eines Bearer-Tokens:

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

Gültigkeit des Bearer-Tokens

Ein OAuth-2.0-Bearer-Token bleibt gültig, wenn sich der Benutzer, der die Anwendung autorisiert hat, bei Phrase abmeldet. Dies unterscheidet sich von einem API-Token, das über auth/login abgerufen wurde und abläuft, wenn sich der Benutzer abmeldet.

Ein Bearer-Token funktioniert nicht mehr, wenn:

  • Das Passwort des Benutzers, der die Anwendung autorisiert hat, geändert wird.

  • Die OAuth-App auf der Seite Registered OAuth Apps gelöscht wird.

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.