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à.
# ServiceNow integrazione
Utilizza l' ServiceNow integrazione per eseguire azioni all'interno delle ServiceNow istanze, inclusa la gestione di incidenti, problemi, richieste di modifica, articoli della knowledge base e allegati. Questa integrazione utilizza l'API REST. ServiceNow Per ulteriori informazioni, consulta l'[API REST](https://docs.servicenow.com/bundle/xanadu-api-reference/page/build/applications/concept/api-rest.html) nella ServiceNow documentazione.
La configurazione di questa integrazione prevede due passaggi. Innanzitutto, configuri un' OAuthapplicazione nella tua ServiceNow istanza. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua ServiceNow app. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).
## Prima di iniziare
Prima di configurare l'integrazione, verifica di disporre di quanto segue.
+ Un' ServiceNow istanza. Questa integrazione è convalidata rispetto alla versione Xanadu.
+ Un account ServiceNow utente con autorizzazioni per creare OAuth applicazioni (ruolo richiesto). `admin`
+ Per l'autenticazione del servizio (credenziali del client), l'istanza deve eseguire la versione di Washington DC o successiva.
+ Per i requisiti di abbonamento, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).
## Configurazione ServiceNow OAuth
Prima di configurare Amazon Quick, crea un endpoint OAuth applicativo nella tua ServiceNow istanza. Completa tutti i passaggi seguenti ServiceNow prima di passare alla console Amazon Quick.
Per ulteriori informazioni, consulta [Creare un endpoint per consentire ai client di accedere all'istanza](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) nella ServiceNow documentazione.
### Registra l'applicazione OAuth
Per registrare l' OAuth applicazione, completare i seguenti passaggi.
1. Nel vostro ServiceNow caso, accedete a **Tutto** > **Sistema OAuth** > **Registro delle applicazioni** e scegliete **Nuovo**.
1. Scegli **Crea un endpoint OAuth API per client esterni**.
1. Compila il modulo:
+ **Nome**: un nome descrittivo per l' OAuth applicazione.
+ **URL di reindirizzamento** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
Sostituisci *\$1region\$1* con la tua AWS regione (ad esempio,`us-east-1`).
1. Seleziona **Invia**.
1. Riapri la voce del registro dell'applicazione e scegli l'icona a forma di lucchetto accanto a **Client Secret** per visualizzare il valore.
1. Copia i valori **Client ID** e **Client Secret**. Ne hai bisogno quando configuri l'integrazione in Amazon Quick.
### Passaggi aggiuntivi per l'autenticazione del servizio (credenziali del client)
Se prevedi di utilizzare l'autenticazione del servizio, completa questi passaggi aggiuntivi dopo aver registrato l' OAuth applicazione. Il tipo di concessione delle credenziali client è stato introdotto nella versione di ServiceNow Washington DC. Per ulteriori informazioni, consulta [Up Your OAuth2 .0 Game: Inbound Client Credentials with Washington DC](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891) in the Community. ServiceNow
1. Abilita il tipo di concessione delle credenziali del client. Passate all'`sys_properties.list`utilizzo del navigatore di filtri e create una nuova proprietà di sistema con i seguenti valori:
+ **Nome**: `glide.oauth.inbound.client.credential.grant_type.enabled`
+ **Tipo**: `true | false`
+ **Valore**: `true`
1. Verificate che i seguenti plugin siano installati (accedete a **Admin** > **Application Manager**):
+ OAuth 2.0 () `com.snc.platform.security.oauth`
+ Provider di API REST (`com.glide.rest`)
+ Ambito di autenticazione (`com.glide.auth.scope`)
+ Plugin per l'autenticazione dell'API REST () `com.glide.rest.auth.scope`
1. Tornate alla vostra OAuth applicazione in **Sistema OAuth** > **Registro delle applicazioni**. Aggiungi il campo **Utente dell'OAuth applicazione** al modulo se non è visibile (usa **Configure** > **Form Builder** per aggiungerlo).
1. Imposta l'**utente dell'OAuth applicazione** su un utente con le autorizzazioni appropriate, ad esempio un utente con il ruolo di amministratore di sistema.
**Importante**
Con l'autenticazione del servizio, tutte le azioni vengono eseguite come utente dell'applicazione configurato OAuth . Qualsiasi utente Amazon Quick con accesso a questa integrazione può eseguire azioni utilizzando le autorizzazioni dell'account. Configura le autorizzazioni dell'account in modo che soddisfino i requisiti di sicurezza della tua organizzazione.
## Configura l'integrazione in Amazon Quick
Dopo aver completato la ServiceNow OAuth configurazione, crea l'integrazione in Amazon Quick.
1. Nella console Amazon Quick, scegli **Integrazioni.**
1. Scegli **ServiceNow**e scegli il pulsante Aggiungi (più «\$1»).
1. Inserisci i dettagli dell'integrazione:
+ **Nome: nome** descrittivo per l' ServiceNow integrazione.
+ **Descrizione** (facoltativa): scopo dell'integrazione.
1. Scegli il tipo di connessione e compila le impostazioni di connessione:
1. Per **l'autenticazione utente (OAuth)**, configura i seguenti campi:
+ **URL di base**: `https://{your-instance}.service-now.com`
+ **ID cliente**: ID cliente ServiceNow OAuth dell'applicazione.
+ **Client Secret**: segreto del client ServiceNow OAuth dell'applicazione.
+ **URL del token**: `https://{your-instance}.service-now.com/oauth_token.do`
+ **URL di autenticazione** — `https://{your-instance}.service-now.com/oauth_auth.do`
+ **URL di reindirizzamento** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Per **l'autenticazione del servizio (credenziali del client)**, configura i seguenti campi:
+ **Tipo di autenticazione:** Service-to-service OAuth
+ **URL di base** — `https://{your-instance}.service-now.com`
+ **ID cliente**: ID cliente ServiceNow OAuth dell'applicazione.
+ **Client Secret**: segreto del client ServiceNow OAuth dell'applicazione.
+ **URL del token**: `https://{your-instance}.service-now.com/oauth_token.do`
1. Scegli **Crea e continua**.
1. Scegli gli utenti con cui condividere l'integrazione.
1. Scegli **Next (Successivo)**.
Per l'autenticazione degli utenti, vai su **Integrazioni** > **Azioni** > il nome ServiceNow dell'integrazione e scegli **Accedi** per completare il flusso di OAuth autorizzazione.
## Operazioni disponibili
Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.
**ServiceNow azioni disponibili**
| Categoria | Azione | Description |
| --- | --- | --- |
| Incidenti | Elenca incidenti | Recupera gli incidenti esistenti. |
| Incidenti | Crea incidente | Crea un record di incidente per documentare una deviazione dallo standard operativo previsto. |
| Incidenti | Visualizza incidente | Recupera i dettagli di un incidente specifico. |
| Incidenti | Aggiorna incidente | Aggiorna il record di un incidente. |
| Incidenti | Elimina incidente | Eliminare un incidente. |
| Problemi | Elenca i problemi | Recupera i problemi esistenti. |
| Problemi | Crea problema | Crea un nuovo record di problema. |
| Problemi | Visualizza problema | Recupera i dettagli di un record di problema specifico. |
| Problemi | Problema di aggiornamento | Aggiorna il record di un problema. |
| Problemi | Elimina problema | Eliminare un problema. |
| Richieste di modifica | Elenca le richieste di modifica | Recupera tutte le richieste di modifica. |
| Richieste di modifica | Crea richiesta di modifica | Crea una richiesta di modifica per implementare un processo controllato per la modifica degli elementi di configurazione approvati e supportati (CIs). |
| Richieste di modifica | Visualizza richiesta di modifica | Recupera informazioni dettagliate su una richiesta di modifica specifica. |
| Richieste di modifica | Richiesta di modifica di aggiornamento | Modifica una richiesta di modifica. |
| Richieste di modifica | Elimina richiesta di modifica | Eliminare una richiesta di modifica. |
| Articoli della Knowledge Base | Crea un articolo della Knowledge Base | Crea un articolo della Knowledge Base. Richiede il plugin Knowledge API (sn\$1km\$1api). |
| Articoli della Knowledge Base | Aggiornamento dell'articolo della Knowledge Base | Modificare un articolo della Knowledge Base. |
| Articoli della Knowledge Base | Elimina l'articolo della Knowledge Base | Eliminare un articolo della Knowledge Base. |
| Allegati | Recupera i metadati degli allegati | Recupera i metadati per i file allegati. |
| Allegati | Recupera i metadati degli allegati | Recupera i metadati per un file allegato specifico. |
| Allegati | Recupera il contenuto degli allegati | Recupera il contenuto del file allegato binario. |
| Allegati | Carica allegato binario | Carica un file binario come allegato a un record specificato. |
| Allegati | Carica un allegato al modulo composto da più parti | Carica un file allegato composto da più parti. |
| Allegati | Elimina allegato | Eliminare un allegato. |
| Utenti | Creazione di elenchi sugli utenti | Elenca tutti i record degli utenti. |
| Sistema | Elenca le scelte | Recupera i valori dell'elenco di scelta dalla tabella sys\$1choice. |
**Nota**
Le azioni specifiche disponibili dipendono dalle autorizzazioni configurate nell' ServiceNow istanza e dal metodo di autenticazione utilizzato.
## Limitazioni
Questa integrazione interagisce ServiceNow tramite l'API REST, che non applica le politiche dell'interfaccia utente, le azioni dell'interfaccia utente o gli script client. Queste regole si applicano solo nell'interfaccia del ServiceNow browser. Vengono applicate le regole aziendali e le policy relative ai dati sul lato server. ACLs Per ulteriori informazioni, consulta l'[API REST nella documentazione](https://docs.servicenow.com/bundle/xanadu-api-reference/page/integrate/inbound-rest/concept/c_RESTAPI.html). ServiceNow
## Gestisci e risolvi i problemi
Per modificare, condividere o eliminare la tua integrazione, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations)
### Problemi di autenticazione
+ **OAuth l'autorizzazione non riesce**: verifica che Client ID e Client Secret corrispondano ai valori nel registro ServiceNow delle applicazioni. Verifica che l'URL di reindirizzamento ServiceNow corrisponda esattamente all'URL nella configurazione di Amazon Quick.
+ **L'autenticazione del servizio non riesce**: verifica che la proprietà `glide.oauth.inbound.client.credential.grant_type.enabled` di sistema sia impostata su. `true` Conferma che il campo **Utente dell'OAuth applicazione** sia compilato nel record del registro dell'applicazione.
### Messaggi di errore comuni
+ **Le azioni restituiscono errori di autorizzazione**: verifica che l' ServiceNow utente o OAuth l'utente dell'applicazione disponga dei ruoli richiesti per accedere alle tabelle di destinazione (ad esempio, `itil` ruolo per la gestione degli incidenti).
+ **Timeout di connessione o istanza non raggiungibile**: verifica che l'URL di base utilizzi il nome dell'istanza corretto ServiceNow . Verifica che l' ServiceNow istanza sia accessibile e non sia in modalità di manutenzione.