ServiceNow integrazione - Amazon Quick

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' 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, 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 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, consultaConfigura le integrazioni nella console.

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

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

  3. Compila il modulo:

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

    • URL di reindirizzamentohttps://{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' 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 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 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).

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

  2. Scegli ServiceNowe scegli il pulsante Aggiungi (più «+»).

  3. Inserisci i dettagli dell'integrazione:

    • Nome: nome descrittivo per l' ServiceNow integrazione.

    • Descrizione (facoltativa): scopo dell'integrazione.

  4. 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 autenticazionehttps://{your-instance}.service-now.com/oauth_auth.do

      • URL di reindirizzamentohttps://{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 basehttps://{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

  5. Scegli Crea e continua.

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

  7. 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_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. Vengono applicate le regole aziendali e le policy relative ai dati sul lato server. ACLs Per ulteriori informazioni, consulta l'API REST nella documentazione. ServiceNow

Gestisci e risolvi i problemi

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

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.