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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • 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.

    Périmètre d’authentification REST API 3

    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 .

    Périmètre d’authentification REST API 2

    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}.

    Périmètre d’authentification REST API 1

    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é.