¿Cómo se identifican los usuarios?

Puede identificar los usuarios utilizando lo siguiente:

• La dirección de correo electrónico con la que el usuario inicia sesión en la app.
• Si está disponible, el ID exclusivo del usuario, denominado GUID, en el proveedor de identidad. Aunque este identificador siempre existe y es único, no siempre está disponible ni es fácil de comprender. Por ejemplo, el Directorio en la nube utiliza un GUID de 16 bytes.

¿Qué información proporcionan los proveedores de identidad?

Consulte la tabla siguiente para ver qué tipo de información de identidad puede utilizar.

Tipos de información de identidad que pueden utilizarse con cada proveedor

Proveedor de identidad	GUID	Correo electrónico	Sub
Cloud Directory
Facebook
Google
SAML
Personalizado

¿Cómo se maneja el directorio en la nube?

Para garantizar la integridad de un futuro usuario, Cloud Directory impone requisitos de prerregistro.

• Debe utilizar un correo electrónico, no un nombre de usuario, para añadir el usuario. Si todavía no tiene usuarios, cambie a la modalidad de correo electrónico y contraseña para añadir futuros usuarios. Si ya tiene usuarios, debe esperar a que el usuario haya iniciado sesión para asignarle atributos personalizados.
• El usuario debe confirmar su identidad mediante la verificación. Cuando se añade un futuro usuario con atributos específicos, estos atributos están pensados para esa persona. Si un usuario inicia sesión utilizando un correo electrónico que está registrado para un futuro usuario, debe verificar su dirección de correo electrónico para que se le pueda otorgar acceder a la app. Para completar los requisitos de verificación, puede enviar un correo electrónico para que el usuario la verifique, o bien puede verificar manualmente su dirección en su lugar. Para permitir la autoverificación, establezca Verificación por correo electrónico en Activado en el separador Directorio en la nube del panel de control de servicio. De esta forma, se envía un correo electrónico al usuario para solicitar la verificación cuando inicia sesión por primera vez. Para verificar los usuarios de forma manual, debe ser administrador. Realice una solicitud a las API de gestión de Cloud Directory para establecer el campo status de la carga útil en CONFIRMED.

Si añade un futuro usuario y éste inicia sesión en la app sin que se haya verificado su correo electrónico, sus atributos personalizados se suprimen y se crea un perfil nuevo desde cero.

¿Tengo que hacer algo especial cuando utilice un proveedor de identidad personalizado?

Cuando añada información de usuario a la aplicación por adelantado, podrá utilizar cualquier identificador exclusivo proporcionado por el flujo de autenticación. El identificador debe coincidir exactamente con el sub de la señal web JSON firmada que se envía durante la solicitud de autorización. Si el identificador no coincide, significa que el perfil que desea añadir no se ha enlazado correctamente.

Antes de empezar

Antes de empezar, debe disponer de la siguiente información:

• El proveedor de identidad con el que el usuario iniciará la sesión.
• El correo electrónico del usuario que desea añadir o su identificador exclusivo.
• La información de atributos personalizados que desea asignar.

Con la GUI

Puede añadir un usuario futuro y sus atributos personalizados utilizando la GUI.

La posibilidad de añadir usuarios futuros está inhabilitada para la configuración de nombre de usuario y contraseña del Directorio en la nube.

1. Vaya al separador Perfiles de usuario del panel de control de App ID.

2. Pulse Usuarios futuros. Si ya tiene usuarios futuros, verá una tabla con una lista de los usuarios que ya ha añadido. Para añadir otro usuario, pulse Crear un perfil. Si todavía no tiene usuarios, pulse Empezar. Se abre una pantalla.

3. Introduzca el correo electrónico del usuario.

4. Seleccione el proveedor de identidad con el que iniciará la sesión en el menú desplegable Proveedor de identidad.

5. Añada atributos personalizados especificando la información en un objeto JSON tal como se muestra en el ejemplo siguiente.

   {
      "food": "Pizza",
      "preference": "Vegetarian",
      "points": "37"
   }
   

6. Pulse Guardar. Se visualiza la tabla y se asigna un identificador al usuario.

Con la API

Puede añadir un usuario futuro y sus atributos personalizados utilizando la API.

1. Inicie sesión en IBM Cloud.

   ibmcloud login
   

2. Busque la señal de IAM ejecutando el mandato siguiente.

   ibmcloud iam oauth-tokens
   

3. Realice una solicitud POST en el punto final /users que contenga una descripción del usuario y los atributos que desea establecer como objeto JSON.

   Cabecera:

   POST <managementUrl>/management/v4/<tenantID>/users
         Host: <managementServerURL>
         Authorization: 'Bearer <IAMToken>'
         Content-Type: application/json
   

   Cuerpo:

   {
         "idp": "<identityProvider>",
         "idp-identity": "<userUniqueIdentifier>",
         "profile": {
            "attributes": {
               "mealPreference":"vegeterian"
            }
         }
   }
   

   Los componentes de la solicitud POST

   Componentes	Descripción
   idp	El proveedor de identidad con el que se autenticará el usuario. Las opciones incluyen: saml, cloud_directory, facebook, google, appid_custom.
   idp-identity	El identificador único proporcionado por el proveedor de identidad.
   profile	El perfil del usuario que contiene la correlación JSON del atributo personalizado.

   Solicitud de ejemplo:

   $ curl --request POST \
         --url 'https://<managementURI>/users \
         --header 'Authorization: Bearer <IAMToken>' \
         --header 'Content-Type: application/json' \
         --data '{"idp": "saml", "idp-identity": "user@ibm.com", "profile": { "attributes": { "role": "admin",
         "frequent_flyer_points": 1000 }}}'
   

4. Verifique que el registro se ha realizado satisfactoriamente.

   • Compruebe el perfil de usuario que se ha creado.

     curl --request GET https://us-south.appid.cloud.ibm.com/management/v4/<tenantID>/users/<userProfileId>/profile \
     --header 'Authorization: Bearer <IAMToken>' \
     --header 'Content-Type: application/json' \
     

   • Compruebe el ID de usuario en la respuesta.

     {
        "id": "5ce78e09-1356-4ef8-a45d-808b633101db",
        "identities": [],
        "attributes": {
           "role": "manager"
        }
     }