API Phrase TMS

Autenticazione API (TMS)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

La maggior parte delle chiamate API richiede un utente autenticato. Le API non utilizzano profili utente speciali. Ogni API può essere chiamata per conto di qualsiasi utente esistente utilizzando il suo nome utente e la sua password.

Esistono due metodi per autenticarsi con l'API:

  • Autenticazione basata su token

  • Autenticazione OAuth 2.0

Autenticazione basata su token

Prima di chiamare un'API che richiede un utente autenticato, chiama l'API auth/login per ottenere un token di autenticazione. Il token è valido per 24 ore e può essere utilizzato per tutte le chiamate successive, ma scadrà se l'utente effettua il logout tramite l'interfaccia utente. Non creare un nuovo token per ogni chiamata.

I membri di più organizzazioni TMS hanno lo stesso nome utente e la stessa password per più account. Se vengono utilizzati più account, è necessario aggiungere userUid al corpo della richiesta per specificare a quale organizzazione l'utente desidera accedere. Se userUid non viene specificato, l'utente accede all'account predefinito associato al nome utente e alla password forniti.

Nelle chiamate API successive, il token ottenuto viene utilizzato nell'intestazione Authorization. Il valore dell'intestazione inizia con ApiToken, seguito da uno spazio e dal token stesso.

Se un utente effettua il logout dall'interfaccia utente, il token API non sarà più valido.

Se un profilo si trova nel data center statunitense, aggiungi us. prima di cloud.memsource.com, ad esempio https://us.cloud.memsource.com/web/api2/v3/auth/login.

Esempio: 

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

Autenticazione OAuth 2.0

Utilizza OAuth 2.0 nelle applicazioni invece di inviare token a ogni chiamata. Phrase TMS supporta il tipo di concessione con codice di autorizzazione previsto dallo standard OAuth 2.0. Questo flusso OAuth 2.0 usa la concessione del codice di autorizzazione per client pubblici, convalidata solo tramite l'URI di reindirizzamento, senza segreto client né supporto per PKCE (code_challenge). Verifica che uno strumento di terze parti possa funzionare solo con ID client e URI di reindirizzamento prima di procedere.

Nota

L'accesso OAuth non è supportato per gli account utente che appartengono a più di un'organizzazione.

Rimuovi l'account utente da una delle organizzazioni in modo che appartenga a una sola organizzazione, oppure utilizza l'autenticazione basata su token.

Per stabilire la connessione OAuth 2.0, segui questi passaggi:

  1. Dalla pagina Impostazioni Setup_gear.png, scorri verso il basso fino alla sezione Integrazioni e fai clic su App OAuth registrate.

    Si apre la pagina App OAuth registrate.

  2. Fai clic su Nuovo.

    Si apre la pagina Crea app OAuth.

  3. Fornisci un Nome, un URI di reindirizzamento (Callback) e una Descrizione facoltativa.

  4. Clicca su Salva.

    Si apre la pagina App OAuth registrate con la nuova connessione nell'elenco e un ID client associato.

    L'ID viene utilizzato nell'applicazione che si connette a Phrase per stabilire la connessione. Viene archiviato nel database e utilizzato per associare le richieste al richiedente corretto.

  5. Utilizza questi URL con l'ID client generato per l'autorizzazione:

    • URL di autorizzazione 

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

    • URL del token 

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

    Se un profilo si trova nel data center statunitense, aggiungi us. prima di cloud.memsource.com, ad esempio https://us.cloud.memsource.com/web/oauth/authorize.

  6. Durante l'autorizzazione, utilizza il profilo Amministratore per accedere e fai clic su Consenti.

    L'applicazione è ora collegata e la chiamata API di autenticazione non è più necessaria.

Una volta stabilita la connessione OAuth 2.0, viene generato un token Bearer da utilizzare nell'applicazione.

Esempio di utilizzo del token Bearer:

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

Validità del token Bearer

Un token Bearer OAuth 2.0 rimane valido quando l'utente che ha autorizzato l'applicazione esegue il logout da Phrase. Ciò differisce da un token API ottenuto tramite auth/login, che scade quando l'utente esegue il logout.

Un token Bearer smette di funzionare quando:

  • la password dell'utente che ha autorizzato l'applicazione viene modificata.

  • l'app OAuth viene eliminata nella pagina App OAuth registrate.

Questo articolo ti è stato utile?
★ ★ ★ ★ ★

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.