Configurer le périmètre d’authentification de l’API REST

Liez l’entité OAuth à un périmètre d’authentification pour gérer le jeton afin d’accéder aux API REST qui sont liées au périmètre d’authentification.

Avant de commencer

Installez les modules d'extension suivants :

• OAuth 2.0
• Fournisseur d’API REST
• Périmètre d’authentification
• Périmètre d'authentification REST API

Remarque :

Le REST API Auth Scope module d’extension est ajouté dans le cadre de la Tokyo version.

Rôle requis : api_service_admin, adaptive_auth_policy_admin

Procédure

1. Accédez à la Tous > Périmètres d’authentification API > Périmètre d'authentification REST API.
   La page Périmètres d’authentification REST API s’affiche.
2. Pour configurer un nouveau périmètre d’authentification REST API, cliquez sur Nouveau.
3. Remplissez les champs du formulaire.

   Tableau 1. Périmètre d'authentification REST API

   Nom	Nom unique qui identifie le périmètre d’authentification de l’API REST.
   Actives	Cochez la case pour activer la configuration.
   Application	Périmètre de l’application en lecture seule.
   API REST	API REST à laquelle le périmètre d’authentification est appliqué. Par exemple, l’API Table.
   Périmètre d’authentification	Sélectionnez le périmètre d’authentification à partir de l’icône de recherche.
   CHEMIN REST API	Chemin d’accès de l’API REST. Ce champ est rempli automatiquement en fonction de l’API REST sélectionnée. Par exemple, now/table.
   Méthode HTTP	Méthode utilisée pour interagir avec l’API. Sélectionnez la méthode dans la liste déroulante. Vous pouvez désactiver le champ Appliquer le périmètre d’authentification à toutes les méthodes HTTP de cette API du formulaire manuellement pour sélectionner la méthode.
   REST API Version	Version de l’API. Par exemple, v1. Ce champ est rempli automatiquement en fonction de l’API REST sélectionnée. Vous pouvez désactiver manuellement le champ Appliquer le périmètre d’authentification à toutes les versions dans ce champ d’API du formulaire pour sélectionner la version.
   Ressource	Ressource enfant de l’API REST. Ce champ est rempli automatiquement en fonction de l’API REST sélectionnée. Par exemple, /now/table. Vous pouvez désactiver manuellement le champ Appliquer le périmètre d’authentification à toutes les ressources de cette API du formulaire pour sélectionner les ressources.
   Appliquer le périmètre d’authentification à toutes les méthodes HTTP dans cette API.	Lorsque cette option est activée, elle applique le périmètre d’authentification à toutes les méthodes HTTP de l’API.
   Appliquer le périmètre d’authentification à toutes les versions dans cette API.	lorsque cette option est activée, applique le périmètre d’authentification à toutes les versions de l’API.
   Appliquer le périmètre d’authentification à toutes les ressources dans cette API.	Lorsqu’elle est activée, elle applique le périmètre d’authentification à toutes les ressources de l’API

4. Cliquez sur Envoyer.
   En fonction de l’API REST et du périmètre d’authentification sélectionnés, l’API récupère les informations spécifiques au périmètre.

Envisagez de créer trois périmètres d’authentification de l’API REST pour l’API de table

Le premier périmètre d’authentification est mappé à l’API de table avec toutes les méthodes, versions et ressources HTTP activées.

Le deuxième périmètre d’authentification est mappé à l’API de table avec toutes les versions et ressources activées. Mais vous choisissez la méthode HTTP, dans cet exemple, la méthode GET .

Le troisième périmètre d’authentification est mappé à l’API de table sans les méthodes, versions et ressources HTTP activées. Cependant, vous choisissez manuellement la méthode, la version et la ressource HTTP. Dans cet exemple, la méthode HTTP est GET, la version de l’API REST est la plus récente et la ressource est /now/table/{tableName}.

Si tous ces périmètres d’authentification sont créés, vous pouvez utiliser la méthode GET avec les trois périmètres, mais pour les méthodes POST,PUT, DELETE ou PATCH , seul le scope3 peut être utilisé.