> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-aws-cognito.md).
# Configuration d’AWS Cognito
Configurez un écran de connexion AWS Cognito pour les visiteurs de votre documentation
{% hint style="warning" %}
Ce guide vous explique comment configurer un écran de connexion protégé pour votre documentation. Avant de suivre ce guide, assurez-vous d’avoir d’abord suivi le processus de [l’activation de l’accès authentifié](/docs/documentation/fr/publish/site-audience/authenticated-access/enabling-authenticated-access.md).
{% endhint %}
Pour configurer votre site GitBook avec l’accès authentifié à l’aide d’AWS Cognito, le processus est le suivant :
{% stepper %}
{% step %}
**Créer une nouvelle application AWS Cognito**
Créez une application AWS Cognito à partir de votre tableau de bord AWS.
{% endstep %}
{% step %}
**Installer et configurer l’intégration AWS Cognito**
Installez l’intégration AWS Cognito et ajoutez la configuration requise.
{% endstep %}
{% step %}
**Configurer AWS Cognito pour le contenu adaptatif (facultatif)**
Configurez AWS Cognito pour fonctionner avec le contenu adaptatif dans GitBook.
{% endstep %}
{% endstepper %}
### Créer une nouvelle application AWS Cognito
Accédez au User Pool souhaité dans Cognito, puis cliquez sur Intégration de l’application. Notez le domaine Cognito, nous en aurons besoin pour configurer l’intégration.
Faites défiler jusqu’en bas et cliquez sur « Create app client ». Pour le type d’application, sélectionnez « Confidential client. » Faites défiler jusqu’aux paramètres de l’interface utilisateur hébergée. Dans les Callback URLs autorisées, saisissez l’URL de callback que vous avez obtenue de GitBook lors de l’installation de l’intégration sur une section.
Faites défiler plus bas jusqu’à « OAuth 2.0 grant types » — assurez-vous que « Authorization code grant » est sélectionné.
Pour les « OpenID connect scopes », assurez-vous qu’OpenID est sélectionné.
Faites défiler vers le bas et cliquez sur « Create app client ».
Cliquez sur le client d’application créé et notez le Client ID et le Client Secret.
### Installer et configurer l’intégration AWS Cognito
Accédez aux intégrations dans l’application GitBook, sélectionnez l’accès authentifié comme catégorie, puis installez l’intégration AWS Cognito.
Une fois installée sur votre site, allez dans la configuration et notez l’URL de callback juste au-dessus du bouton Enregistrer. Nous en aurons besoin pour configurer Cognito.
Ouvrez l’écran de configuration de l’intégration Cognito pour la section sur laquelle vous avez installé l’intégration.
Cela devrait ressembler à l’image suivante :
Pour Client ID, Cognito Domain et Client Secret, collez les valeurs obtenues depuis Cognito.
Cliquez sur Enregistrer.
Maintenant, dans GitBook, fermez la fenêtre modale des intégrations et cliquez sur le bouton Gérer le site. Accédez à **Audience**, sélectionnez **Accès authentifié**, et choisissez Cognito comme backend. Ensuite, cliquez sur **Mettre à jour l’audience**. Allez sur l’écran du site et cliquez sur **Publier**.\
\
Le site est désormais publié derrière un accès authentifié contrôlé par votre application Auth0. Pour l’essayer, cliquez sur Visiter. Il vous sera demandé de vous connecter avec Cognito, ce qui confirme que votre site est publié derrière un accès authentifié à l’aide d’Auth0.
### Configurer AWS Cognito pour le contenu adaptatif (facultatif)
Pour tirer parti du contenu adaptatif avec l’accès authentifié dans GitBook, vous devrez configurer votre pool d’utilisateurs Amazon Cognito afin d’inclure des revendications personnalisées dans le jeton ID.
Cela se fait généralement en créant un [déclencheur Lambda Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-lambda-pre-token-generation.html)— plus précisément un *Pre Token Generation* Lambda — qui renvoie une charge utile JSON remplaçant ou ajoutant des revendications personnalisées. Ces revendications peuvent inclure des rôles d’utilisateur, des niveaux d’abonnement ou toute autre métadonnée pertinente pour votre contenu.
Voici un exemple de ce à quoi cela pourrait ressembler :
```javascript
export const handler = async (event, context) => {
// Récupérer l’attribut utilisateur depuis la requête d’événement
const userAttributes = event.request.userAttributes;
// Ajouter des revendications supplémentaires à la réponse de l’événement
event.response = {
"claimsAndScopeOverrideDetails": {
"idTokenGeneration": {},
"accessTokenGeneration": {
"claimsToAddOrOverride": {
"products": ['api', 'sites', 'askAI'],
"isBetaUser": true,
"isAlphaUser": true,
}
}
}
};
// Renvoyer à Amazon Cognito
context.done(null, event);
};
```
Une fois ajoutées, ces paires clé-valeur sont incluses dans le jeton d’authentification et transmises à GitBook, ce qui permet à votre site d’adapter dynamiquement son contenu en fonction du profil de l’utilisateur authentifié.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://gitbook.com/docs/documentation/fr/publish/site-audience/authenticated-access/setting-up-aws-cognito.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
