Comment les utilisateurs sont-ils identifiés ?

Vous pouvez identifier vos utilisateurs avec l'un des éléments suivants :

• L'adresse e-mail avec laquelle l'utilisateur se connecte à votre application.
• Le cas échéant, l'ID unique de l'utilisateur, nommé GUID, dans le fournisseur d'identité. Bien que cet identifiant existe toujours et qu'il soit garanti unique, il n'est pas toujours facilement accessible ou simple à comprendre. Par exemple, Cloud Directory utilise un ID global unique aléatoire de 16 octets.

Quelles informations fournit le fournisseur d'identité ?

Consultez le tableau suivant pour voir quel type d'informations d'identité vous pouvez utiliser.

Types d'informations sur l'identité pouvant être utilisées avec chaque fournisseur

Fournisseur d"identité	GUID	Adresse électronique	Sub
Cloud Directory
Facebook
Google
SAML
Personnalisé

Comment est géré Cloud Directory ?

Pour garantir l'intégrité d'un futur utilisateur, Cloud Directory impose des exigences en matière de pré-enregistrement.

• Pour ajouter l'utilisateur, vous devez utiliser une adresse e-mail et non pas un nom d'utilisateur. Si vous ne disposez d'aucun utilisateur pour le moment, passez en mode Adresse électronique et mot de passe pour ajouter les futurs utilisateurs. Si vous disposez d'utilisateurs, vous devez patienter jusqu'à leur première connexion pour affecter des attributs personnalisés.
• L'utilisateur doit confirmer son identité via une vérification. Lorsque vous ajoutez un futur utilisateur avec des attributs spécifiques, ces attributs concernent uniquement cette personne. Tout utilisateur qui se connecte avec une adresse e-mail enregistrée pour un futur utilisateur doit vérifier son adresse e-mail pour pouvoir obtenir l'accès à votre application. Pour satisfaire aux exigences liées à cette vérification, vous pouvez envoyer un courrier électronique pour que l'utilisateur puisse vérifier son adresse ou la vérifier vous-même manuellement pour lui. Pour permettre l'auto-vérification, définissez Vérification de l'adresse électronique sur Activé dans l'onglet Cloud Directory du tableau de bord du service. Cette option entraîne l'envoi d'un courrier électronique à l'utilisateur pour demander la vérification lors de leur première connexion. Pour vérifier les utilisateurs manuellement, vous devez être administrateur. Demander aux API de gestion de l' annuaire du nuage de définir le champ status de la charge utile comme étant CONFIRMED.

Si un futur utilisateur est ajouté par vos soins et se connecte à votre application sans avoir vérifié son adresse e-mail, ses attributs personnalisés sont supprimés et le profil est créé de toute pièce.

Dois-je faire quelque chose de spécial lorsque j'utilise un fournisseur d'identité personnalisé ?

Lorsque vous ajoutez à l'avance des informations utilisateur à votre application, vous pouvez utiliser n'importe quel identificateur unique fourni par le flux d'authentification. L'identificateur doit_exactement_ correspondre sub au jeton Web JSON signé qui est envoyé lors de la demande d'autorisation. Si l'identificateur ne correspond pas, la liaison du profil que vous souhaitez ajouter n'aboutit pas.

Avant de commencer

Avant de commencer, vous devez disposer des informations suivantes :

• Le fournisseur d'identité qui sera utilisé par l'utilisateur pour se connecter.
• L'adresse e-mail de l'utilisateur que vous souhaitez ajouter ou son identificateur unique.
• Les informations sur les attributs personnalisés que vous souhaitez affecter.

Avec l'interface graphique

Vous pouvez ajouter un futur utilisateur et ses attributs personnalisés en utilisant l'interface graphique.

La possibilité d'ajouter de futurs utilisateurs est désactivée pour la configuration avec nom d'utilisateur et mot de passe de Cloud Directory.

1. Accédez à l'onglet Profils d'utilisateur du tableau de bord App ID.

2. Cliquez sur Futurs utilisateurs. Si vous disposez déjà de futurs utilisateurs, vous voyez un tableau avec la liste des utilisateurs que vous avez déjà ajoutés. Pour ajouter un autre utilisateur, cliquez sur Créer un profil. Si vous ne disposez d'aucun utilisateur pour le moment, cliquez sur Démarrage. Un écran s'ouvre.

3. Entrez votre adresse e-mail.

4. Sélectionnez le fournisseur d'identité qu'il utilisera pour se connecter dans la liste déroulante Fournisseur d'identité.

5. Ajoutez des attributs personnalisés en entrant les informations dans un objet JSON comme illustré dans l'exemple suivant.

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

6. Cliquez sur Sauvegarder. Le tableau s'affiche et un identificateur est attribué à l'utilisateur.

Avec l'API

Vous pouvez ajouter un futur utilisateur et ses attributs personnalisés en utilisant l'API.

1. Connectez-vous à IBM Cloud.

   ibmcloud login
   

2. Recherchez votre jeton IAM en exécutant la commande suivante.

   ibmcloud iam oauth-tokens
   

3. Envoyez une requête POST au noeud final /users contenant une description de l'utilisateur et des attributs que vous souhaitez définir comme objet JSON.

   En-tête :

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

   Corps :

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

   Les composants de la demande POST

   Composants	Description
   idp	Fournisseur d'identité avec lequel l'utilisateur s'authentifie. Les options sont les suivantes : saml, cloud_directory, facebook, google, appid_custom.
   idp-identity	Identificateur unique fourni par le fournisseur d'identité.
   profile	Profil utilisateur contenant le mappage JSON des attributs personnalisés.

   Exemple de demande :

   $ 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. Vérifiez que l'enregistrement a abouti.

   • Recherchez le profil utilisateur qui a été créé.

     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' \
     

   • Recherchez l'ID utilisateur dans la réponse.

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