ServiceNow connettore V2.0

PDFRSS

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, gli incidenti e i relativi allegati.

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à:

• mappature dei campi

• Controllo degli accessi degli utenti

• Filtri di inclusione/esclusione

• Sincronizzazione completa e incrementale dei contenuti

• ServiceNow versioni di istanza: Roma, Sandiego, Tokyo, Altre

• Virtual Private Cloud (VPC) (Cloud privato virtuale (VPC)

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare la tua fonte di ServiceNow dati, apporta queste modifiche ai tuoi ServiceNow AWS account.

Nel ServiceNow, assicurati di avere:

• Hai creato un'istanza Personal o Enterprise Developer e disponi di un' ServiceNowistanza con un ruolo amministrativo.

• Hai copiato l'host dell'URL dell' ServiceNow istanza. Il formato per l'URL dell'host che inserisci èyour-domain.service-now.com. È necessario l'URL dell' ServiceNow istanza a cui connettersi Amazon Kendra.

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

  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: credenziali client OAuth 2.0 configurate che possono essere identificate Amazon Kendra utilizzando un nome utente, una password, un ID client generato e un segreto client. Per ulteriori informazioni, consultate la ServiceNow 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. IDs I 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 lo hai ancora configurato ServiceNow per Amazon Kendra seePrerequisiti.

Console

Per connettersi Amazon Kendra a ServiceNow

1. Accedi a AWS Management Console 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 ServiceNow connettore, quindi scegli Aggiungi connettore. Se utilizzi la versione 2 (se applicabile), scegli il ServiceNow connettore con il tag «V2.0".

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. Scegli Next (Successivo).

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

   1. ServiceNow host: immetti l'URL dell' ServiceNowhost. Il formato per l'URL dell'host immesso èyour-domain.service-now.com.

   2. ServiceNow versione: seleziona la versione dell' ServiceNow istanza. Puoi scegliere tra Roma, Sandiego, Tokyo o Altri.

   3. Autorizzazione: attiva o disattiva le informazioni dell'elenco di controllo degli accessi (ACL) per i tuoi documenti, se disponi di un ACL e desideri utilizzarlo per il controllo degli accessi. L'ACL specifica a quali documenti possono accedere utenti e gruppi. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta Filtraggio del contesto utente.

   4. Autenticazione: scegli tra l'autenticazione di base e l'autenticazione OAuth 2.0.

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

      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 2.0, 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. Salva e aggiungi il tuo segreto.

   6. Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.

   7. Identity crawler: specifica se attivare il crawler di identità. Amazon Kendra Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra del contesto utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.

   8. IAM ruolo: scegli un IAM ruolo esistente o creane uno nuovo IAM 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.

   9. Scegli Next (Successivo).

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

   1. Per gli articoli di Knowledge, scegli una delle seguenti opzioni:

      • Articoli della conoscenza: scegli di indicizzare gli articoli della conoscenza.

      • Allegati degli articoli informativi: scegli di indicizzare gli allegati degli articoli informativi.

      • Tipo di articoli informativi: scegli tra Solo articoli pubblici e Articoli di Knowledge in base alla 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. Le query di filtro di esempio includono:workflow_state=draft^EQ,,kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ. article_type=text^active=true^EQ

        Importante

        Se scegli di eseguire la ricerca per indicizzazione Solo articoli pubblici, esegue la ricerca per Amazon Kendra indicizzazione solo degli articoli di conoscenza a cui è stato assegnato un ruolo di accesso pubblico in. ServiceNow

      • Includi articoli in base al filtro di descrizione breve: specifica i modelli di espressioni regolari per includere o escludere articoli specifici.

   2. Per gli articoli del catalogo Service:

      • Elementi del catalogo dei servizi: scegliere di indicizzare gli articoli del catalogo dei servizi.

      • Allegati degli elementi del catalogo dei servizi: scegliere di indicizzare gli allegati degli elementi del catalogo dei servizi.

      • Elementi del catalogo dei servizi attivi: scegliere di indicizzare gli articoli del catalogo dei servizi attivi.

      • Elementi del catalogo dei servizi inattivi: scegliere di indicizzare gli articoli del catalogo dei servizi inattivi.

      • Interrogazione di filtro: consente di includere gli elementi del catalogo dei servizi in base a un filtro definito nell'istanza. ServiceNow Le query di filtro di esempio includono:short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ,. nameSTARTSWITHService^active=true^EQ

      • Includi gli elementi del catalogo dei servizi in base al filtro di descrizione breve: specifica un modello regex per includere elementi specifici del catalogo.

   3. Per gli incidenti:

      • Incidenti: scegliere di indicizzare gli incidenti di servizio.

      • Allegati degli incidenti: scegliere di indicizzare gli allegati degli incidenti.

      • Incidenti attivi: scegliere di indicizzare gli incidenti attivi.

      • Incidenti inattivi: scegliere di indicizzare gli incidenti inattivi.

      • Tipo di incidente attivo: scegli tra Tutti gli incidenti, Incidenti aperti, Incidenti aperti - non assegnati e Incidenti risolti a seconda del caso d'uso.

      • Interrogazione di filtro: scegli di includere gli incidenti in base a un filtro definito nell'istanza. ServiceNow Le query di filtro di esempio includono:,. short_descriptionLIKETest^urgency=3^state=1^EQ priority=2^category=software^EQ

      • Includi incidenti in base a un filtro di descrizione breve: specifica un modello regex per includere incidenti specifici.

   4. Per una configurazione aggiuntiva:

      • Informazioni ACL: gli elenchi di controllo degli accessi per le entità selezionate sono inclusi per impostazione predefinita. La deselezione di un elenco di controllo degli accessi renderà pubblici tutti i file di quella categoria. Le opzioni ACL vengono disattivate automaticamente per le entità non selezionate. Per gli articoli pubblici l'ACL non viene applicato.

      • Per la dimensione massima del file: specifica il limite di dimensione del file entro il quale Amazon Kendra eseguirà la scansione. MBs Amazon Kendra eseguirà la scansione solo dei file entro il limite di dimensione definito. La dimensione predefinita del file è 50 MB. La dimensione massima del file deve essere superiore a 0 MB e inferiore o uguale a 50 MB.

      • Schemi di espressione regolare degli allegati: aggiungono modelli di espressioni regolari per includere o escludere determinati file allegati di cataloghi, articoli informativi e incidenti. È possibile aggiungere fino a 100 pattern.

   5. Modalità di sincronizzazione: scegli come aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione.

      • Sincronizzazione completa: indicizza di nuovo tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

      • Sincronizzazione nuova, modificata ed eliminata: indicizza solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

   6. Nella pianificazione di esecuzione della sincronizzazione, per Frequenza: scegli la frequenza con cui sincronizzare il contenuto della fonte di dati e aggiornare l'indice.

   7. Scegli Next (Successivo).

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

   1. Mappature dei campi predefinite: seleziona tra i campi delle origini dati predefinite Amazon Kendra generati 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. Scegli Next (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 un codice JSON dello schema dell'origine dati utilizzando l'TemplateConfigurationAPI. È necessario fornire le seguenti informazioni:

• Origine dati: specificare il tipo di origine dati come SERVICENOWV2 quando si utilizza il TemplateConfigurationSchema JSON. Specificate anche l'origine dati come TEMPLATE quando chiamate il CreateDataSourceAPI.

• URL host: specifica la versione dell'istanza ServiceNow host. Ad esempio your-domain.service-now.com.

• Tipo di autenticazione: specifica il tipo di autenticazione da utilizzare, indipendentemente dal fatto che sia basicAuth o OAuth2 per l' ServiceNow istanza.

• ServiceNow versione dell'istanza: specifica l' ServiceNow istanza da utilizzare, seTokyo, SandiegoRome, o. Others

• Modalità di sincronizzazione: specifica come Amazon Kendra aggiornare l'indice quando il contenuto dell'origine dati cambia. Quando sincronizzi l'origine dati con Amazon Kendra per la prima volta, tutto il contenuto viene sottoposto a scansione e indicizzato per impostazione predefinita. Se la sincronizzazione iniziale non è riuscita, devi eseguire una sincronizzazione completa dei dati, anche se non scegli la sincronizzazione completa come opzione della modalità di sincronizzazione. Puoi scegliere tra:

  • FORCED_FULL_CRAWLper indicizzare nuovamente tutti i contenuti, sostituendo i contenuti esistenti ogni volta che l'origine dati si sincronizza con l'indice.

  • FULL_CRAWLper indicizzare solo i contenuti nuovi, modificati ed eliminati ogni volta che l'origine dati si sincronizza con l'indice. Amazon Kendra può utilizzare il meccanismo dell'origine dati per tenere traccia delle modifiche ai contenuti e indicizzare i contenuti modificati dall'ultima sincronizzazione.

• 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 le credenziali OAuth2 del client, il segreto viene archiviato in una struttura JSON con le seguenti chiavi:

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

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

Puoi anche aggiungere le seguenti funzionalità opzionali:

• Virtual Private Cloud (VPC): VpcConfiguration specifica quando si chiama. CreateDataSource Per ulteriori informazioni, consulta Configurazione Amazon Kendra per l'utilizzo di un Amazon VPC.

• Filtri di inclusione ed esclusione: è possibile specificare se includere o escludere determinati file allegati utilizzando i nomi dei file e i tipi di file degli articoli informativi, dei cataloghi di servizi e degli incidenti.

  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.

• Documenti specifici da indicizzare: è possibile utilizzare una ServiceNow query per specificare i documenti desiderati da una o più knowledge base, incluse le knowledge base private. L'accesso alle knowledge base è determinato dall'utente utilizzato per connettersi all' ServiceNow istanza. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.

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

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

  • Indicizza gli allegati agli articoli della Knowledge Base, agli elementi del catalogo dei servizi e agli incidenti.

  • Includi articoli informativi, elementi del catalogo dei servizi e incidenti in base allo short description schema di filtro.

  • Scegli di filtrare gli elementi e gli incidenti attivi e inattivi del catalogo dei servizi.

  • Scegli di filtrare gli incidenti in base al tipo di incidente.

  • Scegli quali entità devono avere il loro ACL sottoposto a scansione.

  • È possibile utilizzare una ServiceNow query per specificare i documenti desiderati da una o più knowledge base, incluse le knowledge base private. L'accesso alle knowledge base è determinato dall'utente utilizzato per connettersi all' ServiceNowistanza. Per ulteriori informazioni, consulta la sezione Specifica dei documenti da indicizzare con una query.

• Identity crawler: specifica se attivare il crawler Amazon Kendra di identità. Il crawler di identità utilizza le informazioni dell'elenco di controllo degli accessi (ACL) per i documenti per filtrare i risultati della ricerca in base all'accesso dell'utente o del gruppo di appartenenza ai documenti. Se disponi di un ACL per i tuoi documenti e scegli di utilizzarlo, puoi anche scegliere di attivare il crawler di identità per configurare il filtraggio Amazon Kendra del contesto utente dei risultati di ricerca. Altrimenti, se il crawler di identità è disattivato, tutti i documenti possono essere ricercati pubblicamente. Se desideri utilizzare il controllo degli accessi per i tuoi documenti e il crawler di identità è disattivato, in alternativa puoi utilizzare l'PutPrincipalMappingAPI per caricare le informazioni di accesso di utenti e gruppi per il filtraggio del contesto degli utenti.

• Mappature dei campi: scegli di mappare i campi delle sorgenti ServiceNow dati ai campi indice. Amazon Kendra 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.

Per un elenco di altre importanti chiavi JSON da configurare, consulta lo schema ServiceNow del modello.

Ulteriori informazioni

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

• Guida introduttiva Amazon Kendra all'annuncio del ServiceNow connettore aggiornato (V2) per Amazon Kendra