Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Déclencheur Lambda Vérification de la réponse à la stimulation d'authentification
Le déclencheur du défi Verify Auth est une fonction Lambda qui compare la réponse fournie par un utilisateur à une réponse connue. Cette fonction indique à votre groupe d'utilisateurs si l'utilisateur a répondu correctement au défi. Lorsque le déclencheur du défi de vérification de l'authentification répond par un « `answerCorrect` of »`true`, la séquence d'authentification peut se poursuivre.
![\[Déclencheurs Lambda de stimulation\]](http://docs.aws.amazon.com/fr_fr/cognito/latest/developerguide/images/lambda-challenges3.png)
**Vérifier la réponse au défi d'authentification**
Amazon Cognito appelle ce déclencheur pour vérifier si la réponse de l'utilisateur à une demande de vérification d'authentification personnalisée est valide ou non. Il fait partie du [flux d'authentification personnalisé](https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-authentication-flow.html#amazon-cognito-user-pools-custom-authentication-flow) d'un groupe d'utilisateurs.
La demande pour ce déclencheur contient les paramètres `privateChallengeParameters` et `challengeAnswer`. Le déclencheur Lambda Création d'une demande de vérification d'authentification renvoie les valeurs de `privateChallengeParameters` et contient la réponse attendue de l'utilisateur. Le paramètre `challengeAnswer` contient la réponse de l'utilisateur pour la demande de vérification.
La réponse contient l'attribut `answerCorrect`. Si l'utilisateur répond à la demande de vérification, Amazon Cognito définit la valeur de l'attribut sur `true`. Si l'utilisateur ne répond pas correctement à la demande de vérification, Amazon Cognito définit la valeur sur `false`.
La boucle de demande de vérification se répète jusqu'à ce que les utilisateurs aient répondu à toutes les demandes de vérification.
**Topics**
+ [Paramètres du déclencheur Lambda Vérification de la réponse à la stimulation d'authentification](#cognito-user-pools-lambda-trigger-syntax-verify-auth-challenge)
+ [Exemple de vérification de la réponse à la stimulation d'authentification](#aws-lambda-triggers-verify-auth-challenge-response-example)
## Paramètres du déclencheur Lambda Vérification de la réponse à la stimulation d'authentification
La demande qu'Amazon Cognito transmet à cette fonction Lambda est une combinaison des paramètres ci-dessous et des [paramètres courants](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-working-with-lambda-triggers.html#cognito-user-pools-lambda-trigger-syntax-shared) qu'Amazon Cognito ajoute à toutes les demandes.
------
#### [ JSON ]
```
{
"request": {
"userAttributes": {
"string": "string",
. . .
},
"privateChallengeParameters": {
"string": "string",
. . .
},
"challengeAnswer": "string",
"clientMetadata": {
"string": "string",
. . .
},
"userNotFound": boolean
},
"response": {
"answerCorrect": boolean
}
}
```
------
### Paramètres de demande de vérification de la réponse à la stimulation d'authentification
**userAttributes**
Ce paramètre contient une ou plusieurs paires nom-valeur représentant les attributs utilisateur.
**userNotFound**
Quand Amazon Cognito définit `PreventUserExistenceErrors` sur `ENABLED` pour votre client de groupe d'utilisateurs, Amazon Cognito renseigne ce booléen.
**privateChallengeParameters**
Ce paramètre provient du déclencheur Création d'une demande de vérification d'authentification. Pour déterminer si l'utilisateur a réussi un défi, Amazon Cognito compare ces paramètres au paramètre **challengeAnswer** d'un utilisateur.
Ce paramètre contient toutes les informations qui sont nécessaires pour valider la réponse de l'utilisateur à la demande de vérification. Ces informations incluent la question posée par Amazon Cognito à l'utilisateur (`publicChallengeParameters`), et les réponses valides à la question (`privateChallengeParameters`). Seul le déclencheur Lambda Vérification de la réponse à la demande de vérification d'authentification utilise ce paramètre.
**challengeAnswer**
La valeur de ce paramètre est la réponse de l'utilisateur à la demande de vérification.
**clientMetadata**
Ce paramètre contient une ou plusieurs paires clé-valeur que vous pouvez fournir en tant qu'entrée personnalisée à la fonction Lambda pour le déclencheur Vérification de la réponse à la demande de vérification d'authentification. Pour transmettre ces données à votre fonction Lambda, utilisez le ClientMetadata paramètre dans les opérations [AdminRespondToAuthChallenge](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminRespondToAuthChallenge.html)et [RespondToAuthChallenge](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_RespondToAuthChallenge.html)API. Amazon Cognito n'inclut pas les données issues du ClientMetadata paramètre [AdminInitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminInitiateAuth.html)et des opérations d'[InitiateAuth](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_InitiateAuth.html)API dans la demande transmise à la fonction de vérification de l'authentification.
### Paramètres de réponse de vérification de la réponse à la stimulation d'authentification
**answerCorrect**
Si l'utilisateur répond à la demande de vérification, Amazon Cognito définit ce paramètre sur `true`. Si l'utilisateur ne répond pas correctement à la demande de vérification, Amazon Cognito définit le paramètre sur `false`.
## Exemple de vérification de la réponse à la stimulation d'authentification
Cette fonction de vérification de l'authentification vérifie si la réponse de l'utilisateur à un défi correspond à la réponse attendue. La réponse de l'utilisateur est définie par les entrées de votre application et la réponse préférée est définie `privateChallengeParameters.answer` dans la réponse du [déclencheur du défi Create Auth](user-pool-lambda-create-auth-challenge.md#aws-lambda-triggers-create-auth-challenge-example). La bonne réponse et la réponse donnée font partie de l'événement d'entrée de cette fonction.
Dans cet exemple, si la réponse de l'utilisateur correspond à la réponse attendue, Amazon Cognito définit le `answerCorrect` paramètre sur. `true`
------
#### [ Node.js ]
```
const handler = async (event) => {
if (
event.request.privateChallengeParameters.answer ===
event.request.challengeAnswer
) {
event.response.answerCorrect = true;
} else {
event.response.answerCorrect = false;
}
return event;
};
export { handler };
```
------