View a markdown version of this page

ServiceNow integrazione - Amazon Quick
Prima di iniziareConfigurare ServiceNow OAuthConfigura l'integrazione in Amazon QuickOperazioni disponibiliLimitazioniGestisci e risolvi i problemi

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 nella ServiceNow documentazione.

La configurazione di questa integrazione prevede due passaggi. Innanzitutto, configuri un'applicazione OAuth 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, consultaMetodi di autenticazione.

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 applicazioni OAuth (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, consultaConfigura le integrazioni nella console.

Configurare ServiceNow OAuth

Prima di configurare Amazon Quick, crea un endpoint dell'applicazione OAuth nella tua istanza. ServiceNow 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 nella ServiceNow documentazione.

Registra l'applicazione OAuth

Per registrare l'applicazione OAuth, completare i seguenti passaggi.

  1. Nel tuo ServiceNow caso, vai su Tutti > Sistema OAuth > Registro delle applicazioni e scegli Nuovo.

  2. Scegli Crea un endpoint API OAuth per client esterni.

  3. Compila il modulo:

    • Nome: un nome descrittivo per l'applicazione OAuth.

    • URL di reindirizzamento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      Sostituisci {region} con la tua AWS regione (ad esempio,us-east-1).

  4. Seleziona Invia.

  5. Riapri la voce del registro dell'applicazione e scegli l'icona a forma di lucchetto accanto a Client Secret per visualizzare il valore.

  6. 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'applicazione OAuth. Il tipo di concessione delle credenziali del client è stato introdotto nella versione di Washington DC. ServiceNow Per ulteriori informazioni, consulta Up Your OAuth2.0 Game: Inbound Client Credentials with Washington DC in the Community. ServiceNow

  1. Abilita il tipo di concessione delle credenziali del client. Passate all'sys_properties.listutilizzo 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

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

  3. Tornate alla vostra applicazione OAuth in System OAuth > Application Registry. Aggiungi il campo Utente dell'applicazione OAuth al modulo se non è visibile (usa Configure > Form Builder per aggiungerlo).

  4. Imposta l'utente dell'applicazione OAuth su un utente con 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 OAuth configurata. 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 configurazione ServiceNow OAuth, crea l'integrazione in Amazon Quick.

  1. Nella console Amazon Quick, scegli Connettori.

  2. Scegli la scheda Crea per il tuo team.

  3. Trova e scegli ServiceNow.

  4. Inserisci i dettagli dell'integrazione:

    • Nome: nome descrittivo per l' ServiceNow integrazione.

    • Descrizione (facoltativa): scopo dell'integrazione.

  5. 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 client dell'applicazione ServiceNow OAuth.

      • Client Secret: segreto del client dell'applicazione ServiceNow OAuth.

      • 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

    2. 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 client dell'applicazione ServiceNow OAuth.

      • Client Secret: segreto del client dell'applicazione ServiceNow OAuth.

      • URL del token: https://{your-instance}.service-now.com/oauth_token.do

  6. Scegli Crea e continua.

  7. Scegli gli utenti con cui condividere l'integrazione.

  8. Scegli Next (Successivo).

Per l'autenticazione dell'utente, vai su Connettori > nome del ServiceNow connettore e scegli Accedi per completare il flusso di autorizzazione OAuth.

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 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 (CI) approvati e supportati.
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_km_api).
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_choice.
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. Server-side vengono applicate le regole aziendali, gli ACL e le politiche relative ai dati. Per ulteriori informazioni, consulta l'API REST nella ServiceNow documentazione.

Gestisci e risolvi i problemi

Per modificare, condividere o eliminare la tua integrazione, consulta. Gestione delle integrazioni esistenti

Problemi di autenticazione

  • L'autorizzazione OAuth non riesce: verifica che Client ID e Client Secret corrispondano ai valori nel registro delle ServiceNow 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'applicazione OAuth sia compilato nel record del registro dell'applicazione.

Messaggi di errore comuni

  • Le azioni restituiscono errori di autorizzazione: verifica che l' ServiceNow utente o l'utente dell'applicazione OAuth disponga dei ruoli necessari 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.