API de Phrase TMS

Autenticación de API (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

La mayoría de las llamadas a la API requieren un usuario autenticado. Las API no utilizan perfiles de usuario especiales. Puedes llamar a cada API en nombre de cualquier usuario existente con su nombre de usuario y contraseña.

Existen dos métodos para autenticarse con la API:

  • Autenticación basada en tokens

  • Autenticación OAuth 2.0

Autenticación basada en tokens

Antes de llamar a cualquier API que requiera un usuario autenticado, llama a la API auth/login para obtener un token de autenticación. El token es válido durante 24 horas y puede utilizarse para todas las llamadas posteriores, pero caducará si el usuario cierra la sesión a través de la interfaz de usuario. No crees un nuevo token para cada llamada.

Los miembros de varias organizaciones de TMS tienen el mismo nombre de usuario y contraseña para varias cuentas. Si se utilizan varias cuentas, se debe añadir el userUid al cuerpo de la solicitud para especificar en qué organización desea iniciar sesión el usuario. Si no se especifica, el usuario inicia sesión en la cuenta predeterminada asociada al nombre de usuario y la contraseña proporcionados.

En las llamadas posteriores a la API, el token obtenido se utiliza en la cabecera Authorization. El campo de valor de la cabecera se introduce con ApiToken seguido de un espacio y el token en sí.

Si un usuario cierra la sesión desde la interfaz de usuario, el token de API dejará de ser válido.

Si un perfil se encuentra en el centro de datos de EE. UU., añade us. antes de cloud.memsource.com, por ejemplo https://us.cloud.memsource.com/web/api2/v3/auth/login.

Ejemplo: 

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

Autenticación OAuth 2.0

Usa OAuth 2.0 en las aplicaciones en lugar de enviar tokens con cada llamada. Phrase TMS admite un tipo de concesión de código de autorización estándar de OAuth 2.0. Este flujo de OAuth 2.0 es una concesión de código de autorización de cliente público validada solo por URI de redireccionamiento, sin secreto de cliente y sin compatibilidad con PKCE (code_challenge). Antes de continuar, confirma que una herramienta de terceros puede funcionar solo con el Client ID y el URI de redireccionamiento.

Nota

El inicio de sesión OAuth no es compatible con cuentas de usuario que pertenecen a más de una organización.

Elimina la cuenta de usuario de una de las organizaciones para que pertenezca a una sola, o usa la autenticación basada en tokens.

Para establecer la conexión OAuth 2.0, sigue estos pasos:

  1. En la página de Configuración Setup_gear.png, desplázate hacia abajo hasta la sección Integrations y haz clic en Registered OAuth Apps.

    Se abre la página Registered OAuth Apps.

  2. Haz clic en Nuevo.

    Se abre la página Create OAuth App.

  3. Indica un Name, un Redirect URI (devolución de llamada) y, si quieres, una Description.

  4. Haz clic en Guardar.

    Se abre la página Registered OAuth Apps con la nueva conexión en la lista y un Client ID asociado.

    El ID se utiliza en la aplicación que se conecta a Phrase para establecer la conexión. Se almacena en la base de datos y se utiliza para emparejar las solicitudes con el solicitante adecuado.

  5. Usa estas URL con el Client ID generado para la autorización:

    • Auth URL 

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

    • Token URL 

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

    Si un perfil se encuentra en el centro de datos de EE. UU., añade us. antes de cloud.memsource.com, por ejemplo https://us.cloud.memsource.com/web/oauth/authorize.

  6. Al autorizar, usa el perfil de Administrador para iniciar sesión y haz clic en Allow.

    La aplicación ya está vinculada y no se requerirá la llamada a la API de autenticación.

Una vez establecida la conexión OAuth 2.0, se genera un token de portador para su uso en la aplicación.

Ejemplo de uso del token de portador:

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi 

Validez del token de portador

Un token de portador OAuth 2.0 sigue siendo válido cuando el usuario que autorizó la aplicación cierra la sesión de Phrase. Esto difiere de un token de API obtenido a través de auth/login, el cual caduca cuando el usuario cierra la sesión.

Un token de portador deja de funcionar cuando:

  • Se cambia la contraseña del usuario que autorizó la aplicación.

  • La aplicación OAuth se elimina en la página Registered OAuth Apps.

¿Fue útil este artículo?
★ ★ ★ ★ ★

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.