View a markdown version of this page

Configurer l'authentification des informations d'identification du client OAuth 2.0 pour ServiceNow - Amazon Bedrock
Étape 1 : activer le type d'autorisation des informations d'identification du clientÉtape 2 : créer un compte de service dédiéÉtape 3 : Attribuer des rôles aux comptes de serviceÉtape 4 : enregistrer l'application OAuthÉtape 5 : Configuration de l'application OAuthÉtape 6 : Configuration des politiques d'accès aux APIÉtape 7 : Vérifiez le flux OAuthÉtape 8 : Création du secret du gestionnaire de secretsÉtapes suivantes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer l'authentification des informations d'identification du client OAuth 2.0 pour ServiceNow

Utilisez l'API ServiceNow Table avec les informations d'identification du client OAuth 2.0 (2LO) pour l'authentification. Effectuez toutes les étapes suivantes dans votre ServiceNow instance avant de configurer la source de données dans Amazon Bedrock.

Étape 1 : activer le type d'autorisation des informations d'identification du client

  1. Dans ServiceNow, accédez à sys_properties.list l'utilisation du navigateur de filtres.

  2. Créez une nouvelle propriété système avec les valeurs suivantes :

    • Nom – glide.oauth.inbound.client.credential.grant_type.enabled

    • Type – true | false

    • Valeur : true

Étape 2 : créer un compte de service dédié

  1. Accédez à Administration des utilisateurs > Utilisateurs.

  2. Choisissez Nouveau et complétez le formulaire :

    • ID utilisateur  : nom descriptif (par exemple,svc.amazon.quick.kb).

    • Accès au service Web uniquement — Coché. Cela empêche la connexion interactive.

    • Mot de passe  : définissez un mot de passe sécurisé. Le connecteur utilise OAuth, mais un mot de passe est requis pour la création du compte.

  3. Sélectionnez Soumettre.

Étape 3 : Attribuer des rôles aux comptes de service

  1. Ouvrez le compte de service (Administration des utilisateurs > Utilisateurs > votre compte de service).

  2. Dans l'onglet Rôles, choisissez Modifier et ajoutez les rôles suivants :

    • knowledge_admin— Accès complet en lecture à tous les articles de la base de connaissances. Contourne les restrictions relatives aux critères utilisateur par Ko.

    • catalog_admin— Accès complet en lecture à tous les articles du catalogue de services. Contourne les restrictions par catalogue.

  3. Choisissez Enregistrer.

Note

Après avoir enregistré, vous pouvez voir environ 14 rôles au total. ServiceNowhérite automatiquement des rôles contenus des rôles _admin parents. Vous n'attribuez que manuellement les deux rôles répertoriés à l'étape 2 (knowledge_adminetcatalog_admin). N'attribuez pas les snc_read_only rôles adminitil, ou.

Étape 4 : enregistrer l'application OAuth

  1. Accédez à System OAuth > Registre des applications.

  2. Choisissez Nouveau > Créer un point de terminaison d'API OAuth pour les clients externes.

  3. Complétez le formulaire :

    • Nom  : nom descriptif (par exemple,Amazon-Quick-KB-Client).

    • URL de redirection — Laissez ce champ vide. Non requis pour le flux des informations d'identification des clients.

  4. Sélectionnez Soumettre.

  5. Copiez immédiatement l'ID client et le secret client. Le secret client n'est affiché qu'une seule fois.

Important

Vous devez utiliser la page de l'intercepteur pour créer l'application. Ne créez pas l'enregistrement en l'insérant directement dans le oauth_entity tableau.

Étape 5 : Configuration de l'application OAuth

  1. Re-open l'enregistrement de la demande figurant dans la liste du registre des applications.

  2. Si le champ Utilisateur de l'application OAuth n'est pas visible, ajoutez-le à l'aide de Configurer > Générateur de formulaires.

  3. Définissez les champs suivants :

    • Utilisateur de l'application OAuth  : votre compte de service (par exemple,svc.amazon.quick.kb).

    • Restriction de portée —Broadly scoped.

    • Type de client —integration_as_a_service.

  4. Choisissez Mettre à jour.

Étape 6 : Configuration des politiques d'accès aux API

Sans politiques d'accès à l'API, les jetons s'authentifient mais l'API Table renvoie HTTP 401. Effectuez les deux sous-étapes ci-dessous.

Création du profil d'authentification entrant

  1. Accédez à System Web Services > Politiques d'accès aux API > Profil d'authentification entrant.

  2. Choisissez Nouveau et définissez :

    • Nom — Par exemple,Amazon-Quick-KB-Client-Profile.

    • Tapez —OAuth.

    • Entité OAuth  : sélectionnez votre application OAuth.

  3. Sélectionnez Soumettre.

  4. Re-open le profil. Dans la liste associée Politiques d'authentification, choisissez Modifier et ajoutez Autoriser la politique d'accès. Choisissez Enregistrer.

Création de la politique d'accès à l'API REST

  1. Accédez à System Web Services > Politiques d'accès aux API > Politiques d'accès à l'API REST.

  2. Choisissez Nouveau et définissez :

    • Nom — Par exemple,Table API Oauth access policy.

    • API REST —Table API.

    • Chemin de l'API REST —now/table.

    • Appliquer à toutes les méthodes — Coché.

    • Appliquer à toutes les ressources — Coché.

    • Appliquer à tous les tableaux — Coché.

    • Appliquer à toutes les versions — Coché.

  3. Sélectionnez Soumettre.

  4. Re-open la politique. Dans la liste associée aux profils d'authentification entrants, choisissez Modifier et ajoutez votre profil d'authentification entrant. Choisissez Enregistrer.

Étape 7 : Vérifiez le flux OAuth

Avant de configurer la source de données, vérifiez que le flux OAuth fonctionne de bout en bout.

Demandez un jeton : 

curl -s -X POST "https://INSTANCE.service-now.com/oauth_token.do" \
  -d "grant_type=client_credentials" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET"

Vérifiez l'accès à l'API Table : 

curl -s "https://INSTANCE.service-now.com/api/now/table/kb_knowledge?sysparm_limit=1" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Le tableau suivant décrit chaque résultat de vérification et les mesures à prendre.

Résultats de vérification
Résultat Signification Action
HTTP 200 avec données Fonctionnant correctement Procédez à la création du secret Secrets Manager.
HTTP 200 avec tableau vide knowledge_adminRôle manquant Attribuez le knowledge_admin rôle au compte de service.
HTTP 401 Politique d'accès à l'API non configurée Vérifiez à la fois le profil d'authentification entrant et la configuration de la politique d'accès à l'API REST.

Étape 8 : Création du secret du gestionnaire de secrets

Stockez les informations d'identification de manière AWS Secrets Manager secrète, Région AWS comme dans votre base de connaissances, à l'aide des paires clé-valeur suivantes :

{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "instanceUrl": "https://YOUR_INSTANCE.service-now.com"
}
Champs secrets
Champ Description
clientId L'ID du client de l'application de l'étape 4.
clientSecret Le secret du client de l'application révélé lors de la création à l'étape 4.
instanceUrl URL complète de l' ServiceNow instance (inclurehttps://, sans barre oblique de fin).
Important

instanceUrlIl ne doit pas y avoir de barre oblique à la fin.

Créez le secret à l'aide de AWS Command Line Interface :

aws secretsmanager create-secret \
  --name bedrock-servicenow-creds \
  --secret-string file://secret.json

Enregistrez l'ARN secret de la réponse. Vous l'utilisez comme source de donnéessecretArn.

Étapes suivantes

Après avoir enregistré le secret, créez la source de données. Consultez Connecter une source ServiceNow de données.