View a markdown version of this page

Configurare l'autenticazione delle credenziali client OAuth 2.0 per ServiceNow - Amazon Bedrock
Passaggio 1: abilita il tipo di concessione delle credenziali del clienteFase 2: Creare un account di servizio dedicatoFase 3: Assegnazione dei ruoli degli account di servizioFase 4: Registrare l'applicazione OAuthFase 5: Configurare l'applicazione OAuthFase 6: Configurazione delle politiche di accesso alle APIPassaggio 7: verifica il flusso OAuthFase 8: Creare il segreto di Secrets ManagerFasi successive

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurare l'autenticazione delle credenziali client OAuth 2.0 per ServiceNow

Utilizza l'API ServiceNow Table con credenziali client OAuth 2.0 (2LO) per l'autenticazione. Completa tutti i passaggi seguenti nella tua ServiceNow istanza prima di configurare l'origine dati in Amazon Bedrock.

Passaggio 1: abilita il tipo di concessione delle credenziali del cliente

  1. In ServiceNow, vai a sys_properties.list utilizzare il navigatore dei filtri.

  2. Crea una nuova proprietà di sistema con i seguenti valori:

    • Nome: glide.oauth.inbound.client.credential.grant_type.enabled

    • Tipo: true | false

    • Valore: true

Fase 2: Creare un account di servizio dedicato

  1. Vai a Amministrazione utenti > Utenti.

  2. Scegli Nuovo e completa il modulo:

    • ID utente: un nome descrittivo (ad esempio,svc.amazon.quick.kb).

    • Solo accesso al servizio Web: selezionato. Ciò impedisce l'accesso interattivo.

    • Password: imposta una password complessa. Il connettore utilizza OAuth, ma è richiesta una password per la creazione dell'account.

  3. Seleziona Invia.

Fase 3: Assegnazione dei ruoli degli account di servizio

  1. Apri l'account di servizio (Amministrazione utente > Utenti > il tuo account di servizio).

  2. Nella scheda Ruoli, scegli Modifica e aggiungi i seguenti ruoli:

    • knowledge_admin— Accesso completo in lettura a tutti gli articoli della knowledge base. Bypassa le restrizioni relative ai criteri utente per KB.

    • catalog_admin— Accesso completo in lettura a tutti gli elementi del catalogo dei servizi. Bypassa le restrizioni per catalogo.

  3. Selezionare Salva.

Nota

Dopo il salvataggio, vengono visualizzati circa 14 ruoli in totale. ServiceNoweredita automaticamente i ruoli contenuti dai ruoli _admin principali. È possibile assegnare solo manualmente i due ruoli elencati nei passaggi 2 (knowledge_adminecatalog_admin). Non assegnare i snc_read_only ruoli adminitil,, o.

Fase 4: Registrare l'applicazione OAuth

  1. Accedere a System OAuth > Application Registry.

  2. Scegliete Nuovo > Crea un endpoint API OAuth per client esterni.

  3. Compila il modulo:

    • Nome: un nome descrittivo (ad esempio,Amazon-Quick-KB-Client).

    • URL di reindirizzamento: lascia vuoto. Non richiesto per il flusso delle credenziali del cliente.

  4. Seleziona Invia.

  5. Copia immediatamente l'ID cliente e il segreto del cliente. Il Client Secret viene mostrato una sola volta.

Importante

È necessario utilizzare la pagina di intercettazione per creare l'applicazione. Non create il record inserendolo direttamente nella tabella. oauth_entity

Fase 5: Configurare l'applicazione OAuth

  1. Re-open il record dell'applicazione dall'elenco del registro delle applicazioni.

  2. Se il campo Utente dell'applicazione OAuth non è visibile, aggiungilo utilizzando Configure > Form Builder.

  3. Imposta i seguenti campi:

    • Utente dell'applicazione OAuth: il tuo account di servizio (ad esempio,svc.amazon.quick.kb).

    • Restrizione dell'ambito —. Broadly scoped

    • Tipo di cliente —integration_as_a_service.

  4. Scegliere Aggiorna.

Fase 6: Configurazione delle politiche di accesso alle API

Senza politiche di accesso alle API, i token si autenticano ma l'API Table restituisce HTTP 401. Completa entrambi i passaggi secondari riportati di seguito.

Crea il profilo di autenticazione in entrata

  1. Accedere a Servizi Web di sistema > Criteri di accesso alle API > Profilo di autenticazione in entrata.

  2. Scegli Nuovo e imposta:

    • Nome: ad esempio,Amazon-Quick-KB-Client-Profile.

    • Tipo – OAuth.

    • Entità OAuth: seleziona la tua applicazione OAuth.

  3. Seleziona Invia.

  4. Re-open il profilo. Nell'elenco relativo alle politiche di autenticazione, scegli Modifica e aggiungi la politica di autorizzazione all'accesso. Selezionare Salva.

Crea la politica di accesso all'API REST

  1. Accedere a Servizi Web di sistema > Criteri di accesso alle API > Politiche di accesso alle API REST.

  2. Scegli Nuovo e imposta:

    • Nome: ad esempio,Table API Oauth access policy.

    • API REST —Table API.

    • Percorso API REST —now/table.

    • Applica a tutti i metodi: selezionato.

    • Applica a tutte le risorse: selezionata.

    • Applica a tutte le tabelle: selezionata.

    • Applica a tutte le versioni: selezionata.

  3. Seleziona Invia.

  4. Re-open la politica. Nell'elenco relativo ai profili di autenticazione in entrata, scegli Modifica e aggiungi il tuo profilo di autenticazione in entrata. Selezionare Salva.

Passaggio 7: verifica il flusso OAuth

Prima di configurare l'origine dati, verifica che il flusso OAuth funzioni end-to-end.

Richiedi un token: 

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"

Verifica l'accesso all'API della tabella: 

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

La tabella seguente descrive ogni risultato della verifica e le azioni da intraprendere.

Risultati della verifica
Risultato Significato Azione
HTTP 200 con dati Funziona correttamente Procedi con la creazione del segreto di Secrets Manager.
HTTP 200 con array vuoto knowledge_adminRuolo mancante Assegna il knowledge_admin ruolo all'account del servizio.
HTTP 401 Politica di accesso alle API non configurata Verifica sia il profilo di autenticazione in entrata che la configurazione della politica di accesso all'API REST.

Fase 8: Creare il segreto di Secrets Manager

Archivia le credenziali in un AWS Secrets Manager segreto nella Regione AWS stessa della tua knowledge base con le seguenti coppie chiave-valore:

{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "instanceUrl": "https://YOUR_INSTANCE.service-now.com"
}
Campi segreti
Campo Description
clientId L'ID dell'App Client del passaggio 4.
clientSecret Il segreto dell'App Client rivelato al momento della creazione nel passaggio 4.
instanceUrl URL completo dell' ServiceNow istanza (includehttps://, senza barra finale).
Importante

Non instanceUrl deve avere una barra finale.

Crea il segreto con: AWS Command Line Interface

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

Registra l'ARN segreto della risposta. Lo usi come fonte secretArn di dati.

Fasi successive

Dopo aver archiviato il segreto, crea l'origine dati. Consulta Connetti una fonte di ServiceNow dati.