Administración

Gestión de la identificación en Phrase

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

Inicio de sesión único en la plataforma

La plataforma de localización de Phrase admite el inicio de sesión único en los diferentes productos de Phrase a través de una única página de inicio de sesión o registro. Ve a https://eu.phrase.com (para los de la UE) o a https://us.phrase.com (para el centro de datos de EE. UU.) para registrarte o iniciar sesión a través de la plataforma.

Los nuevos usuarios que se registren en la plataforma, así como los usuarios existentes de Phrase, pueden navegar entre todos los productos disponibles dentro del tablero de la plataforma, sin necesidad de autenticación individual para cada uno de ellos.

Una vez que hayas iniciado sesión en la plataforma, selecciona el menú desplegable Tablero en la esquina superior izquierda para cambiar entre todos los productos suscritos según sea necesario. El conmutador de productos también está disponible en la interfaz de cada producto para todos los usuarios con un perfil de usuario de la plataforma.

Requisitos para acceder al producto

  • El acceso a los productos está definido por el plan adquirido

  • Phrase TMS y Phrase Strings

  • Phrase Orchestrator

    • Acceso a TMS o Strings

  • Phrase Custom AI, Phrase Language AI y Phrase Analytics

Nota

Para obtener más información sobre los planes de la plataforma, las funciones disponibles en cada plan y los límites de uso, visita la página de precios de Phrase.

Los usuarios de TMS o Strings pueden iniciar sesión en la página de inicio de sesión de la plataforma introduciendo su nombre de usuario y contraseña o mediante el SSO de la plataforma.

Importante

Cuando el SSO está habilitado, no se admite el cambio del correo electrónico de un usuario en la interfaz de usuario. Para los usuarios gestionados por SCIM, los cambios de correo electrónico se realizan a través del proveedor de identidad.

Estado de membresía de identidad

Los usuarios pueden pertenecer a varias organizaciones de Phrase y cambiar entre ellas según sea necesario. Para cumplir con las políticas de retención de datos, los datos personales (p. ej., nombre y correo electrónico) de los usuarios (excepto los propietarios) que sean miembros de una organización pero no tengan acceso a ningún producto se anonimizarán automáticamente tras 12 meses de inactividad.

Cada usuario en la Plataforma Phrase tiene un estado de membresía de identidad de Interno o Externo, según cómo se creó su cuenta y qué organización la gestiona.

  • Usuario interno

    Es un usuario creado directamente en una organización o provisionado a través de SSO/SCIM. La organización interna (organización principal) gestiona completamente la identidad del usuario, incluida la información del perfil y la configuración de inicio de sesión.

  • Usuario externo

    Es un usuario que pertenece a otra organización como Interno y ha sido invitado a colaborar en una organización adicional. La organización externa puede asignar tareas, pero no puede editar el perfil del usuario ni las credenciales de inicio de sesión.

Los usuarios solo pueden ser Internos en una organización al mismo tiempo (o más si están en el mismo grupo de organizaciones) y pueden aparecer como Externos en otras.

El estado de membresía se muestra en la página de Usuarios del tablero de la Plataforma.

Resolución de problemas de inicio de sesión

En caso de problemas de inicio de sesión, sigue estos pasos de solución de problemas:

  1. Usa el modo incógnito

    Como primer paso, abre una ventana de incógnito (modo anónimo del navegador) e intenta iniciar sesión. Si tienes éxito, borre la caché del navegador, las cookies y el historial de navegación relacionados con los sitios de Phrase.

  2. Verifica credenciales

    Si borrar las cookies y la caché no funciona, asegúrate de que estás usando las credenciales de inicio de sesión correctas.

    • Si existen múltiples cuentas en Phrase, ingresa el nombre de usuario en lugar de la dirección de correo electrónico.

    • Asegúrate de iniciar sesión en el centro de datos correcto.

  3. Restablece la contraseña

    Si te olvidas de la contraseña, haz clic en ¿Olvidaste tu contraseña? en la página de inicio de sesión y sigue los pasos para restablecer tu contraseña.

    Después de restablecer la contraseña, asegúrate de que el navegador no complete automáticamente los campos de inicio de sesión con credenciales desactualizadas. Confirma que el teclado esté configurado en el idioma correcto para evitar la entrada incorrecta de credenciales.

    Es posible que el reCAPTCHA en la página de recuperación de contraseña no se cargue debido a restricciones de red regionales. Si esto sucede, intenta con una conexión de red diferente, como una VPN o datos móviles. Si el reCAPTCHA sigue sin cargarse, contacta con el soporte de Phrase.

  4. Cambia de organizaciones (si aplica)

    Una cuenta puede estar asociada con múltiples organizaciones. Si has iniciado sesión en el centro de datos incorrecto, cambia de organización.

  5. Comprueba las restricciones de direcciones IP de confianza

    Un administrador puede restringir el acceso a Phrase TMS habilitando la opción Direcciones IP de confianza en Configuración → Acceso y seguridad → Acceso de usuario, de modo que el inicio de sesión quede limitado a una lista definida de rangos de direcciones IP permitidos. Un usuario que se conecta desde una red fuera de esa lista ve un bloqueo o errores de conexión incluso con las credenciales correctas.

    Si el inicio de sesión falla de forma persistente a pesar de tener las credenciales correctas, consulta con el administrador de la organización si la red o dirección IP actual está incluida en la lista de redes o direcciones IP permitidas.

Inicio de sesión a la plataforma a través de redes sociales

La plataforma de Phrase admite que se inicie sesión por redes sociales a través de los siguientes proveedores sociales:

  • Google

  • Microsoft

  • GitHub

Ve a https://eu.phrase.com o https://us.phrase.com para registrarte o iniciar sesión conectando la cuenta de red social deseada. Las cuentas de redes sociales de TMS heredadas o Strings también son compatibles para iniciar sesión en la plataforma de Phrase.

Los usuarios que han iniciado sesión pueden vincular su perfil de Phrase a uno de los proveedores de redes sociales disponibles o desvincularlo de uno de ellos desde la configuración del perfil de usuario.

El registro o inicio de sesión a través de redes sociales no está disponible para los usuarios que han sido invitados a unirse a una organización de Phrase:

  • Los nuevos usuarios pueden registrarse proporcionando su nombre de usuario y contraseña o a través del SSO en la página de registro de la plataforma de Phrase.

    Una vez que hayas iniciado sesión, ve a la configuración del perfil de usuario de la plataforma para habilitar el inicio de sesión por redes sociales a través del proveedor social deseado.

  • Los usuarios existentes que han sido invitados a unirse a otra organización de Phrase deben restaurar su contraseña para aceptar la invitación.

    Una vez que se haya restaurado la contraseña, inicia sesión utilizando la conexión de tu cuenta de red social existente.

SSO de la plataforma

El inicio de sesión único, o SSO, permite a los usuarios de la plataforma iniciar sesión a través de aplicaciones de terceros. La plataforma de Phrase permite integraciones con proveedores de identidad (IdP) que cumplen con el SCIM 2.0 y el protocolo SAML 2.0 (Microsoft Entra ID, Okta, Google Workspace, etc.).

Los usuarios tendrán acceso siempre que estén conectados al sistema IdP de la organización.

Por defecto, los usuarios pueden iniciar sesión en la plataforma de Phrase tanto a través de SSO como mediante las credenciales existentes de nombre de usuario y contraseña. Si es necesario, se puede hacer cumplir el uso de SSO para restringir la capacidad de iniciar sesión utilizando nombre de usuario y contraseña.

Parámetro uniqueID

La página de inicio de sesión de SSO admite el parámetro de URL uniqueId que rellena de antemano el identificador global único para los usuarios. Colocar una cadena en este parámetro hace que el campo de identificador único se rellene de antemano para el usuario.

Ejemplo:

https://eu.phrase.com/idm-ui/signin/sso?uniqueId=YOUR_ID

Los clientes pueden marcar la URL con este parámetro en su navegador para que no tengan que recordar este valor de ID para iniciar sesión con el SSO.

Habilitar el SSO usando SAML 2.0

La configuración de SSO debe ser realizada por administradores de TI con acceso de administrador al IdP elegido. Solo los propietarios de la plataforma pueden configurar el SSO en Phrase.

Al iniciar sesión con SAML, el nombre y el apellido de los usuarios se actualizan siempre en el perfil de usuario de la organización Phrase para coincidir con el valor presente en el IdP del cliente cuando los atributos respectivos están presentes en la solicitud de inicio de sesión SAML. Para evitar esto, se recomienda eliminar estos atributos de la solicitud de inicio de sesión SAML.

Para configurar el SSO, sigue estos pasos:

  1. Selecciona Configuración de la organización en el menú de navegación situado a la izquierda del panel de control de la plataforma.

    Se abrirá la página de Configuración de la organización y se presentará la pestaña SSO.

  2. Selecciona la pestaña SSO y haz clic en Habilitar SSO.

    Se mostrará la página de configuración de SSO.

  3. Completa la sección Autorizar SSO:

    • Proporciona un identificador único (por ejemplo, el nombre de la organización o una cadena aleatoria) en el campo Identificador único global.

      Los usuarios de la organización deberán usar el identificador único al iniciar sesión en la plataforma de Phrase.

    • Selecciona la opción requerida del menú desplegable Tipo de identificador:

      Nombre de usuario:

      Los usuarios de la plataforma se emparejan con las identidades de usuario del IdP por nombre de usuario. El atributo de formato NameID se utiliza para emparejar usuarios:

      urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified

      Dirección de correo electrónico:

      Los usuarios de la plataforma se emparejan con las identidades de usuario del IdP por correo electrónico. El atributo de formato NameID se utiliza para emparejar usuarios:

      urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress

      El Tipo de identificador seleccionado debe coincidir con el NameID que envía el proveedor de identidad. Esto está controlado por la configuración de formato NameID de la aplicación SAML.

      Una falta de coincidencia entre el Tipo de identificador en Phrase y el formato NameID configurado en el proveedor de identidad provoca errores de inicio de sesión.

  4. Utiliza la información proporcionada por el IdP para completar los campos requeridos en la sección Configurar SAML en Phrase, luego haz clic en Guardar.

    Los campos en la sección Agrega Phrase a tu proveedor de identidad se completan automáticamente.

  5. Copie los enlaces proporcionados en la sección Agregar Phrase a tu proveedor de identidad e introdúcelos en la configuración SAML de tu IdP.

Nota

Firmar la respuesta SAML es necesario para configurar correctamente el SSO de la plataforma.

Si hay una falta de coincidencia entre el certificado que el proveedor de identidad utiliza actualmente para firmar las respuestas SAML y el certificado IdP guardado en Phrase, se produce el error "The IdP response could not be verified due to faulty signature" al iniciar sesión a través de SSO. Para resolver esto, inicia sesión en la plataforma Phrase como propietario de la organización, ve a Configuración de la organización, luego a SSO, después a Configurar SAML en Phrase y asegúrate de que se utilice el certificado X.509 actualmente activo en el proveedor de identidad.

Se puede encontrar más información en la documentación específica del IdP (por ejemplo, Opciones de firma de certificado a través de Microsoft Azure AD).

Nota

Phrase requiere que las declaraciones SAML utilicen los nombres de atributo firstname, lastname y username. Algunos proveedores de identidad envían estos valores bajo otros nombres de declaración predeterminados. Por ejemplo, un proveedor de identidad envía el nombre y el apellido del usuario bajo los nombres de declaración givenname y surname de forma predeterminada, y no envía una declaración username. Estos nombres no se asignan automáticamente a los nombres de atributo que espera Phrase. Si no se actualiza la asignación de declaraciones, los usuarios que acepten una invitación recibirán el error "missing required attributes" y no podrán iniciar sesión.

Para evitar esto, configura la asignación de declaraciones SAML para la aplicación Phrase en el IdP de la siguiente manera:

  • Reasigna la declaración saliente que contiene el nombre del usuario a firstname.

  • Reasigna la declaración saliente que contiene el apellido del usuario a lastname.

  • Agrega una declaración username, por ejemplo, asignada al nombre principal del usuario.

Phrase espera que los atributos SAML se llamen firstname, lastname y username. Algunos proveedores de identidad utilizan nombres predeterminados diferentes (por ejemplo, givenname y surname) que no se asignan automáticamente, así que actualiza la asignación de declaraciones en tu proveedor de identidad si deseas enviarlos.

La dirección de correo electrónico siempre proviene del NameID de SAML. Los usuarios existentes se identifican mediante esa dirección, y no se comprueba ningún otro atributo al iniciar sesión. Los usuarios existentes que aceptan una invitación no necesitan atributos. Los otros atributos solo son obligatorios en los siguientes casos:

  • Nuevo usuario que acepta una invitación: firstname y lastname. Si no se envía ningún nombre de usuario, Phrase genera uno a partir de la dirección de correo electrónico.

  • Aprovisionamiento JIT: firstname, lastname y username.

  • Creación de usuario SCIM: username.

Si falta un atributo obligatorio, el usuario ve el error "missing required attributes". Al iniciar sesión con SAML, el nombre y el apellido se actualizan en el perfil de usuario solo cuando se envían ambos. Para evitar sobrescribir los perfiles existentes, elimina ambos atributos de la solicitud SAML.

Habilitar SSO

Seleccionar Requerir que los usuarios inicien sesión con el SSO obliga a los usuarios a usar el SSO para iniciar sesión.

Requerir que los usuarios inicien sesión con el SSO impide que los usuarios que no iniciaron sesión a través del SSO anteriormente accedan a la organización.

Si un colaborador externo requiere acceso fuera del SSO, selecciona la opción Requerir inicio de sesión SSO para dominios especificados.

Opciones:

  • Permitir todos los métodos de inicio de sesión

  • Exige a todos los usuarios que inicien sesión mediante SSO

  • Exigir inicio de sesión SSO para dominios específicos

    Proporciona identificadores y tipo de identificador y haz clic en Guardar.

Todos los usuarios que deben iniciar sesión con SSO se muestran en la página Usuarios del tablero de la plataforma.

Aprovisionamiento automático de usuarios

El aprovisionamiento automático de usuarios maneja solo a los usuarios gestionados por la empresa en Phrase, no a los usuarios registrados por sí mismos.

La plataforma de Phrase admite dos tipos de aprovisionamiento de usuarios utilizando características de SAML/SSO para automatizar el acceso a las aplicaciones de la Plataforma:

  • Just-in-Time (JIT, o justo a tiempo en español)

  • SCIM

Los nuevos usuarios se crean automáticamente en la organización de la plataforma una vez que se les otorga acceso a Phrase en el proveedor de identidad (IdP) elegido.

Todos los nuevos usuarios se crean como miembros de la organización de la plataforma correspondiente y no tienen acceso a ninguno de los productos por defecto. El propietario o administrador de la organización de la plataforma tendrá que invitarlos al producto requerido por separado.

Si es necesario, la asignación de producto y rol por defecto se puede modificar al configurar el aprovisionamiento automático en la configuración de la organización de la plataforma.

Se requiere que los usuarios creados confirmen su vinculación a la organización. Para hacer esto, se envía un correo electrónico con un enlace de verificación al usuario provisionado. Antes de la verificación, no se permite que el usuario inicie sesión con SSO.

Nota

Para omitir la confirmación de la vinculación, ponte en contacto con tu gestor de éxito del cliente.

A los usuarios provisionados no se les permite cambiar sus credenciales de Phrase, ya que estas son gestionadas en el IdP.

Cuando se revoca el acceso de un usuario a través del IdP y, en consecuencia, se lo elimina de su última organización en Phrase, se inicia automáticamente un plazo de retención de 30 días para su cuenta. Durante este periodo de gracia, la identidad no se elimina inmediatamente, lo que permite su restauración si la eliminación fue accidental.

Configurar el aprovisionamiento automático

Para habilitar o deshabilitar el aprovisionamiento automático, se requiere colaboración con el Soporte Técnico de Phrase para garantizar una configuración adecuada y prevenir problemas potenciales, como cuentas duplicadas o usuarios no asignados.

Para una configuración fluida y una gestión continua de los usuarios, se recomiendan las siguientes mejores prácticas:

  1. Haz una pequeña prueba.

    Antes de implementar el aprovisionamiento automático en toda la organización, se recomienda aprovisionar a un pequeño grupo de usuarios para verificar que todo funcione correctamente.

  2. Asigna a todos los usuarios a través del proveedor de identidad (IdP).

    Después de hacer la prueba con éxito, asigna a todos los usuarios a la aplicación Phrase a través del IdP. SCIM luego automatizará el aprovisionamiento y las actualizaciones de usuarios en toda la organización.

  3. Convierte a los usuarios existentes en usuarios gestionados por la empresa.

    Contacta con el soporte técnico de Phrase para convertir a los usuarios actuales en usuarios gestionados por la empresa. SCIM solo puede actualizar y eliminar usuarios marcados como gestionados por la empresa, lo que hace que este paso sea esencial.

    Antes de la conversión, confirma que el correo electrónico, el nombre de usuario, el nombre y el apellido de cada identidad de Phrase existente coincidan exactamente con los valores correspondientes en el proveedor de identidad. Las discrepancias en los atributos impiden que SCIM vincule o actualice las identidades correctamente.

  4. Asigna a los usuarios previos al SCIM a la organización a través de IdP.

    Los usuarios añadidos antes de habilitar el aprovisionamiento automático de SCIM deben ser asignados a la organización a través del IdP. No asignarlos puede resultar en su eliminación durante la sincronización de SCIM.

Provisionamiento Just-in-Time (JIT)

El provisionamiento Just-in-Time (JIT), o «justo a tiempo», es un método basado en el protocolo SAML que se utiliza para crear usuarios la primera vez que inician sesión en una aplicación a través de SSO SAML. Esto elimina la necesidad de aprovisionar usuarios o crear cuentas de usuario manualmente y todos los usuarios creados tienen acceso automático a los productos de esa organización.

La configuración del provisionamiento JIT debe ser realizada por administradores de TI con acceso de administrador al IdP elegido.

Para configurar el provisionamiento JIT a través de SSO SAML, sigue estos pasos:

  1. Selecciona Configuración de la organización en el menú de navegación, a la izquierda en el tablero de la plataforma.

    Se abrirá la página de Configuración de la organización y se presentará la pestaña SSO.

  2. Selecciona la pestaña SSO.

    Se mostrará la página de configuración de SSO.

  3. Desplázate hacia abajo hasta Configuración del aprovisionamiento automático y selecciona Contactar con soporte para habilitar la configuración.

    Nota

    El aprovisionamiento automático SAML y SCIM no se pueden habilitar al mismo tiempo.

  4. Una vez que se habiliten los ajustes, selecciona Aprovisionamiento automático SAML (JIT) del menú desplegable Aprovisionamiento automático.

  5. Selecciona el tipo de Gestión de roles.

    • Predeterminado asigna acceso a todos los productos de Phrase con roles predeterminados al aprovisionar.

    • Personalizado permite seleccionar un rol para productos específicos de Phrase que se aplicará a todos los nuevos usuarios al aprovisionar.

      Si el rol del usuario está vacío, los usuarios no serán aprovisionados al producto.

  6. Utiliza los atributos en la tabla Declaraciones de atributos para asignar los atributos del IdP a datos en Phrase.

    Esto es necesario para asegurar que los datos de los usuarios estén alineados entre los dos sistemas.

  7. Haz clic en Guardar.

    La configuración se habrá guardado.

Aprovisionamiento de SCIM

El protocolo SCIM es un estándar a nivel de aplicación que permite la gestión y el intercambio seguro de datos de identidad entre dominios.

Funcionalidades de SCIM compatibles:

  • Crear usuario gestionado por la empresa

    • El usuario tiene acceso a todas las aplicaciones que están activas en su organización de la plataforma.

    • El usuario tiene el rol de lingüista en Phrase TMS y el rol de traductor en Phrase Strings.

      Si es necesario, la asignación de producto y rol por defecto se puede modificar al configurar el aprovisionamiento automático en la configuración de la organización de la plataforma.

    • Una identidad de usuario creada por SCIM no puede ser fusionada con una existente. Solo se admiten identidades nuevas.

    • Una identidad aprovisionada por SCIM no puede unirse a una organización diferente con la misma dirección de correo electrónico a menos que la segunda organización pertenezca al mismo cliente. En ese caso, contacta con el soporte de Phrase para solicitar un grupo de organizaciones; una vez configurado, SCIM aprovisiona la identidad en cualquier organización de ese grupo. Si la segunda organización pertenece a otro cliente, envía la invitación a otra dirección de correo electrónico o a un alias de esa dirección para crear un perfil independiente para la nueva organización.

  • Editar atributos de usuario gestionado por la empresa

    La edición de atributos en el IdP se refleja en la plataforma de Phrase.

  • Eliminar usuarios gestionados por la empresa

    • Cuando el IdP envía una solicitud de eliminación de usuario, la pertenencia de ese usuario se elimina de la organización de Phrase. Si es la última organización a la que pertenece, la cuenta entra en un período de retención de 30 días antes de su eliminación permanente.

    • Si un usuario gestionado por SCIM es miembro de múltiples organizaciones, la solicitud de eliminación de una organización eliminará su membresía de esa organización. Solo después de recibir una solicitud de eliminación de la última organización de la que es miembro comenzará la cuenta atrás de 30 días para la eliminación.

Configurar el aprovisionamiento de SCIM

Nota

Debido a las continuas mejoras, es posible que la interfaz de usuario no sea exactamente la misma que se presenta en el vídeo.

La configuración de SCIM debe ser realizada por administradores de TI con acceso de administrador al IdP elegido.

Para configurar las propiedades de SCIM, sigue estos pasos:

  1. Selecciona Configuración de la organización en el menú de navegación izquierdo del panel de la plataforma.

    Se abrirá la página de Configuración de la organización y se presentará la pestaña SSO.

  2. Selecciona la pestaña SSO.

    Se mostrará la página de configuración de SSO.

  3. Desplázate hacia abajo hasta Configuración del aprovisionamiento automático y selecciona Contactar con soporte para habilitar la configuración.

    Nota

    Aprovisionamiento automático SAML y SCIM no pueden estar habilitados al mismo tiempo.

  4. Una vez que se habiliten las configuraciones, selecciona SCIM del menú desplegable Aprovisionamiento automático .

    Se presentarán los detalles de configuración de SCIM.

  5. Configura la autenticación como se describe a continuación.

  6. Copia la URL base de SCIM v2 y las credenciales generadas. La URL y las credenciales se utilizan en la configuración del IdP.

  7. Selecciona el tipo de Gestión de roles.

    • Predeterminado asigna acceso a todos los productos de Phrase con roles predeterminados al aprovisionar.

    • Personalizado permite seleccionar un rol para productos específicos de Phrase que se aplicará a todos los nuevos usuarios al aprovisionar.

    • SCIM permite configurar el acceso al producto y el rol de cada usuario en función de la información establecida en el IdP durante el aprovisionamiento.

  8. Selecciona el tipo de política de eliminación.

    • Desactivación de usuario

    • Eliminación definitiva

  9. Haz clic en Guardar.

    La configuración se habrá guardado.

Autenticación SCIM

Phrase admite tres opciones de autenticación para las solicitudes SCIM desde un proveedor de identidad (IdP). Selecciona una opción en Configuración de la organización > SSO > Configuración de aprovisionamiento automático > Autenticación SCIM.

SCIM_authentication_options.png

Opción

Cuándo usarlo

OAuth2 (recomendado)

El IdP admite la concesión de credenciales de cliente de OAuth 2.0, por ejemplo, Okta OAuth 2 o Microsoft Entra ID Concesión de credenciales de cliente OAuth2. OAuth2 utiliza tokens de acceso de corta duración y el secreto nunca se envía con las solicitudes SCIM.

Bearer v2

El IdP solo admite un token de portador estático (Encabezado HTTP o Token secreto).

Heredado

Disponible solo para configuraciones existentes. Migra a OAuth2 o Bearer v2.

Importante

Generar credenciales de Bearer v2 o OAuth2 impide que el punto de conexión SCIM heredado acepte solicitudes para la organización. Actualiza la configuración en el IdP inmediatamente. No es posible volver a Heredado.

Configurar OAuth2

Para configurar OAuth2, sigue estos pasos:

  1. Asegúrate de que SSO esté habilitado y de que el aprovisionamiento SCIM esté activado (contacta con el soporte de Phrase para habilitar SCIM).

  2. En Autenticación SCIM, selecciona OAuth2 y haz clic en Generar credenciales.

  3. Copia el ID de cliente y el secreto de cliente.

    El secreto de cliente se muestra solo una vez. Guárdalo de forma segura.

  4. Copia la URL base de SCIM v2, por ejemplo https://eu.phrase.com/idm/scim/v2/<id>.

  5. En el IdP, configura la aplicación SCIM con estos valores:

    • URL base del conector SCIM: la URL base de SCIM v2 del paso 3

    • Modo de autenticación: Credenciales de cliente de OAuth 2.0

    • URL del punto de conexión de token: https://eu.phrase.com/idm/oauth/token para el centro de datos de la UE o https://us.phrase.com/idm/oauth/token para el centro de datos de EE. UU.

    • ID de cliente y Secreto de cliente: los valores del paso 2, enviados en el cuerpo de la solicitud (client_secret_post)

    • Ámbito: deja el campo vacío

  6. Haz clic en Guardar en Phrase y prueba la conexión en el IdP.

Los tokens de acceso son válidos durante 4 horas. Cuando el token actual caduca, el IdP solicita uno nuevo con el ID de cliente y el secreto de cliente.

Nota

Phrase no emite tokens de actualización.

Configurar Bearer V2

Para configurar Bearer v2, sigue estos pasos:

  1. Asegúrate de que SSO esté habilitado y de que el aprovisionamiento SCIM esté activado (contacta con el soporte de Phrase para habilitar SCIM).

  2. En Autenticación SCIM, selecciona Bearer v2 y haz clic en Generar credenciales.

  3. Copia el token generado y la URL base de SCIM v2.

    El token solo se muestra una vez. Guárdalo de forma segura.

  4. En el IdP, introduce la URL base de SCIM v2, selecciona Encabezado HTTP o Token de portador como método de autenticación e introduce el token copiado.

  5. Haz clic en Guardar.

Rotar o cambiar credenciales
  • Al volver a hacer clic en Generar credenciales, se crean nuevas credenciales y se invalidan inmediatamente las anteriores. No hay periodo de solapamiento. Actualiza el IdP justo después de regenerar las credenciales para evitar errores en el aprovisionamiento.

  • Cambiar entre Bearer v2 y OAuth2 invalida las credenciales y los tokens de acceso activos del método anterior.

  • Deshabilitar SCIM mantiene las credenciales, pero Phrase rechaza todas las solicitudes SCIM hasta que se vuelva a habilitar SCIM.

Solución de problemas
  • 401 “Not valid authorization token.” en las solicitudes SCIM.

    Posibles causas:

    • La credencial es incorrecta o fue regenerada.

    • El token de acceso caducó.

    • La URL base pertenece a una organización diferente.

    • SCIM o SSO está deshabilitado.

  • 400 invalid_client del punto de conexión de tokens: El ID de cliente o el secreto de cliente es incorrecto, o las credenciales fueron regeneradas.

Nota

Los errores comunes de aprovisionamiento de SCIM se dividen en algunas categorías.

Una cuenta de usuario creada manualmente o mediante sincronización de usuarios, en lugar de a través de SCIM, no puede pasar posteriormente a estar gestionada por SCIM. La solicitud de actualización del proveedor de identidad se rechaza con un error como "Identity is not managed by organization". Para que SCIM gestione una cuenta existente de este tipo, se requiere un paso de migración admitido; una actualización posterior de SCIM por sí sola no basta para incorporar la cuenta.

Una identidad aprovisionada por SCIM solo puede enviarse a una organización bajo una dirección de correo electrónico determinada, a menos que las organizaciones pertenezcan al mismo cliente y estén configuradas como un grupo de organizaciones. Si la misma persona tiene cuentas no relacionadas en dos organizaciones diferentes con la misma dirección de correo electrónico, las solicitudes de aprovisionamiento de SCIM de una o ambas organizaciones fallan. Para las organizaciones que pertenecen a distintos clientes, cada persona necesita una cuenta independiente por organización, con una dirección de correo electrónico o un alias diferente para cada una; si las organizaciones pertenecen al mismo grupo, contacta con el soporte de Phrase para configurarlas como un grupo de organizaciones y poder aprovisionar una sola identidad en todas ellas.

SCIM gestiona solo la cuenta principal (interna) de un usuario en una organización. Una pertenencia externa, en la que la organización principal de la cuenta difiere de la organización que realiza el aprovisionamiento mediante SCIM, no puede actualizarse ni gestionarse mediante la configuración de SCIM de esta última organización.

Configurar la gestión de roles SCIM

Cuando se usa SCIM, la asignación de roles y el acceso al producto se pueden definir directamente en la solicitud de provisión del IdP utilizando el atributo roles.

Cada entrada de la matriz roles de la solicitud SCIM Crear usuario debe contener:

  • Un tipo, que indica el producto objetivo (debe comenzar con phrase__)

  • Un valor, que especifica el nombre exacto del rol para ese producto

Ejemplo de solicitud SCIM

"roles": [
  { "type": "phrase__platform", "value": "MEMBER" },
  { "type": "phrase__tms", "value": "ADMIN" },
  { "type": "phrase__strings", "value": "none" }
]
  • El rol phrase__platform es obligatorio.

  • Usa none para excluir el acceso a un producto.

  • Todos los roles deben coincidir con los configurados y disponibles en el producto correspondiente de Phrase. El rol de Phrase Portal (Portal de Phrase) no es configurable y se infiere automáticamente del rol TMS del usuario.

  • Los nombres de los roles distinguen entre mayúsculas y minúsculas. Se recomienda escribirlos en mayúsculas.

  • Las solicitudes en las que falten campos obligatorios o que incluyan roles no válidos se rechazarán.

Si necesitas ayuda para configurar el aprovisionamiento basado en roles SCIM o al solucionar errores de configuración, contacta con el arquitecto de soluciones asignado.

Ejemplo de configuración en Okta

Para configurar el aprovisionamiento de roles SCIM en Okta, sigue estos pasos:

  1. Crea atributos personalizados para cada producto de Phrase:

    • phrase__platform

    • phrase__tms

    • phrase__strings

  2. Define valores de rol válidos para cada atributo.

  3. Asigna estos atributos a la aplicación SCIM en Okta.

  4. Utiliza la lógica condicional, si es necesario, para asignar roles dinámicamente según el perfil del usuario o la membresía del grupo.

  5. Aplica las asignaciones solo durante la creación del usuario.

    Nota

    Las actualizaciones a los roles de usuario existentes a través de SCIM no son compatibles.

Valores de rol admitidos por producto

Los valores de rol distinguen entre mayúsculas y minúsculas. El valor enviado por el IdP debe coincidir exactamente con uno de los siguientes, incluyendo las mayúsculas. El prefijo phrase__<product> en sí no distingue entre mayúsculas y minúsculas.

  • Plataforma (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

Migrar desde SSO heredado

Importante

A partir del 4 de marzo de 2025, las páginas de inicio de sesión de SSO heredado para TMS y Strings serán descontinuadas. Para garantizar un acceso ininterrumpido a los productos de Phrase, todas las organizaciones que utilicen SSO heredado deben migrar al SSO de la plataforma.

Migrar al SSO de la Plataforma requiere acceso administrativo al proveedor de identidad (IdP). La colaboración con el equipo de TI es esencial para configurar una nueva integración de SSO de la Plataforma en el IdP.

Cada organización de Phrase puede integrarse con solo un IdP. Si se utilizan múltiples IdP, selecciona uno para la configuración de SSO de la Plataforma antes de la migración.

Pasos para realizar la migración

  1. Configura el SSO de la plataforma en el IdP (Okta, Azure, TrustBuilder u otros IdP).

    • Para evitar confusiones para los usuarios, establece el identificador único global en el SSO de la Plataforma para que coincida con el utilizado en el SSO heredado.

  2. Invita a los usuarios y grupos existentes de la integración del SSO heredado a la nueva integración del SSO de la plataforma dentro del IdP.

  3. Comunica los cambios en el flujo de inicio de sesión:

    • Los usuarios deben usar la página de inicio de sesión de la Plataforma:

    • Si inicias sesión a través de un icono del tablero del IdP, los usuarios deben seleccionar el icono actualizado de SSO de la plataforma.

    • Las credenciales del usuario (correo electrónico/nombre de usuario) no cambian.

Una vez que la migración esté completa, todo el contenido existente y los roles de usuario en Phrase TMS y Phrase Strings permanecerán sin cambios.

Resolución de inicios de sesión SSO cuando se utiliza el mismo correo electrónico en varias cuentas

Cuando se utiliza el identificador de correo electrónico, Phrase compara el correo electrónico enviado por el proveedor de identidad con las cuentas que son miembros activos de la organización cuya configuración de SSO se está utilizando. No se tienen en cuenta las cuentas con el mismo correo electrónico en otras organizaciones.

Si se encuentra exactamente una cuenta coincidente, se inicia sesión en esa cuenta. Si no se encuentra ninguna cuenta coincidente, el inicio de sesión falla con un error de "identidad no encontrada", a menos que el aprovisionamiento just-in-time (JIT) esté habilitado para la organización. Si se encuentra más de una cuenta coincidente dentro de la misma organización, el inicio de sesión falla porque el correo electrónico no es único dentro de esa organización.

Las cuentas con el mismo correo electrónico en diferentes organizaciones no entran en conflicto.

Configuraciones recomendadas:

  • Una cuenta por organización, mismo correo electrónico: funciona tal cual — usa el identificador de correo electrónico. No se necesitan cambios en el lado del proveedor de identidad.

  • Un correo electrónico diferente por organización: usa un alias por organización y configura el proveedor de identidad para que envíe ese alias para la aplicación correspondiente. El correo electrónico en Phrase debe coincidir exactamente con lo que envía el proveedor de identidad.

  • Dos cuentas en la misma organización (por ejemplo, una cuenta de administrador y una cuenta de gestor de proyectos): usa un usuario distinto del proveedor de identidad para cada cuenta, o el identificador Username con un nombre de usuario distinto para cada cuenta.

Si prefieres una sola cuenta y un solo inicio de sesión en todas las organizaciones, ponte en contacto con el equipo de soporte de Phrase. Las cuentas que pertenecen a la misma persona en diferentes organizaciones pueden fusionarse en una sola cuenta que sea miembro de todas ellas. La fusión no está disponible para identidades creadas mediante SCIM.

Si el aprovisionamiento JIT está habilitado para una organización y un usuario que intenta iniciar sesión mediante SSO aún no es miembro de esa organización, el SSO crea una nueva cuenta utilizando el correo electrónico proporcionado. Invita a los miembros existentes a la organización antes de habilitar el SSO para evitar la creación involuntaria de cuentas.

¿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.