View a markdown version of this page

Mettre en œuvre des flux d'authentification - Amazon Cognito

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.

Mettre en œuvre des flux d'authentification

Que vous implémentiez une connexion gérée ou une interface d'application personnalisée avec un AWS SDK pour l'authentification, vous devez configurer votre client d'application pour les types d'authentification que vous souhaitez implémenter. Les informations suivantes décrivent la configuration des flux d'authentification dans vos clients d'application et dans votre application.

App client supported flows

Vous pouvez configurer les flux pris en charge pour les clients de votre application dans la console Amazon Cognito ou à l'aide de l'API d'un AWS SDK. Après avoir configuré votre client d'application pour prendre en charge ces flux, vous pouvez les déployer dans votre application.

La procédure suivante configure les flux d'authentification disponibles pour un client d'application avec la console Amazon Cognito.

Pour configurer un client d'application pour les flux d'authentification (console)

  1. Connectez-vous AWS et accédez à la console des groupes d'utilisateurs Amazon Cognito. Choisissez un groupe d'utilisateurs ou créez-en un nouveau.

  2. Dans la configuration de votre groupe d'utilisateurs, sélectionnez le menu App clients. Choisissez un client d'application ou créez-en un nouveau.

  3. Sous Informations sur le client de l'application, sélectionnez Modifier.

  4. Sous Flux clients de l'application, choisissez les flux d'authentification que vous souhaitez prendre en charge.

Pour configurer un client d'application pour les flux d'authentification (API/SDK)

Pour configurer les flux d'authentification disponibles pour un client d'application avec l'API Amazon Cognito, définissez la valeur de ExplicitAuthFlows in a CreateUserPoolClientor UpdateUserPoolClientrequest. Voici un exemple qui fournit un mot de passe à distance sécurisé (SRP) et une authentification basée sur les choix à un client.

"ExplicitAuthFlows": [ 
   "ALLOW_USER_AUTH",
   "ALLOW_USER_SRP_AUTH"
]

Lorsque vous configurez des flux pris en charge par le client de l'application, vous pouvez spécifier les options et valeurs d'API suivantes.

Support du flux client de l'application
Flux d'authentification Compatibilité Console API
Choice-basedauthentification Server-side, côté client Sélectionnez un type d'authentification lors de la connexion ALLOW_USER_AUTH
Sign-in avec des mots de passe persistants Client-side Connectez-vous avec votre nom d'utilisateur et votre mot de passe ALLOW_USER_PASSWORD_AUTH
Sign-in avec des mots de passe persistants et une charge utile sécurisée Server-side, côté client Connectez-vous avec un mot de passe à distance sécurisé (SRP) ALLOW_USER_SRP_AUTH
Actualiser les jetons Server-side, côté client Obtenez de nouveaux jetons d'utilisateur à partir de sessions authentifiées existantes ALLOW_REFRESH_TOKEN_AUTH
Server-side authentification Server-side Connectez-vous à l'aide des informations d'identification administratives côté serveur ALLOW_ADMIN_USER_PASSWORD_AUTH
Authentification personnalisée Server-side et des applications personnalisées côté client. Non compatible avec la connexion gérée. Connectez-vous à l'aide de flux d'authentification personnalisés à partir de déclencheurs Lambda ALLOW_CUSTOM_AUTH
Implement flows in your application

La connexion gérée met automatiquement à disposition les options d'authentification que vous avez configurées sur vos pages de connexion. Dans les applications personnalisées, lancez l'authentification par une déclaration du flux initial.

Lorsque vous connectez des utilisateurs, le corps de votre AdminInitiateAuthdemande InitiateAuthou de votre demande doit inclure un AuthFlow paramètre.

Choice-based authentification :

"AuthFlow": "USER_AUTH"

Client-based authentification avec SRP :

"AuthFlow": "USER_SRP_AUTH"