ServiceNow connettore V1.0

ServiceNow fornisce un sistema di gestione dei servizi basato sul cloud per creare e gestire flussi di lavoro a livello di organizzazione, come servizi IT, sistemi di ticketing e supporto. È possibile utilizzarlo Amazon Kendra per indicizzare i ServiceNow cataloghi, gli articoli informativi e i relativi allegati.

Nota

Il supporto per il ServiceNow connettore ServiceNowConfiguration V1.0/API dovrebbe terminare nel 2023. Ti consigliamo di eseguire la migrazione o l'utilizzo del ServiceNow connettore V2.0/API. TemplateConfiguration

Per la risoluzione dei problemi relativi al connettore di origine Amazon Kendra ServiceNow dati, consulta. Risoluzione dei problemi relativi alle origini dati

Funzionalità supportate

Amazon Kendra ServiceNow il connettore di origine dati supporta le seguenti funzionalità:

• ServiceNow versioni di istanza: London, Others

• Modelli di inclusione/esclusione: cataloghi di servizi, articoli conoscitivi e relativi allegati

Prerequisiti

Prima di utilizzarla Amazon Kendra per indicizzare la tua fonte di ServiceNow dati, apporta queste modifiche al tuo account e ai tuoi account. ServiceNow AWS

Nel ServiceNow, assicurati di avere:

• Hai creato un account ServiceNow amministratore e hai creato un' ServiceNowistanza.

• Hai copiato l'host dell'URL dell' ServiceNow istanza. Ad esempio, se l'URL dell'istanza è https://your-domain.service-now.com, il formato per l'URL dell'host che inserisci è your-domain.service-now.com.

• Hai annotato le tue credenziali di autenticazione di base contenenti un nome utente e una password per consentire la connessione all'istanza. Amazon Kendra ServiceNow

  Nota

  Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

• Facoltativo: ha configurato un token di credenziali OAuth 2.0 in grado di identificare Amazon Kendra e generare un nome utente, una password, un ID client e un segreto client. Il nome utente e la password devono consentire l'accesso alla ServiceNow knowledge base e al catalogo dei servizi. Per ulteriori informazioni, ServiceNow consulta la documentazione sull'autenticazione OAuth 2.0.

• Sono state aggiunte le seguenti autorizzazioni:

  • kb_category

  • kb_conoscenza

  • kb_knowledgebase

  • kb_uc_cannot_read_mtom

  • kb_uc_can_read_mtom

  • sc_catalogo

  • sc_category

  • sc_cat_item

  • sys_attachment

  • sys_attachment_doc

  • sys_user_role

• È stato selezionato che ogni documento sia unico all'interno ServiceNow e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni fonte di dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. Gli ID dei documenti sono globali rispetto a un indice e devono essere univoci per indice.

Nel tuo Account AWS, assicurati di avere:

• Ha creato un Amazon Kendra indice e, se si utilizza l'API, ha annotato l'ID dell'indice.

• Hai creato un IAM ruolo per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.

  Nota

  Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.

• Ha archiviato le credenziali di ServiceNow autenticazione in un AWS Secrets Manager segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.

  Nota

  Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un Secrets Manager segreto quando connetti la tua origine ServiceNow dati a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.

Istruzioni di connessione

Per connetterti Amazon Kendra alla tua fonte di ServiceNow dati, devi fornire i dettagli necessari della tua origine ServiceNow dati in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato ServiceNow Amazon Kendra SeePrerequisiti.

Console

Per connettersi Amazon Kendra a ServiceNow

1. Accedi alla console di AWS gestione e apri la Amazon Kendra console.

2. Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.

   Nota

   Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.

3. Nella pagina Guida introduttiva, scegli Aggiungi origine dati.

4. Nella pagina Aggiungi origine dati, scegli il ServiceNowconnettore V1.0, quindi scegli Aggiungi origine dati.

5. Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:

   1. In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.

   2. (Facoltativo) Descrizione: immetti una descrizione facoltativa per l'origine dati.

   3. In Lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.

   4. In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS

   5. Seleziona Successivo.

6. Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:

   1. ServiceNow host: immetti l'URL dell' ServiceNowhost.

   2. ServiceNow versione: seleziona la tua ServiceNow versione.

   3. Scegli tra l'autenticazione di base e l'autenticazione Oauth 2.0 in base al tuo caso d'uso.

   4. AWS Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo per memorizzare le Secrets Manager ServiceNow credenziali di autenticazione. Se scegli di creare un nuovo segreto, si apre una finestra AWS Secrets Manager segreta.

      1. Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra- ServiceNow -' viene aggiunto automaticamente al nome segreto.

      2. Se utilizzi l'autenticazione di base, inserisci il nome segreto, il nome utente e la password per il tuo account. ServiceNow

         Se utilizzi l'autenticazione OAuth2, inserisci il nome segreto, il nome utente, la password, l'ID cliente e il segreto del cliente che hai creato nel tuo account. ServiceNow

      3. Scegli Salva e aggiungi segreto.

   5. IAM ruolo: scegli un IAM ruolo esistente o crea un nuovo IAM ruolo per accedere alle credenziali del repository e indicizzare il contenuto.

      Nota

      IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli Crea un nuovo ruolo per evitare errori.

   6. Seleziona Successivo.

7. Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:

   1. Includi articoli informativi: scegli di indicizzare gli articoli della conoscenza.

   2. Tipo di articoli informativi: scegli tra Includi solo articoli pubblici e Includi articoli in base a una query di ServiceNow filtro in base al tuo caso d'uso. Se selezioni Includi articoli in base alla query di ServiceNow filtro, devi inserire una query di filtro copiata dal tuo ServiceNow account.

   3. Includi gli allegati degli articoli informativi: scegli di indicizzare gli allegati degli articoli informativi. Puoi anche selezionare tipi di file specifici da indicizzare.

   4. Includi elementi del catalogo: scegli di indicizzare gli articoli del catalogo.

   5. Includi gli allegati degli articoli del catalogo: scegli di indicizzare gli allegati degli articoli del catalogo. Puoi anche selezionare tipi di file specifici da indicizzare.

   6. Frequenza: con quale frequenza Amazon Kendra verrà eseguita la sincronizzazione con la fonte di dati.

   7. Seleziona Successivo.

8. Nella pagina Imposta le mappature dei campi, inserisci le seguenti informazioni:

   1. Articoli informativi e Catalogo dei servizi: seleziona tra i campi delle origini dati predefiniti Amazon Kendra generati e le mappature di campo aggiuntive suggerite che desideri mappare all'indice.

   2. Aggiungi campo: consente di aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.

   3. Seleziona Successivo.

9. Nella pagina Rivedi e crea, verifica che le informazioni inserite siano corrette, quindi seleziona Aggiungi origine dati. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina Origini dati dopo che l'origine dati sarà stata aggiunta correttamente.

API

Per connettersi Amazon Kendra a ServiceNow

È necessario specificare quanto segue utilizzando l'ServiceNowConfiguration API:

• URL dell'origine dati: specificare l' ServiceNow URL. L'endpoint host dovrebbe avere il seguente aspetto: your-domain.service-now.com.

• Istanza host di origine dati: specifica la versione dell'istanza host come o. ServiceNow LONDON OTHERS

• Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione che hai creato nel tuo account. ServiceNow

  Se utilizzi l'autenticazione di base, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

  {
      "username": "user name",
      "password": "password"
  }

  Se utilizzi l'autenticazione OAuth2, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

  {
      "username": "user name",
      "password": "password",
      "clientId": "client id",
      "clientSecret": "client secret"
  }

• IAM ruolo: specifica RoleArn quando chiami CreateDataSource per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e per chiamare le API pubbliche richieste per il connettore e. ServiceNow Amazon Kendra Per ulteriori informazioni, consulta i IAM ruoli per ServiceNow le fonti di dati.

Puoi anche aggiungere le seguenti funzionalità opzionali:

• Mappature dei campi: scegli di mappare i campi delle sorgenti ServiceNow dati Amazon Kendra ai campi indice. Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.

  Nota

  Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per Amazon Kendra eseguire la ricerca nei documenti. È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice_document_body. Tutti gli altri campi sono facoltativi.

• Filtri di inclusione ed esclusione: specificate se includere o escludere determinati file allegati di cataloghi e articoli informativi.

  Nota

  La maggior parte delle fonti di dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.

• Parametri di indicizzazione: puoi anche scegliere di specificare se:

  • Indicizza gli articoli informativi e i cataloghi di servizi, o entrambi. Se si sceglie di indicizzare gli articoli della Knowledge Base e gli elementi del catalogo dei servizi, è necessario fornire il nome del ServiceNow campo mappato al campo del contenuto del documento indicizzato nell' Amazon Kendra indice.

  • Indicizza gli allegati agli articoli di approfondimento e agli elementi del catalogo.

  • Utilizza una ServiceNow query che seleziona i documenti da una o più basi di conoscenza. Le basi di conoscenza possono essere pubbliche o private. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.

Ulteriori informazioni

Per ulteriori informazioni sull'integrazione Amazon Kendra con la tua fonte di ServiceNow dati, consulta:

• Guida introduttiva a Amazon Kendra ServiceNow Online connector