> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Découvrez comment mettre à jour vos intégrations Auth0 pour gérer les connexions avec des scopes propres aux options.

# Migrer vers les scopes d’options des connexions de la Management API

​Auth0 introduit deux nouvelles [scopes](/docs/fr-ca/get-started/apis/scopes) de la Management API pour les options de connexion : `read:connections_options` et `update:connections_options`.

Nous déprécions également la possibilité d’accéder au champ `options` ou de le mettre à jour sans les scopes appropriées, ce qui entraîne les changements majeurs suivants :

* Les réponses des points de terminaison [Get All Connections](/docs/fr-ca/api/management/v2/connections/get-connections) et [Get Connection by Id](/docs/fr-ca/api/management/v2/connections/get-connections-by-id) n’incluent pas le champ `options`, à moins que l’appelant ait la scope `read:connections_options`.
* Les requêtes envoyées au point de terminaison [Update a Connection](/docs/fr-ca/api/management/v2/connections/patch-connections-by-id) échouent si le corps de la requête contient le champ `options` et que l’appelant n’a pas la scope `update:connections_options`. Les réponses réussies n’incluent pas le champ `options`, à moins que l’appelant ait la scope `read:connections_options`.

Pour continuer à utiliser le champ `options`, vous devez mettre à jour vos autorisations d’application afin d’inclure les nouvelles scopes. Suivez les étapes ci-dessous pour déterminer si votre tenant et vos intégrations sont touchés, migrer vers les scopes propres aux options, puis vous désabonner du comportement déprécié.

<div id="identify-affected-tenants">
  ## Identifier les tenants concernés
</div>

Utilisez Auth0 Dashboard pour vérifier si un tenant est autorisé à accéder aux options de connexion sans les nouveaux scopes et s’il nécessite une migration.

1. Accédez à [Auth0 Dashboard > Paramètres du tenant > Avancé](https://manage.auth0.com/dashboard/#/tenant/advanced).
2. Faites défiler jusqu’à la section **Migrations**.
3. Repérez la bascule **Allow Connections Management** without Options Scopes :
   A. Si la bascule est **activée**, votre tenant peut toujours accéder aux options de connexion sans les nouveaux scopes, et vous devez effectuer la migration avant la date limite.
   B. Si la bascule est absente ou **désactivée**, aucune autre action n’est nécessaire.

<div id="identify-affected-integrations">
  ## Identifier les intégrations touchées
</div>

Consultez les journaux `depnote` du tenant pour déterminer quelles applications et intégrations utilisent les points de terminaison concernés. L’exemple de requête suivant montre comment interroger les journaux `depnote` du tenant associés à cette dépréciation :

```
type:depnote AND description:Allow\ Connections\ Management\ without\ Options\ Scopes*
```

Pour en savoir plus, consultez [Syntaxe des requêtes de recherche dans les journaux](docs/deploy-monitor/logs/log-search-query-syntax).

Une fois que vous avez obtenu les résultats de la requête, examinez le champ `client_id` pour déterminer quelles applications pourraient être touchées. En raison de la nature des changements, la présence d’un avis de dépréciation pour une application cliente précise ne signifie pas nécessairement que l’application est touchée.

​Si le champ `client_id` est vide, cela signifie que la requête vers le point de terminaison touché provenait d’une extension. Plusieurs extensions Auth0 peuvent générer des journaux du tenant avec des avis de dépréciation qui sont en fait des faux positifs. Une fois les étapes propres aux extensions de la section Mettre à jour les extensions terminées, vous pouvez ignorer les avis de dépréciation dont l’identifiant client est vide.

<div id="update-application-grants">
  ## Mettre à jour les autorisations d’application
</div>

Pour les applications qui récupèrent ou mettent à jour le champ `options` à l’aide des points de terminaison concernés, mettez à jour leurs autorisations de la Management API afin d’inclure les scopes nécessaires.

1. Accédez à [Auth0 Dashboard > Applications > APIs](https://manage.auth0.com/dashboard/#/apis).
2. Sélectionnez l’**Auth0 Management API**, puis l’onglet **Machine to Machine Applications**.
3. À côté de l’application à mettre à jour, sélectionnez l’icône de flèche vers le bas pour déplier la section.
4. Dans la section **Permissions**, recherchez `“connections_options”`. Activez l’un ou l’autre des deux nouveaux scopes, ou les deux. Ensuite, choisissez **Update** pour enregistrer vos modifications.
   <Frame>
     <img src="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/update-connections-permissions.png?fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=43285257ee0fe487de85877010636fda" alt="Mettre à jour les permissions de la Management API" width="600" height="206" data-path="docs/images/cdy7uua7fh8z/update-connections-permissions.png" />
   </Frame>

<div id="update-extensions">
  ## Mettre à jour les extensions
</div>

Mettez à jour l’extension [Delegated Administration Dashboard](/docs/fr-ca/customize/extensions/delegated-administration-extension/install-delegated-admin-extension) vers la version la plus récente. Cette mise à jour est nécessaire, car l’extension doit avoir accès au champ des options de connexion pour fonctionner correctement. Si vous utilisez cette extension, assurez-vous de la mettre à jour pour qu’elle continue de fonctionner correctement.

<div id="opt-out-finalize-migration">
  ## Désactivation (finaliser la migration)
</div>

Une fois que vos intégrations ne dépendent plus du comportement obsolète, nous vous recommandons de configurer votre tenant pour refuser explicitement la gestion des connexions sans scopes d’options. Vous pourrez ainsi choisir exactement quand votre tenant adoptera le nouveau comportement, ce qui vous donnera davantage de contrôle sur votre processus de migration.

1. Accédez à [Auth0 Dashboard > Paramètres du tenant > Avancé](https://manage.auth0.com/dashboard/#/tenant/advanced).
2. Dans la section Migrations, désactivez la bascule **Allow Connections Management without Options Scopes**.

Si vous rencontrez des problèmes, vous pouvez réactiver temporairement cette même bascule pour rétablir le comportement précédent pendant que vous corrigez le problème.
