Usar expresiones personalizadas como Name ID para aplicaciones SAML

Usar expresiones personalizadas como Name ID para aplicaciones SAML

Una vez que habilites y configures SAML SSO para tus aplicaciones en Zoho One, Zoho One autentificará a tus usuarios en esas aplicaciones. Durante la autenticación, Zoho One pasará un valor llamado Name ID a las aplicaciones. El Name ID coincide con las identidades de usuario en Zoho One con las identidades de usuario en la aplicación.
 
Ejemplo:
 
Considera a una usuaria, Amelia, que tiene una dirección de correo electrónico amelia@zylker.biz y un número de cuenta bancaria 123******47. Supongamos que una aplicación bancaria, BankApp, requiere que los usuarios ingresen su número de cuenta como nombre de usuario al iniciar sesión. En otras palabras, BankApp usa 123******47 para identificar a Amelia en lugar de usar amelia@zylker.biz.
 
Normalmente, cuando SAML SSO está configurado entre Zoho One y una aplicación, Zoho One pasará la dirección de correo electrónico de los usuarios como Name ID. Sin embargo, BankApp espera un número de cuenta, no una dirección de correo electrónico; si amelia@zylker.biz se pasa a BankApp como Name ID, BankApp mostrará un error diciendo que no pudo encontrar ningún usuario cuyo número de cuenta sea amelia@zylker.biz. Por lo tanto, el administrador que configura SSO tendrá que configurar Zoho One para pasar el número de cuenta a BankApp como Name ID.
 
Como el Name ID necesita ser único, la mayoría de las aplicaciones usan la dirección de correo electrónico principal del usuario como Name ID. Pero también puedes definir otra información del usuario (como nombres y apellidos, o cualquier campo personalizado que hayas creado para ellos) como el Name ID. Esto puede ser útil en casos donde la aplicación no admite la dirección de correo electrónico como nombre de usuario, o en aplicaciones que has desarrollado e implementado para usar métodos de autenticación no convencionales.

Para cambiar el ID de Nombre de una aplicación:
  1. Inicia sesión en Zoho One , luego haz clic en Directorio en el menú de la izquierda.
  2. Ve a Aplicaciones, luego haz clic en la aplicación para la que deseas cambiar el ID de Nombre.
  3. Ve a Inicio de sesión único, luego haz clic en Detalles del proveedor de servicios.
  4. Bajo Detalles de credenciales, puedes configurar:
    1. Nombre de usuario de la aplicación: El campo que debe pasarse a la aplicación como nombre de usuario.
    2. Formato de ID de Nombre: El formato en el que debe pasarse el nombre de usuario.
  5. Haz clic en Guardar.
     
Para requisitos avanzados, puedes configurar el Nombre de usuario de la aplicación como una expresión personalizada construida como una combinación de múltiples campos. Estas expresiones pueden construirse utilizando métodos de manipulación de cadenas en varios campos en Zoho One.
 
La expresión personalizada debe escribirse en el siguiente formato:
 
String_method(<string>,<additional_values>)


Por ejemplo, una organización puede tener una aplicación personalizada que utiliza una combinación del nombre de usuario del correo electrónico del usuario y el ID de empleado como nombre de usuario. Entonces, un usuario de Zoho One con la dirección de correo electrónico amelia@zylker.biz y un ID de empleado de 7469 usará amelia-7469 como nombre de usuario para la aplicación personalizada. En este caso, el administrador configuraría el Formato de ID de Nombre como No especificado, el Nombre de Usuario de la Aplicación como Personalizado, y el Valor de la Expresión como:
 
String.append(String.replace(user.email,"@zylker.biz","-"),user.Employee ID)
 
Así es como funciona la expresión:
  1. String.replace se ejecutará primero. Reemplaza el dominio del correo electrónico del usuario (@zylker.biz) con un guion, convirtiendo amelia@zylker.biz en amelia-.
  2. String.append se ejecutará a continuación, y adjunta el ID de empleado (7469) al final del resultado que obtuvimos en el paso anterior (amelia-). Entonces, el Nombre de Usuario de la Aplicación final que se pasará a la aplicación será amelia-7469.
     
La siguiente tabla enumera los campos que puedes usar para construir estas expresiones y sus formatos correspondientes:

Nombre del campo
 
Formato
 
Nombre
 
user.firstName
 
Apellido
 
user.lastName
 
Correo electrónico principal
 
user.email
 
Nombre completo
 
user.displayName
 
Cualquier información de campos personalizados
 
user.<custom field>
 
Ejemplo: Para un campo llamado Número de Vehículo , el formato sería user.Número de Vehículo.

Los métodos de cadena que puedes usar para construir expresiones son:

Métodos de cadena
Formato de expresión
Descripción
Ejemplo
Agregar
String.append(<string>,<string_to_be_appended>)
Agrega <string_to_be_appended> al final de la <string>.
String.append(user.firstName,user.Employee ID)
 

 
El valor en el campo "Employee ID" del usuario se agregará con el primer nombre del usuario. Si el primer nombre de un usuario es "Amelia" y el ID de empleado es "7469", entonces el valor será "Amelia7469".
Índice De
String.indexOf(<string>,<character>)
Devuelve la posición de la primera instancia del carácter dado en la <string>.
String.indexOf(user.firstName,"o")
 
Devuelve la posición de la primera instancia del carácter "o" dentro del primer nombre del usuario. Si el primer nombre de un usuario es "Johnson", entonces se devolverá la posición de la primera aparición del carácter "o", que es 2.
Reemplazar
String.replace(<string>,<string_to_be_removed>,<string_to_be_placed>)
Reemplaza todas las ocurrencias de <string_to_be_removed> en la <string> con <string_to_be_placed>.
String.replace(user.firstName,"e","a")
 
Todas las ocurrencias de "e" serán reemplazadas por "a". Si el primer nombre de un usuario es "Ellen", entonces todas las ocurrencias del carácter "e" en el nombre serán reemplazadas por "a", dando como resultado " Allan" como salida.
Reemplazar Primero
String.replaceFirst(<string>,<string_to_be_removed>,<string_to_be_placed>)
Reemplaza la primera ocurrencia de <string_to_be_removed> en la <string> con <string_to_be_placed>.
String.replaceFirst(user.firstName,"e","a")
 
La primera ocurrencia de "e" será reemplazada por "a". Si el primer nombre de un usuario es "Ellen", entonces la primera ocurrencia del carácter "e" en el nombre será reemplazada por "a", dando como resultado "Allen" como salida.
Subcadena
String.substring(<string>,<beginIndex>,<endIndex>)
Obtiene la parte de la <string> que está especificada por los índices.
String.substring(user.firstName,0,1)
 
Se obtendrán el primer y segundo caracteres del primer nombre del usuario. Si el primer nombre de un usuario es "John", entonces se devolverá la cadena "Jo".
Convertir a Minúsculas
String.toLowerCase(<string>)
Convierte todos los caracteres en la cadena dada a minúsculas.
String.toLowerCase(user.firstName)
 
Los caracteres del primer nombre del usuario se convertirán a minúsculas. Si el primer nombre de un usuario es "John", se devolverá "john".
Convertir a Mayúsculas
String.toUpperCase(<string>)
Convierte todos los caracteres en la cadena dada a mayúsculas.
String.toUpperCase(user.firstName)
 
Los caracteres del primer nombre del usuario se convertirán a mayúsculas. Si el primer nombre de un usuario es "John", entonces se devolverá "JOHN".
Recortar
String.trim(<string>)
Elimina los espacios iniciales y finales en la cadena dada. Se puede usar para sanear campos que podrían tener errores tipográficos, o cadenas que se derivaron utilizando otros métodos como substring.
String.trim(user.displayName)
 
Los espacios en blanco, si los hay, serán eliminados. Por ejemplo, si el nombre completo de un usuario es " Johnson Doe", entonces el espacio antes de "Johnson" será eliminado, y "Johnson Doe" será devuelto.



    • Related Articles

    • Agregar Aplicaciones - Vistazo General

      Zoho One admite la adición y gestión de tres tipos diferentes de aplicaciones: Aplicaciones de Zoho Estas son las aplicaciones estándar que vienen incluidas con tu suscripción a Zoho One. Aplicaciones del Marketplace Estas son aplicaciones ...

    • El campo personalizado se está utilizando en el atributo personalizado de ID de Nombre para proporcionar SSO

      Descripción Puedes encontrar este error cuando intentas deshabilitar o eliminar un campo personalizado. Razón Al configurar el inicio de sesión único (SSO) para aplicaciones de Directorio y aplicaciones SAML que no son de Directorio, se puede pasar ...

    • Asignar aplicaciones usando condiciones

      Inicia sesión en Zoho One, luego haz clic en Panel de Administración en el menú de la izquierda. Ve a Aplicaciones, luego elige una aplicación. Ve a Asignación Condicional, luego haz clic en Asignar Grupo. Elige un grupo al que aplicar la condición, ...

    • Autenticación personalizada con Microsoft Entra ID

      Autenticación personalizada con Microsoft Entra ID La autenticación personalizada con Azure permite el inicio de sesión único (SSO) basado en SAML desde Azure a Zoho One. Con SSO, tú y tus empleados pueden iniciar sesión en Azure y acceder a Zoho One ...

    • Integrar aplicación SAML no incluida en el directorio

      Nota: Consulta nuestro directorio de aplicaciones para ver si la aplicación que necesitas ya está integrada con Zoho One. Inicia sesión en Zoho One , luego haz clic en Directorio en el menú de la izquierda. Ve a Aplicaciones, luego haz clic en ...