API Identité headless : Flux Mot de passe oublié headless pour les clients et partenaires

Votre client demande une réinitialisation de mot de passe

Lorsque votre utilisateur a démarré le processus de réinitialisation du mot de passe, votre client envoie une requête POST au point de terminaison Mot de passe oublié headless de votre site Experience Cloud (1).

L'URI de la requête POST est le suivant :

/services/auth/headless/forgot_password

Insérez les en-têtes ci-dessous dans la requête.

Insérez les paramètres ci-dessous dans le corps de la requête.

Voici un exemple de requête pour un client public qui utilise un modèle d'e-mail personnalisé. Il contient un jeton reCAPTCHA pour la sécurité et un paramètre emailtemplate avec le nom du développeur d'un modèle personnalisé.

POST /services/auth/headless/forgot_password HTTP/1.1
Host: MyDomainName.my.site.com
Content-Type: application/json
{
    "username":"lhansen@example.com",,
    "emailtemplate":"unfiled$public/SalesNewCustomerEmail",
    "recaptcha": "<recaptcha token>"
}

Voici un exemple de requête pour un client privé qui utilise le modèle d'e-mail par défaut. Il inclut un jeton d'accès pour la sécurité.

POST /services/auth/headless/forgot_password HTTP/1.1
Host: MyDomainName.my.site.com
Authorization: Bearer 00DR****************
Content-Type: application/json

{
    "username": "lhansen@example.com"
}

Voici un exemple de demande pour un client privé qui utilise la découverte d’utilisateur headless.

POST /services/auth/headless/forgot_password HTTP/1.1
Host: MyDomainName.my.site.com
Authorization: Bearer 00DR****************
Content-Type: application/json

{
    "login_hint": "<user identifier such as email address, phone number, order number>",
    "customdata": {
        "firstName": "Lyle",
        "lastName": "Hansen"
    }
}

(Facultatif) Le gestionnaire de découverte d’utilisateur headless recherche un utilisateur

Si vous utilisez un gestionnaire de découverte d’utilisateur headless, le gestionnaire utilise le paramètre login_hint et customdata et recherche l'utilisateur associé. Le gestionnaire confirme que l'adresse e-mail ou le numéro de téléphone de l'utilisateur est vérifié.

Pour un exemple de gestionnaire, consultez Auth.HeadlessUserDiscoveryHandler.

Salesforce renvoie un message de réussite et vérifie le nom d'utilisateur

Lorsque Salesforce reçoit la demande d'oubli du mot de passe, il envoie un message de réussite au client (2). Si vous n'utilisez pas de gestionnaire de découverte headless, Salesforce vérifie que le nom d'utilisateur correspond à un compte. Si le nom d'utilisateur ne correspond pas à un compte, le flux s'arrête.

Voici un exemple de réponse réussie.

{
    "status": "success",
    "status_code": "otp_sent"
}

Si la requête échoue, Salesforce renvoie un message d'erreur décrivant la requête. Pour la plupart des erreurs, Salesforce renvoie le message d'erreur sous ce format.

{
"status_code": "<error code>",
"<error name>": "<error description>",
"status": "failed"
}

Par exemple, si le client utilise le mauvais type de requête HTTPS, Salesforce renvoie cette réponse d'erreur.

{
"status_code": "post_required",
"invalid request": "use a POST request",
"status": "failed"
}

Pour le code d'erreur invalid_recaptcha, la réponse contient des informations supplémentaires du service reCAPTCHA de Google. Voici comment ces réponses sont mises en forme.

{
"status_code": "invalid_recaptcha",
"invalid_request: "invalid reCAPTCHA token",
"status": "failed",
"recaptcha_response": {
    "success": <true or false>,
    "challenge_ts": <timestamp of the challenge in ISO format (yyyy-MM-dd'T'HH:mm:ssZZ)>,
    "hostname": "<host name of the client where the reCAPTCHA was solved>",
    "error-codes": [<error codes from Google reCAPTCHA...>]
    }
}

Voici une vue d'ensemble des réponses d'erreur.

Salesforce génère et envoie des e-mails contenant un mot de passe à usage unique

Salesforce vérifie qu'un compte avec ce nom d'utilisateur existe dans le système. Si le compte existe, il génère un mot de passe à usage unique et l'envoie (3) à l'adresse e-mail indiquée dans le fichier. Cet e-mail est généré en utilisant le modèle d'e-mail par défaut ou en faisant référence à un modèle personnalisé comme paramètre de la demande initiale emailtemplate. Pour plus d'informations sur la personnalisation du modèle d'e-mail, consultez Personnalisation des e-mails envoyés depuis des sites Experience Cloud.

Votre client soumet le nouveau mot de passe

Lorsque le client reçoit le message de réussite envoyé par Salesforce, il présente nativement à l'utilisateur une page de réinitialisation du mot de passe. Cette page doit inclure des champs pour le mot de passe à usage unique et le nouveau mot de passe de l'utilisateur. Le nouveau mot de passe est soumis aux exigences de mot de passe de Salesforce. Lorsque l'utilisateur a rempli ces champs, le client envoie un autre nom d'utilisateur, mot de passe à usage unique et nouveau mot de passe dans une autre requête POST au point de terminaison Mot de passe oublié (4).

Insérez les en-têtes ci-dessous dans la requête.

Insérez les paramètres ci-dessous dans le corps de la requête.

Voici un exemple de requête pour un client privé.

POST /services/auth/headless/forgot_password HTTP/1.1
Host: MyDomainName.my.site.com
Authorization: Bearer 00DR****************
Content-Type: application/json

{
"username": "lhansen@example.com",
"otp" : "123abc",
"newpassword" : "abcd1234"
}

Voici une requête similaire pour des clients publics qui ne contient pas de jeton d'accès. Le jeton reCAPTCHA a été envoyé dans la requête initiale. Par conséquent, il n'est pas requis dans cette requête.

POST /services/auth/headless/forgot_password HTTP/1.1
Host: MyDomainName.my.site.com
Content-Type: application/json
{
"username": "lhansen@example.com",
"otp" : "123abc",
"newpassword" : "abcd1234"
}

Salesforce vérifie les mots de passe et renvoie un message de réussite

Lorsque Salesforce reçoit la demande de mot de passe, il vérifie la validité du mot de passe à usage unique et vérifie si le nouveau mot de passe respecte la configuration requise. Si ces deux critères sont remplis, il définit le nouveau mot de passe. Une fois le mot de passe modifié, Salesforce envoie un message de réussite au client (5). Voici à quoi ressemble le message de réussite.

{
    "status": "success",
    "status_code": "success"
}

Votre client doit informer l'utilisateur que la modification a été acceptée et qu'il peut se connecter avec son nouveau mot de passe.

Remarque

Si le client envoie un mot de passe à usage unique incorrect ou si le nouveau mot de passe ne respecte pas les exigences de sécurité de Salesforce standard, la réinitialisation du mot de passe échoue. Si la réinitialisation du mot de passe échoue, votre client peut effectuer au maximum cinq tentatives de réinitialisation du mot de passe avec le même mot de passe à usage unique. Vous contrôlez le nombre maximal de tentatives dans vos paramètres Experience Cloud. Après un nombre excessif d'échecs, votre client doit envoyer une nouvelle demande initiale de réinitialisation du mot de passe afin qu'un nouveau mot de passe à usage unique soit généré et envoyé par e-mail à votre utilisateur.

Si le changement de mot de passe échoue, Salesforce renvoie une réponse d'erreur sous ce format.

{
"status_code": "<error code>",
"<error name>": "<error description>",
"status": "failed"
}

Voici un aperçu des erreurs de cette requête.