Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il connettore locale Confluence consente a Microsoft 365 di indicizzare e recuperare il contenuto da istanze self-hosted di Confluence Data Center o Server. Porta contenuti wiki aziendali in Microsoft Search e Copilot, migliorando la visibilità e l'usabilità all'interno dell'ecosistema di Microsoft 365.
Questo articolo descrive i passaggi per distribuire, personalizzare e risolvere i problemi del connettore locale Confluence. Per informazioni generali sulla distribuzione del connettore Copilot, vedere Configurare i connettori Copilot nel interfaccia di amministrazione di Microsoft 365.
Per informazioni avanzate sulla configurazione locale di Confluence, vedere Configurare il servizio locale Confluence per l'inserimento del connettore.
Prerequisiti
Prima di distribuire il connettore locale Confluence, assicurarsi che l'ambiente Confluence sia configurato nell'organizzazione. Nella tabella seguente vengono riepilogati i passaggi per configurare l'ambiente Confluence e distribuire il connettore.
| Ruolo | Attività |
|---|---|
| Amministratore della confluenza | Configurare l'ambiente |
| Amministratore della confluenza/amministratore di rete | Configurare i prerequisiti |
| Amministratore di Microsoft 365 | Distribuire il connettore nel interfaccia di amministrazione di Microsoft 365 |
| Amministratore di Microsoft 365 | Personalizzare le impostazioni del connettore (facoltativo) |
Prima di distribuire il connettore, verificare che siano soddisfatti i prerequisiti seguenti:
- È necessario essere un amministratore di Microsoft 365.
- Installare Graph Connector Agent (GCA) in un computer Windows nella stessa rete del server Confluence.
- Installare il plug-in Confluence On-prem da Atlassian Marketplace.
- Verificare che il plug-in Web di Confluence Mobile sia installato e abilitato.
- Verificare che le credenziali di autenticazione siano disponibili con le autorizzazioni di amministratore di Confluence.
- Verificare che la versione di Confluence sia 8.0 o successiva.
Distribuire il connettore
Per aggiungere il connettore locale Confluence per l'organizzazione:
- Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
- Nell'elenco dei connettori disponibili scegliere Confluence in locale.
Impostare il nome visualizzato
Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot per consentire agli utenti di riconoscere il file o l'elemento associato. Il nome visualizzato indica anche il contenuto attendibile e viene usato come filtro origine contenuto.
È possibile accettare il nome visualizzato predefinito di Confluence locale o personalizzare il valore per usare un nome riconosciuto dagli utenti dell'organizzazione.
Per altre informazioni, vedere Migliorare l'individuazione di Copilot con il contenuto dei connettori Microsoft 365 Copilot
Impostare l'URL dell'istanza
Per connettersi al sito di Confluence, usare l'URL dell'istanza del sito dell'organizzazione. Il formato tipico è:
https://<your-company-domain>/confluence
Per trovare l'URL dell'istanza:
- Nella console di Amministrazione Confluence passare aURL di base del serverdi configurazione> generale.
Scegliere il tipo di autenticazione
Il connettore supporta i metodi di autenticazione seguenti:
- Autenticazione di base: usare il nome utente e la password di Confluence.
- OAuth 1.0a: generare una coppia di chiavi pubblica/privata e creare un collegamento all'applicazione. Per altre informazioni, vedere OAuth.
- OAuth 2.0 (scelta consigliata): registrare un collegamento all'applicazione in ingresso con ambito amministratore.
Per la configurazione di OAuth 2.0:
- Passare aConfigurazione> generale amministrazione>Collegamenti all'applicazione.
- Selezionare Crea collegamento>Applicazione> esternain ingresso.
- Impostare l'ambito su Amministrazione.
- Usare l'URL di reindirizzamento seguente:
https://gcs.office.com/v1.0/admin/oauth/callback.
Eseguire l'implementazione
Per eseguire l'implementazione a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti e i gruppi a cui distribuire il connettore. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.
Scegliere Crea per distribuire la connessione. Il connettore Copilot locale di Confluence avvia immediatamente l'indicizzazione del contenuto.
Nella tabella seguente sono elencati i valori predefiniti impostati.
| Categoria | Impostazione | Valore predefinito |
|---|---|---|
| Utenti | Autorizzazioni di accesso | Solo gli utenti con accesso al contenuto nell'origine dati. |
| Utenti | Esegui il mapping delle identità | Le identità dell'origine dati vengono mappate usando id Microsoft Entra. |
| Contenuto | Includi/escludi spazio | Tutti gli spazi inclusi. |
| Contenuto | Gestire le proprietà | Per le proprietà e gli schemi predefiniti, vedere Gestire le proprietà. |
| Sincronizza | Ricerca per indicizzazione incrementale | Ogni 15 minuti. |
| Sincronizza | Ricerca per indicizzazione completa | Analisi giornaliera. |
Per personalizzare questi valori, vedere Personalizzare le impostazioni.
Dopo aver creato la connessione, è possibile esaminare lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.
Personalizzare le impostazioni
È possibile personalizzare i valori predefiniti per le impostazioni del connettore locale confluence. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.
Personalizzare le impostazioni utente
Il connettore Confluence Cloud supporta le autorizzazioni di ricerca utente seguenti:
- Tutti: i dati indicizzati sono visibili a tutti gli utenti.
- Solo gli utenti con accesso: i dati indicizzati sono visibili solo agli utenti con accesso in Confluence.
In Confluence locale, le autorizzazioni di sicurezza per utenti e gruppi vengono definite tramite autorizzazioni di spazio e restrizioni di pagina. La valutazione delle autorizzazioni viene eseguita come segue:
- Recuperare la configurazione delle autorizzazioni dalle restrizioni a livello di pagina.
- Recuperare la configurazione delle autorizzazioni dalle restrizioni della pagina padre.
- Recuperare la configurazione delle autorizzazioni dalle autorizzazioni per lo spazio.
- Calcolare l'intersezione delle tre configurazioni precedenti per determinare l'autorizzazione effettiva nella pagina. Questo set di autorizzazioni finale viene sincronizzato con Microsoft 365 Copilot.
Importante
- Per le versioni di Microsoft Graph Connector Agent precedenti alla 3.1.14, le impostazioni di accesso anonimo definite a livello di spazio non vengono considerate.
- Per le versioni di Microsoft Graph Connector Agent a partire dalla versione 3.1.14, vengono considerate le impostazioni di accesso anonimo definite a livello di spazio.
Se si sceglie Solo gli utenti con accesso a questa origine dati, scegliere se il sito di Confluence ha Microsoft Entra ID utenti con provisioning o utenti non Microsoft Entra ID:
- Microsoft Entra ID: scegliere questa opzione se gli ID di posta elettronica di Confluence corrispondono ai nomi dell'entità utente (UPN) in Microsoft Entra ID.
- Non Microsoft Entra ID: scegliere questa opzione se gli ID di posta elettronica di Confluence non corrispondono agli UPN. Usare regex per eseguire il mapping degli ID di posta elettronica agli UPN.
Aggiornamenti alle autorizzazioni vengono sincronizzate solo durante le ricerche per indicizzazione complete.
Personalizzare le impostazioni del contenuto
È possibile personalizzare le impostazioni del contenuto nei modi seguenti:
- Includere o escludere spazi specifici usando l'opzione filtro spazi. Ogni spazio ha un identificatore di chiave di spazio che fa parte dell'URL per tale spazio. Per altre informazioni, vedere Chiavi spazio.
- Specificare un intervallo di date per l'indicizzazione dei documenti. È possibile filtrare le pagine in base alla data dell'ultima creazione o dell'ultima modifica.
- Aggiungere o rimuovere proprietà dall'origine dati, assegnare uno schema alle proprietà (ricercabile, ricercabile, recuperabile, perfezionabile) e modificare le etichette semantica associate alle proprietà. Nella tabella seguente sono elencate le proprietà predefinite.
| Proprietà source | 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 |
Personalizzare gli intervalli di sincronizzazione
È possibile modificare la frequenza di sincronizzazione:
- Ricerca per indicizzazione incrementale: sincronizza il contenuto nuovo e modificato. Le ricerche per indicizzazione incrementali non raccolgono le modifiche dell'elenco di controllo di accesso o gli elementi eliminati. Il valore predefinito è ogni 15 minuti.
- Ricerca per indicizzazione completa: esegue una sincronizzazione completa di tutto il contenuto. Le ricerche per indicizzazione complete rilevano gli elementi eliminati e sincronizzano le modifiche dell'elenco di controllo di accesso (ACL). Il valore predefinito è giornaliero.
Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.