` et renvoyer les [données utilisateur](#user-data-format).
Le chemin de redirection OAuth est `/mintlify-oauth-callback`. Sur un sous-chemin personnalisé, le Dashboard inclut ce sous-chemin dans l'URL de redirection.
Mintlify échange le code d'autorisation et demande les données utilisateur depuis le navigateur du visiteur. Si le jeton ou l'endpoint Info API se trouve sur une origine différente de votre documentation, configurez-le pour autoriser les requêtes cross-origin depuis l'origine exacte de la documentation. L'Info API doit autoriser l'en-tête de requête `Authorization`.
## Préremplissage de la clé d'API
Renseignez automatiquement les champs du bac à sable d'API avec des valeurs propres à chaque utilisateur en renvoyant des noms de champs correspondants dans vos données utilisateur. Incluez ces valeurs dans le champ `apiPlaygroundInputs` de vos [données utilisateur](/docs/fr/deploy/authentication-setup#user-data-format).
```json theme={null}
{
"apiPlaygroundInputs": {
"header": { "X-API-Key": "user_api_key_123" },
"server": { "subdomain": "acme" }
}
}
```
Les noms de champ doivent correspondre aux noms définis dans votre spécification OpenAPI. Mintlify n'applique que les valeurs correspondant au schéma de sécurité du point de terminaison en cours.
## Contenu MDX dynamique
Affichez du contenu en fonction des informations utilisateur comme le nom, l'abonnement ou l'organisation grâce à la variable `user` dans vos pages MDX. Incluez des données personnalisées dans le champ `content` de vos [données utilisateur](/docs/fr/deploy/authentication-setup#user-data-format).
```json theme={null}
{
"content": {
"firstName": "Jane",
"company": "Acme Corp",
"plan": "Enterprise"
}
}
```
Utilisez ces valeurs dans votre MDX.
```mdx theme={null}
Bienvenue, {user.firstName} ! Votre forfait {user.plan} comprend 100 places pour les membres de votre organisation {user.company}.
```
Pour effectuer un rendu conditionnel en fonction des données utilisateur, utilisez la variable `user` dans les composants JSX.
```jsx theme={null}
{
user.plan === 'enterprise'
? <>Contactez votre administrateur pour activer cette fonctionnalité.
: <>Consultez nos tarifs pour plus d'informations sur la mise à niveau.
}
```
La variable `user` est un objet vide pour les utilisateurs déconnectés. Utilisez l'opérateur d'enchaînement optionnel sur tous les champs de `user` pour éviter les erreurs. Par exemple, `{user.org?.plan}` au lieu de `{user.org.plan}`.
Pour lire le même objet utilisateur depuis un [fichier JavaScript personnalisé](/docs/fr/customize/custom-scripts#access-personalized-user-data), utilisez `window.mintlify.user` et écoutez l'événement `mintlify:user`.
## Visibilité des pages
Contrôlez les pages qui apparaissent dans la navigation selon les groupes d'utilisateurs en ajoutant `groups` au frontmatter de la page.
Avec la personnalisation, `groups` contrôle la visibilité mais ne restreint pas l'accès à une page. Un visiteur peut toujours ouvrir une page filtrée par groupe en accédant directement à son URL. Utilisez l'[authentification](/docs/fr/deploy/authentication-setup) pour restreindre l'accès aux contenus sensibles.
```mdx theme={null}
---
title: "Paramètres d'administration"
groups: ["admin"]
---
```
## Filtrage du contenu OpenAPI
Filtrez le contenu de la référence d'API en fonction des groupes d'utilisateurs à l'aide de l'extension `x-mint` dans votre spécification OpenAPI. Vous pouvez filtrer des points de terminaison entiers, des propriétés de schéma individuelles, des variantes `oneOf` et des valeurs d'énumération.
### Filtrer les endpoints
Ajoutez `x-mint.groups` à une opération ou à un chemin pour n'afficher l'endpoint dans la navigation qu'à certains groupes d'utilisateurs. Avec la personnalisation autonome, les utilisateurs qui ne font pas partie des groupes indiqués peuvent tout de même ouvrir la page de l'endpoint via son URL directe.
```json {6-8} Opération restreinte theme={null}
{
"paths": {
"/billing": {
"get": {
"summary": "Récupérer les détails de facturation",
"x-mint": {
"groups": ["admin", "billing"]
},
"responses": {
"200": {
"description": "Détails de facturation"
}
}
}
}
}
}
```
```json {3-5} Chemin restreint theme={null}
{
"paths": {
"x-mint": {
"groups": ["admin", "billing"]
},
"/billing": {
"get": {
"summary": "Récupérer les détails de facturation",
}
},
"/users": {
"get": {
"summary": "Récupérer les détails de l'utilisateur",
}
}
}
}
```
### Filtrer les propriétés du schéma
Ajoutez `x-mint.groups` aux propriétés individuelles des corps de requête, des paramètres ou des réponses. Les propriétés sans `x-mint.groups` restent visibles pour tous les utilisateurs.
```json {11-13} Restricted property theme={null}
{
"components": {
"schemas": {
"User": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"internal_id": {
"type": "string",
"x-mint": {
"groups": ["admin"]
}
}
}
}
}
}
}
```
Dans cet exemple, tous les utilisateurs peuvent voir la propriété `name`. Seuls les utilisateurs du groupe `admin` peuvent voir la propriété `internal_id`.
### Filtrer les variantes oneOf
Ajoutez `x-mint.groups` à chaque option `oneOf` pour restreindre les variantes de schéma qu'un utilisateur peut voir.
```json {7-9} Restricted oneOf variant theme={null}
{
"schema": {
"oneOf": [
{
"title": "Enterprise config",
"type": "object",
"x-mint": {
"groups": ["enterprise"]
},
"properties": {
"sso_enabled": { "type": "boolean" }
}
},
{
"title": "Standard config",
"type": "object",
"properties": {
"notifications": { "type": "boolean" }
}
}
]
}
}
```
### Filtrer les valeurs d'énumération
Utilisez l'extension `x-mint-enum` pour restreindre certaines valeurs d'énumération par groupe. Indiquez chaque valeur restreinte comme key, avec ses groups autorisés comme value. Les valeurs d'énumération qui ne sont pas répertoriées dans `x-mint-enum` sont visibles par tous les utilisateurs.
```json {4-7} Restricted enum values theme={null}
{
"type": "string",
"enum": ["free", "pro", "enterprise"],
"x-mint-enum": {
"pro": ["pro", "enterprise"],
"enterprise": ["enterprise"]
}
}
```
Dans cet exemple, tous les utilisateurs voient `free`. Les utilisateurs appartenant aux groupes `pro` ou `enterprise` voient `pro`. Seuls les utilisateurs du groupe `enterprise` voient `enterprise`.
`x-mint-enum` est une extension distincte au niveau supérieur de l'objet de schéma, et non imbriquée sous `x-mint`.
## Format des données utilisateur
Votre système d'identification ou d'authentification renvoie des données utilisateur qui contrôlent la personnalisation. Les champs `groups`, `content` et `apiPlaygroundInputs` décrits sur cette page font tous partie de l'objet de données utilisateur.
Pour le format complet des données utilisateur et la référence des champs, consultez la page [Format des données utilisateur](/docs/fr/deploy/authentication-setup#user-data-format).
## Comportement de déconnexion
La déconnexion s'effectue côté client. Lorsque les utilisateurs cliquent sur le bouton de déconnexion, Mintlify efface les données de session stockées dans le navigateur.
Pour limiter la durée de conservation des données de personnalisation, définissez le champ `expiresAt` dans vos données utilisateur.
## Related topics
- [Migrer depuis ReadMe](/docs/fr/migration/readme.md)
- [Portails développeur personnalisés](/docs/fr/deploy/custom-portal.md)
- [Créer des mises en page personnalisées](/docs/fr/guides/custom-layouts.md)