Condividi tramite

Connettore Microsoft Graph del catalogo ServiceNow

  • Articolo

Con il connettore Microsoft Graph per ServiceNow, l'organizzazione può elencare gli elementi del catalogo di servizi visibili a tutti gli utenti o limitati con le autorizzazioni dei criteri utente all'interno dell'organizzazione. Dopo aver configurato il connettore e il contenuto dell'indice da ServiceNow, gli utenti finali possono cercare gli elementi del catalogo in Microsoft Copilot e da qualsiasi client di Microsoft Search.

Questo articolo è destinato agli amministratori di Microsoft 365 o a tutti gli utenti che configurano, eseguono e monitorano un connettore Microsoft Graph del catalogo ServiceNow. Integra le istruzioni generali fornite nell'articolo Configurare i connettori di Microsoft Graph nell'articolo interfaccia di amministrazione di Microsoft 365. Se non è già stato fatto, leggere l'intero articolo Configurare il connettore Microsoft Graph per comprendere il processo di configurazione generale.

Funzionalità

  • Indicizzare tutti i tipi di elementi del catalogo.
  • Abilitare gli utenti finali per porre domande relative ai flussi di lavoro IT/HR in Copilot.
    • Aiutami a richiedere un nuovo dispositivo.
    • Aiutami a reimpostare la password.
  • Usare la ricerca semantica in Copilot per consentire agli utenti di trovare contenuti pertinenti in base a parole chiave, preferenze personali e connessioni di social networking.

Limitazioni

Il connettore Microsoft Graph serviceNow Catalog presenta le limitazioni seguenti nella versione più recente:

  • Le autorizzazioni dei criteri utente configurate nella categoria del catalogo non sono supportate.
  • I criteri utente con script avanzati non sono supportati nella versione corrente.

Prerequisiti

  • URL dell'istanza di ServiceNow: per connettersi ai dati di ServiceNow, è necessario l'URL dell'istanza di ServiceNow dell'organizzazione. L'URL dell'istanza di ServiceNow dell'organizzazione è in genere simile a https://your-organization-name.service-now.com. (Non ne hai uno? Date un'occhiata a questo video di YouTube su come creare un'istanza di test).
  • Account del servizio: per connettersi a ServiceNow e consentire a Microsoft Graph Connector di aggiornare regolarmente gli elementi del catalogo, è necessario un account del servizio con accesso in lettura a record di tabella ServiceNow specifici. L'account del servizio richiede l'accesso in lettura ai record della tabella ServiceNow seguenti per eseguire correttamente la ricerca per indicizzazione di varie entità.
Funzionalità Tabelle necessarie per l'accesso in lettura Descrizione
Indicizzare gli elementi del catalogo disponibili per Tutti sc_cat_item Per la ricerca per indicizzazione degli elementi del catalogo
Indicizzare e supportare le autorizzazioni dei criteri utente sc_cat_item_user_criteria_mtom Chi può accedere a questo elemento del catalogo
sc_cat_item_user_criteria_no_mtom Chi non può accedere a questo elemento del catalogo
sys_user Leggere la tabella utente
sys_user_has_role Leggere le informazioni sui ruoli degli utenti
sys_user_grmember Leggere l'appartenenza a gruppi di utenti
user_criteria Leggere le autorizzazioni dei criteri utente
sys_user_group Leggere i segmenti dei gruppi di utenti
sys_user_role Leggere i ruoli utente
cmn_location Leggere le informazioni sulla posizione
cmn_department Leggere le informazioni sul reparto
core_company Leggere gli attributi aziendali

È possibile creare e assegnare un ruolo per l'account del servizio usato per connettersi a Microsoft Search. Informazioni su come assegnare il ruolo per gli account ServiceNow. L'accesso in lettura alle tabelle può essere assegnato al ruolo creato. Per informazioni sull'impostazione dell'accesso in lettura ai record di tabella, vedere Concessione dell'accesso alle tabelle a un utente in ServiceNow.

Per iniziare

Aggiungere il connettore del catalogo ServiceNow

Screenshot che mostra la schermata di creazione della connessione per Microsoft Graph Connector for ServiceNow Catalog.

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni riferimento in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. URL ServiceNow

Per connettersi ai dati di ServiceNow, è necessario l'URL dell'istanza di ServiceNow dell'organizzazione. L'URL dell'istanza di ServiceNow dell'organizzazione è in genere simile a https://your-organization-name.service-now.com.

3. Tipo di autenticazione

Per autenticare e sincronizzare il contenuto da ServiceNow, scegliere uno dei tre metodi supportati:

  1. Autenticazione di base

    Immettere il nome utente e la password dell'account ServiceNow con il ruolo del catalogo per l'autenticazione nell'istanza.

  2. ServiceNow OAuth


    [Fare clic per espandere] Per usare ServiceNow OAuth per l'autenticazione, seguire questa procedura.

    Un amministratore di ServiceNow deve effettuare il provisioning di un endpoint nell'istanza di ServiceNow, in modo che il connettore Microsoft Graph del catalogo ServiceNow possa accedervi. Per altre informazioni, vedere Creare un endpoint per i client per accedere all'istanza di nella documentazione di ServiceNow.

    La tabella seguente fornisce indicazioni su come compilare il modulo di creazione dell'endpoint:

    Campo Descrizione Valore consigliato
    Nome Valore univoco che identifica l'applicazione per cui è necessario l'accesso OAuth. Microsoft Search
    ID client ID univoco generato automaticamente di sola lettura per l'applicazione. L'istanza usa l'ID client quando richiede un token di accesso. ND
    Segreto client Con questa stringa di segreto condiviso, l'istanza di ServiceNow e Microsoft Search autorizzano le comunicazioni tra loro. Seguire le procedure consigliate per la sicurezza considerando il segreto come password.
    URL di reindirizzamento URL di callback necessario a cui viene reindirizzato il server di autorizzazione. Per M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback,
    For M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
    Logo URL URL che contiene l'immagine per il logo dell'applicazione. ND
    Attivazione Selezionare la casella di controllo per rendere attivo il Registro applicazioni. Impostare su attivo
    Durata del token di aggiornamento Numero di secondi di validità di un token di aggiornamento. Per impostazione predefinita, i token di aggiornamento scadono tra 100 giorni (8.640.000 secondi). 31.536.000 (un anno)
    Durata del token di accesso Numero di secondi di validità di un token di accesso. 43.200 (12 ore)

    Immettere l'ID client e il segreto client per connettersi all'istanza. Dopo la connessione, usare le credenziali di un account ServiceNow per autenticare l'autorizzazione per la ricerca per indicizzazione. L'account deve avere almeno un ruolo di catalogo . Fare riferimento alla tabella indicata nell'account del servizio nella sezione Prerequisiti per fornire l'accesso in lettura a più record di tabella ServiceNow e alle autorizzazioni dei criteri utente dell'indice.

  3. Microsoft Entra ID OpenID Connect


    Per usare Microsoft Entra ID OpenID Connect per l'autenticazione, seguire questa procedura.

    1. Registrare una nuova applicazione in Microsoft Entra ID

      Per informazioni sulla registrazione di una nuova applicazione in Microsoft Entra ID, vedere Registrare un'applicazione. Selezionare directory organizzativa a tenant singolo. L'URI di reindirizzamento non è necessario. Dopo la registrazione, annotare l'ID applicazione (client) e l'ID directory (tenant).

    2. Creare un segreto client

      Per informazioni sulla creazione di un segreto client, vedere Creazione di un segreto client. Prendere nota del segreto client.

    3. Recuperare l'identificatore dell'oggetto entità servizio

      Seguire la procedura per recuperare l'identificatore dell'oggetto entità servizio

      1. Eseguire PowerShell.

      2. Installare Azure PowerShell usando il comando seguente.

        Install-Module -Name Az -AllowClobber -Scope CurrentUser

      3. Connettersi ad Azure.

        Connect-AzAccount

      4. Ottiene l'identificatore dell'oggetto entità servizio.

        Get-AzADServicePrincipal -ApplicationId "Application-ID"

        Sostituire "Application-ID" con l'ID applicazione (client) (senza virgolette) dell'applicazione registrata nel passaggio 1. Si noti il valore dell'oggetto ID dall'output di PowerShell. Si tratta dell'ID entità servizio.

        Ora sono disponibili tutte le informazioni necessarie per portale di Azure. Nella tabella seguente è riportato un breve riepilogo delle informazioni.

        Proprietà Descrizione
        ID directory (ID tenant) ID univoco del tenant Microsoft Entra, dal passaggio 3.a.
        ID applicazione (ID client) ID univoco dell'applicazione registrata nel passaggio 3.a.
        Segreto client Chiave privata dell'applicazione (dal passaggio 3.b). Considerarlo come una password.
        ID entità servizio Identità per l'applicazione in esecuzione come servizio. (dal passaggio 3.c)

    4. Registrare l'applicazione ServiceNow

      L'istanza di ServiceNow richiede la configurazione seguente:

      1. Registrare una nuova entità OIDC OAuth. Per informazioni, vedere Creare un provider OIDC OAuth.

      2. La tabella seguente fornisce indicazioni su come compilare il modulo di registrazione del provider OIDC:

        Campo Descrizione Valore consigliato
        Nome Nome univoco che identifica l'entità OIDC OAuth. Microsoft Entra ID
        ID client ID client dell'applicazione registrata nel server OIDC OAuth di terze parti. L'istanza usa l'ID client quando si richiede un token di accesso. ID applicazione (client) dal passaggio 3.a
        Segreto client Segreto client dell'applicazione registrata nel server OIDC OAuth di terze parti. Segreto client dal passaggio 3.b

        Tutti gli altri valori possono essere predefiniti.

      3. Nel modulo di registrazione del provider OIDC è necessario aggiungere una nuova configurazione del provider OIDC. Selezionare l'icona di ricerca nel campo Configurazione provider OIDC OAuth per aprire i record delle configurazioni OIDC. Selezionare Nuovo.

      4. La tabella seguente fornisce indicazioni su come compilare il modulo di configurazione del provider OIDC:

        Campo Valore consigliato
        OIDC Provider Microsoft Entra ID
        URL dei metadati OIDC L'URL deve essere nel formato https://login.microsoftonline.com/<tenandId">/.well-known/openid-configuration
        Sostituire "tenantID" con l'ID directory (tenant) del passaggio 3.1.
        Intervallo di vita della cache di configurazione OIDC 120
        Applicazione Globale
        Attestazione utente sub
        Campo utente ID utente
        Abilitare la verifica delle attestazioni JTI Disabilitato

      5. Selezionare Submit (Invia ) e aggiornare il modulo OAuth OIDC Entity (Entità OIDC OAuth).

    5. Creare un account ServiceNow.

      Fare riferimento alle istruzioni per creare un account ServiceNow e creare un utente in ServiceNow.

      La tabella seguente fornisce indicazioni su come compilare la registrazione dell'account utente ServiceNow

      Campo Valore consigliato
      ID utente ID entità servizio dal passaggio 3.3
      Solo accesso al servizio Web Quadrettato

      Tutti gli altri valori possono essere lasciati come predefiniti.

    6. Abilitare il ruolo del catalogo per l'account ServiceNow

      Accedere all'account ServiceNow creato con l'ID entità ServiceNow come ID utente e assegnare il ruolo del catalogo. Le istruzioni per l'assegnazione di un ruolo a un account ServiceNow sono disponibili qui e assegnano un ruolo a un utente. Fare riferimento alla tabella all'inizio di Prerequisiti per fornire l'accesso in lettura a più record di tabella ServiceNow e alle autorizzazioni dei criteri utente dell'indice.

      Usare l'ID applicazione come ID client (dal passaggio 3.1) e il segreto client (dal passaggio 3.2) nella configurazione dell'interfaccia di amministrazione assistente per eseguire l'autenticazione nell'istanza di ServiceNow usando Microsoft Entra ID OpenID Connect.

Nota

Il connettore del catalogo ServiceNow può indicizzare gli elementi del catalogo e le autorizzazioni dei criteri utente senza script avanzati.

4. Implementazione a un pubblico limitato

Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, fare clic qui.

A questo punto, si è pronti per creare la connessione per il catalogo ServiceNow. È possibile selezionare il pulsante Crea e il connettore Microsoft Graph ServiceNow Catalog avvia l'indicizzazione degli elementi del catalogo dall'account ServiceNow.

Per altre impostazioni, ad esempio le autorizzazioni di accesso, le regole di inclusione dei dati, lo schema e la frequenza di ricerca per indicizzazione, sono state impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati ServiceNow. Di seguito sono riportati i valori predefiniti:

Utenti  
Autorizzazioni di accesso Solo gli utenti con accesso al contenuto nell'origine dati.
Identità mappa Identità dell'origine dati mappate tramite ID Microsoft Entra.
Contenuto  
Stringa di query active=true^workflow_state=published
Gestisci proprietà Per controllare le proprietà predefinite e il relativo schema, fare clic qui
Sincronizza  
Ricerca per indicizzazione incrementale Frequenza: ogni 15 minuti
Ricerca per indicizzazione completa Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere l'opzione Installazione personalizzata .

Configurazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni elencate nella tabella precedente. Dopo aver fatto clic su Installazione personalizzata, vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Screenshot che mostra la scheda Utenti in cui è possibile configurare le autorizzazioni di accesso e le regole di mapping degli utenti.

Autorizzazioni di accesso

Il connettore Microsoft Graph del catalogo ServiceNow supporta le autorizzazioni di accesso visibili a "Tutti" o "Solo le persone con accesso al contenuto nell'origine dati". I dati indicizzati vengono visualizzati nei risultati ed è visibile a tutti gli utenti dell'organizzazione o agli utenti che hanno accesso rispettivamente tramite l'autorizzazione dei criteri utente. Scegliere quella più appropriata per l'organizzazione.

Il connettore supporta le autorizzazioni predefinite per i criteri utente senza script avanzati.

Mapping delle identità

Il metodo predefinito per il mapping delle identità dell'origine dati con Microsoft Entra ID consiste nel verificare se l'ID Email degli utenti di ServiceNow è uguale a UserPrincipalName (UPN) o Mail degli utenti in Microsoft Entra ID. Se si ritiene che il mapping predefinito non funzioni per l'organizzazione, è possibile fornire una formula di mapping personalizzata. Per altre informazioni sul mapping delle identità non EntraID, fare clic qui.

Contenuto

Screenshot che mostra la scheda Contenuto in cui è possibile configurare la stringa di query e le proprietà.

Stringa di query

Con una stringa di query ServiceNow, è possibile specificare le condizioni per la sincronizzazione degli articoli. È come una clausola Where in un'istruzione SQL Select . Ad esempio, è possibile scegliere di indicizzare solo gli articoli pubblicati e attivi. Per informazioni sulla creazione di una stringa di query personalizzata, vedere Generare una stringa di query codificata usando un filtro.

Gestire le proprietà

In questo caso, è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati ServiceNow, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Di seguito sono elencate le proprietà selezionate per impostazione predefinita.

L'elenco delle proprietà selezionate qui può influire su come filtrare, cercare e visualizzare i risultati in Copilot per Microsoft 365.

Proprietà source Etichetta Descrizione Schema
AccessUrl url URL di destinazione dell'elemento nell'origine dati. Recuperare
Autori authors Nome delle persone che hanno partecipato o collaborato all'elemento nell'origine dati.
Catalogo Catalogo specifico a cui appartiene l'elemento. Query
Categoria Categoria all'interno del catalogo. Query
Descrizione Content Descrizione dell'elemento del catalogo. Ricerca, Recupero
IconUrl iconUrl URL dell'icona che rappresenta la categoria o il tipo dell'articolo. Recuperare
Nome title Titolo dell'elemento da visualizzare nella ricerca e in altre esperienze. Ricerca, Recupero
Breve descrizione Breve riepilogo dello scopo dell'elemento. Ricerca, Recupero
SysCreatedBy createdBy Nome della persona che ha creato l'elemento nell'origine dati. Query, Retrieve
SysCreatedOn createdDateTime Data e ora di creazione dell'elemento nell'origine dati. Query, Retrieve
SysID Identificatore univoco per un elemento.
SysUpdatedBy lastModifiedBy Nome della persona che ha modificato l'elemento più di recente nell'origine dati. Query, Retrieve
SysUpdatedOn lastModifiedDateTime Data e ora dell'ultima modifica dell'elemento nell'origine dati. Query, Retrieve

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà e del filtro di query selezionati.

Sincronizza

Screenshot che mostra la scheda Sincronizza in cui è possibile configurare la frequenza di ricerca per indicizzazione.

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Microsoft Graph del catalogo ServiceNow. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altri dettagli, fare clic qui.

È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, personalizzando la pagina dei risultati, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore. È possibile trovare i passaggi per la risoluzione dei problemi più comuni qui.

In caso di altri problemi o se si vuole fornire commenti e suggerimenti, contattare Microsoft Graph | Appoggiare