Condividi tramite

Connettore Microsoft Graph locale confluence

  • Articolo

Il connettore Microsoft Graph locale di Confluence consente all'organizzazione di indicizzare il contenuto del server o del data center di Confluence. Dopo aver configurato i dati del connettore e dell'indice dal sito di Confluence, gli utenti finali possono cercare tali contenuti in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 e responsabili della configurazione, dell'esecuzione e del monitoraggio del connettore Microsoft Graph locale di Confluence. Integra le istruzioni generali fornite nella configurazione dei connettori di Microsoft Graph nel interfaccia di amministrazione di Microsoft 365.

Vantaggi

  • Funzionalità di ricerca avanzate: gli utenti possono porre domande in linguaggio naturale sul contenuto wiki in Copilot, ad esempio:
    • Riepilogare il documento sull'architettura
    • Come ottenere l'accesso a un portale
  • Supporto per la ricerca semantica: gli utenti possono eseguire query in linguaggio naturale per ottenere risposte accurate.
  • Compatibilità: supporta le versioni di Confluence precedenti alla versione 8.0.

Prerequisiti

  1. Installare GCA [Agente connettore Graph]: assicurarsi che GCA sia installato in un computer Windows all'interno della stessa rete dell'origine dati, accessibile tramite l'URL di Confluence. Altre informazioni sull'agente connettore di Microsoft Graph
  2. Installare il plug-in: scaricare e installare il plug-in confluence on-prem da Atlassian Marketplace nella configurazione della confluenza. Ottenere il plug-in da Microsoft Graph Connectors Confluence On-prem Plugin | Atlassian Marketplace
  3. Autenticazione: assicurarsi di avere credenziali di autenticazione con accesso corretto.

Introduzione

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 locale di Confluence

Per connettersi ai dati locali di Confluence, è necessario l'URL dell'istanza di Confluence dell'organizzazione. L'URL dell'istanza di Confluence dell'organizzazione è in genere simile a "https://contoso.atlassian.net".

3. Agente connettore Graph (GCA)

Per indicizzare il contenuto del server o del data center di Confluence, è necessario installare e registrare l'agente del connettore. Per informazioni dettagliate, vedere Installare l'agente connettore Microsoft Graph . È necessario essere l'amministratore per il tenant di Microsoft 365 dell'organizzazione e l'amministratore del sito Confluence dell'organizzazione.

Nota

GCA può essere installato in un computer Windows diverso e non deve trovarsi nello stesso computer del server locale. Il computer può aiutare a generare l'ID app e il segreto che possono essere usati per l'installazione. È necessario assicurarsi che il computer GCA sia acceso durante la ricerca per indicizzazione. È possibile trovare risposte alle domande comuni su GCA reali nella sezione Domande frequenti .

4. Installare il plug-in locale di Confluence

Verificare che sia installato il plug-in Microsoft Graph Connectors Confluence On-prem. Non è necessario installare il plug-in per ogni connettore di confluenza; se è già installato nell'istanza di Confluence, è possibile ignorare questo passaggio per le connessioni locali successive di Confluence.

Nota

Il plug-in è supportato per la versione confluence superiore alla 8.0.

5. Tipo di autenticazione

Per autenticare e sincronizzare il contenuto da Confluence On-prem, scegliere uno dei tre metodi supportati:

a. Autenticazione di base
Per eseguire l'autenticazione nell'istanza, immettere il nome utente e la password dell'account Confluence.

b. OAuth1.0a
Generare una coppia di chiavi pubblica/privata e creare un collegamento all'applicazione nel sito locale di Confluence in modo che l'agente connettore possa accedere all'istanza. Per altre informazioni, vedere il passaggio 1 nella documentazione per sviluppatori Atlassian su come configurare OAuth 1.0a.

c. OAuth 2.0 (scelta consigliata)
La procedura seguente fornisce indicazioni su come registrare l'app Configurare un collegamento in ingresso.

  1. Passare a Configurazione > generale amministrazione > Collegamenti all'applicazione.
  2. Selezionare Crea collegamento
  3. Selezionare Applicazione esterna e quindi scegliere In ingresso come direzione.
  4. Compilare il
  • URL di reindirizzamento: https://gcs.office.com/v1.0/admin/oauth/callback
  • Ambito: Amministrazione o lettura
  1. Completare il passaggio delle impostazioni di connessione usando l'ID client e il segreto.

6. 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 ServiceNow Knowledge. È possibile fare clic sul pulsante "Crea" e il connettore Microsoft Graph avvia la pagina di indicizzazione dall'account Confluence.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dei dati, schema, frequenza di ricerca per indicizzazione e così via, vengono impostate le impostazioni predefinite in base a ciò che funziona meglio con i dati di Confluence. I valori predefiniti sono i seguenti:

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  
Includi/Escludi spazio Tutto
Gestisci proprietà Per controllare le proprietà predefinite e il relativo schema, fare clic qui
Sincronizzazione  
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 Custom Setup .

Installazione personalizzata

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

Utenti

Autorizzazioni di accesso

Il connettore Microsoft Graph locale di Confluence supporta le autorizzazioni di ricerca visibili a Tutti o Solo gli utenti con accesso a questa origine dati. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo gli utenti con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tale origine. In Confluence locale, le autorizzazioni di sicurezza per utenti e gruppi vengono definite usando le autorizzazioni di spazio e le restrizioni delle pagine. Il connettore Microsoft Graph locale di Confluence applica le autorizzazioni valide fornite dall'API Restrizioni del contenuto

Se si sceglie Solo le persone con accesso a questa origine dati, è necessario scegliere ulteriormente se il sito di Confluence ha Microsoft Entra ID utenti con provisioning o utenti non AAD.

Per identificare l'opzione adatta all'organizzazione:

  1. Scegliere l'opzione Microsoft Entra ID se l'ID di posta elettronica degli utenti di Confluence è uguale all'UPN (UserPrincipalName) degli utenti in Microsoft Entra ID.
  2. Scegliere l'opzione non AAD se l'ID di posta elettronica degli utenti di Confluence è diverso da UserPrincipalName (UPN) degli utenti in Microsoft Entra ID.

Importante

  • Se si sceglie Microsoft Entra ID come tipo di origine identità, il connettore esegue il mapping degli ID di posta elettronica degli utenti ottenuti da Confluence direttamente alla proprietà UPN da Microsoft Entra ID.
  • Se si sceglie "non AAD" per il tipo di identità, vedere Eseguire il mapping delle identità non Azure AD per istruzioni sul mapping delle identità. È possibile usare questa opzione per fornire l'espressione regolare di mapping dall'ID di posta elettronica all'UPN.
  • Aggiornamenti agli utenti o ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano attualmente l'elaborazione degli aggiornamenti alle autorizzazioni.

Contenuto

Includere o escludere i dati da indicizzare

In questo passaggio è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Confluence. Microsoft 365 seleziona alcune proprietà. Per impostazione predefinita, il connettore indicizzare tutti gli spazi. Tuttavia, è possibile scegliere di includere o escludere spazi specifici usando l'opzione di filtro dello spazio.

Immettere l'elenco di chiavi di spazio da includere o escludere e visualizzare un'anteprima dei risultati. Immettere Chiave spazio: ogni spazio di confluenza ha una chiave di spazio, ovvero un identificatore univoco breve che fa parte dell'URL per tale spazio. Per ottenere la chiave di spazio, contattare l'amministratore della confluenza. Per altre informazioni, visitare: Space Keys

Filtro di pagina

In questo passaggio è possibile specificare l'intervallo di date per l'indicizzazione dei documenti. I parametri sono i seguenti:

  • Data ultima creazione: data di creazione di un documento. Vengono indicizzati solo i documenti modificati dopo questa data.
  • Data ultima modifica: data di modifica di un documento. Vengono indicizzati solo i documenti modificati dopo questa data.

Importante

  • Assicurarsi che le date siano in ordine cronologico. La data dell'ultima creazione non deve essere successiva alla data dell'ultima modifica.
  • Se non vengono specificate date, tutti i documenti verranno considerati per l'indicizzazione.

Gestisci proprietà

Qui è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Confluence On-prem. Assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile). Inoltre, è possibile modificare l'etichetta semantica e aggiungere un alias alla proprietà . Le proprietà predefinite sono le seguenti:

Source, proprietà Etichetta Schema
Author authors Query, Retrieve
Contenuto Ricerca
CreatedByName Creato da Ricerca, Query, Recupera
CreatedOn Data e ora di creazione Query, Retrieve
Id Query, Retrieve
PageTree Recuperare
SpaceName Ricerca, Query, Recupera
Titolo title Ricerca, Recupero
UpdatedByName lastModifiedBy Recuperare
UpdatedOn lastModifiedDateTime Query, Retrieve, Refine
URL URL Recuperare

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare le proprietà e i filtri selezionati.

Nota

Si noti che l'anteprima rispetta solo il filtro a livello di spazio.

Sincronizzazione

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Graph. 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.

Esaminare e testare la connessione

Per Ms Search, se è necessario personalizzare la pagina dei risultati della ricerca. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere Personalizzare la pagina dei risultati della ricerca.

Limitazioni

  • Non indicizzare blog, file di allegati o commenti.
  • Indicizza solo le pagine correnti; le pagine archiviate sono escluse.
  • CQL[Confluence Query Language] non è supportato per Confluence locale, tuttavia è supportato un filtro a livello di pagina e spazio

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è 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 problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.