Collegare Confluence Cloud

Questa pagina descrive come connettere Confluence Cloud a Gemini Enterprise.

Dopo aver configurato l'origine dati e importato i dati la prima volta, il datastore sincronizza i dati da questa origine con una frequenza che selezioni durante la configurazione.

Versioni supportate

Il connettore Confluence Cloud supporta le versioni v1 e v2 dell'API REST di Confluence.

Prima di iniziare

Prima di configurare la connessione:

1. Verifica di disporre dell'accesso amministrativo al progetto e all'istanza Confluence.

2. (Facoltativo) Per recuperare gli indirizzi email degli utenti da Confluence Cloud, anche quando le impostazioni limitano la visibilità delle email, installa l'app User Identity Accessor per Confluence Cloud. Per installare e configurare questa app, devi essere un Confluence Site administrator. Dopo aver installato l'app, configurala per recuperare in modo sicuro gli indirizzi email degli utenti. Potresti non dover installare questa app se gli indirizzi email sono accessibili pubblicamente.

3. Concedi il ruolo Discovery Engine Editor (roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:

   1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

   2. Individua l'account utente e fai clic sull'icona Edit (Modifica).

   3. Concedi all'utente il ruolo Discovery Engine Editor.

4. Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Gemini Enterprise, assicurati di aver configurato il tuo provider di identità.

Configura l'autenticazione e le autorizzazioni in Confluence

Puoi autenticarti in Confluence utilizzando l'autenticazione basata su credenziali client OAuth o token API. Le sezioni seguenti forniscono informazioni su come creare le credenziali client OAuth e il token API.

Crea le credenziali client OAuth

Segui le istruzioni riportate di seguito per creare un ID client e un client secret, configurare gli ambiti OAuth 2.0 richiesti, impostare le autorizzazioni per gli utenti, recuperare l'URL e l'ID dell'istanza, configurare i ruoli ed eseguire l'autenticazione per sincronizzare i dati tra Confluence Cloud e Gemini Enterprise. Per attivare OAuth 2.0 e ottenere l'ID client e il client secret, consulta la sezione OAuth 2.0 (3LO) apps (App OAuth 2.0 (3LO)) nella documentazione per sviluppatori di Atlassian.

1. Crea un'integrazione OAuth 2.0 in Atlassian Developer Console:

   1. Accedi all'Atlassian Developer Console.

   2. Fai clic sull'icona del profilo e seleziona Developer console (Console per gli sviluppatori).

      

      Seleziona Console per gli sviluppatori

   3. Fai clic su Create (Crea) e seleziona OAuth 2.0 Integration (Integrazione OAuth 2.0).

      

      Seleziona Integrazione OAuth 2.0

   4. Inserisci un nome per l'app e procedi nel seguente modo:

      1. Seleziona la casella di controllo dei Termini e condizioni.

      2. Fai clic su Crea.

         

         Crea una nuova integrazione OAuth 2.0

      3. Fai clic su Authorization (Autorizzazione).

      4. Nella tabella Authorization type (Tipo di autorizzazione), clicca su Add (Aggiungi) per OAuth 2.0 (3LO).

         

         Aggiungi tipo di autorizzazione

   5. Nel campo Callback URL (URL di callback), inserisci https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html

   6. Fai clic su Salva modifiche.

      

      Salva modifiche

Se visualizzi l'avviso: Your app doesn't have any APIs. Add APIs to your app (La tua app non ha API. Aggiungi API alla tua app), continua con la procedura successiva per configurare OAuth 2.0. In caso contrario, vai al passaggio 4 di questa procedura.

Nota: gli ambiti classici non sono disponibili per i connettori Confluence Cloud. Inoltre, dopo aver aggiunto l'API Confluence, il pulsante Configure (Configura) potrebbe impiegare un po' di tempo per essere visualizzato. Se non viene visualizzato immediatamente, prova ad aggiornare la pagina o ad attendere qualche secondo.

Per configurare OAuth 2.0 e recuperare le credenziali richieste per la configurazione del connettore Confluence, procedi nel seguente modo:

1. Abilita OAuth 2.0:

   1. Fai clic su Autorizzazioni.

      

      Seleziona autorizzazioni

   2. Vai all'API Confluence.

   3. Fai clic su Aggiungi.

   4. Fai clic su Configura.

   5. Vai alla scheda Granular scopes (Ambiti granulari) e fai clic su Edit Scopes (Modifica ambiti).

      

      Modifica ambiti

   6. Seleziona i seguenti ambiti.

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:whiteboard:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence

   7. Conferma che siano selezionati otto ambiti e salva le modifiche.

2. Ottieni un ID client e un client secret

   1. Fai clic su Distribution (Distribuzione).

   2. Seleziona Modifica.

      

      Modifica distribuzione

   3. Seleziona Sharing (Condivisione) per attivare la modifica di altri campi.

   4. Compila i campi rimanenti. Assicurati di impostare Vendore name (Nome fornitore) su Google e Privacy policy (Norme sulla privacy) su https://policies.google.com.

   5. Nella sezione Personal data declaration (Dichiarazione sui dati personali), segui questi passaggi:

      1. Nell'elenco Does your app store personal data? (Il tuo store app memorizza dati personali?), seleziona Yes (Sì).

      2. Per confermare di aver implementato l'API Personal Data Reporting, seleziona la casella di controllo I confirm that I've implemented the Personal Data Reporting API (Confermo di aver implementato l'API Personal Data Reporting).

      3. Fai clic su Salva modifiche.

   6. Seleziona Settings (Impostazioni) e poi copia i valori dai campi Client ID (ID client) e Client secret.

      

      Copia l'ID client e il client secret

3. Ottieni l'URL dell'istanza:

   1. Vai su atlassian.net e accedi con il tuo account amministratore.
   2. Seleziona l'app che desideri sincronizzare. Ad esempio, sincronizza la prima app.
   3. Trova l'URL dell'istanza. Viene visualizzato come sottodominio nella barra degli indirizzi.

4. Ottieni l'ID istanza:

   1. Apri una nuova scheda, copia l'URL dell'istanza e aggiungi /_edge/tenant_info all'URL dell'istanza. Ad esempio, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info.

   2. Vai al link per trovare il valore di cloudId. cloudId è l'ID istanza.

      

      Ottieni l'ID istanza

Ambiti OAuth minimi

La seguente tabella elenca gli ambiti OAuth minimi richiesti per creare un connettore Confluence Cloud:

Autorizzazione	Motivo dell'utilizzo	Descrizione
read:content-details:confluence	Importazione dati	Consente al connettore di leggere i dettagli dei contenuti in Confluence.
read:content.metadata:confluence	Importazione dati	Consente al connettore di leggere i metadati dei contenuti.
read:space:confluence	Importazione dati	Consente al connettore di leggere gli spazi.
read:whiteboard:confluence	Importazione dati	Consente al connettore di leggere le lavagne.
read:attachment:confluence	Importazione dati	Consente al connettore di leggere gli allegati.
read:configuration:confluence	Applicare le ACL	Consente l'applicazione forzata degli ACL per accedere al sito Confluence.
read:group:confluence	Applicare le ACL	Consente l'applicazione forzata delle ACL per leggere i dettagli di utenti e gruppi.
read:user:confluence	Applicare le ACL	Consente l'applicazione forzata delle ACL per leggere i dettagli dell'utente.

Nota: oltre alle autorizzazioni di amministratore, devi disporre anche dell'accesso ai record di entità specifici, come blog o post.

Configura un token API in Confluence

Se prevedi di utilizzare un token API per l'autenticazione, devi creare un token API senza ambiti. Questo connettore non supporta il token API con ambiti.

1. Accedi alla Console Atlassian.
2. Fai clic su Genera token API.
3. Inserisci un nome per il token API.
4. Seleziona una data di scadenza per il token API. Il periodo di scadenza del token varia da 1 a 365 giorni.
5. Fai clic su Create (Crea).
6. Salva il token per utilizzarlo in un secondo momento.

Ottieni l'URL dell'istanza

1. Vai su atlassian.net e accedi con il tuo account amministratore.
2. Seleziona l'app che desideri sincronizzare. Ad esempio, sincronizza la prima app.
3. Trova l'URL dell'istanza. Viene visualizzato come sottodominio nella barra degli indirizzi.

Gestisci la visibilità degli utenti e concedi i ruoli

Nota: affinché le autorizzazioni utente vengano applicate correttamente, ogni utente di Confluence Cloud deve rendere visibile la propria email a tutti gli utenti. Per farlo, modifica le impostazioni di visibilità dell'email in Confluence Cloud e imposta la visibilità su Anyone.

Per impostare la visibilità dell'utente:

1. Accedi all'Atlassian Developer Console.

2. Fai clic sull'icona del profilo utente e vai a Manage account (Gestisci account).

   

   Gestisci account

3. Vai a Profile and visibility (Profilo e visibilità).

   

   Profilo e visibilità

4. Vai a Contact (Contatto) e imposta Who can see this (Chi può vedere questo) su Anyone (Chiunque).

   

   Contatto

Concedi a un utente un ruolo di amministratore

Se vuoi, puoi concedere a un altro utente un ruolo di amministratore in Atlassian.

1. Accedi ad Atlassian utilizzando un account amministratore.

2. Fai clic sull'icona del menu e seleziona la tua organizzazione. In alternativa, puoi andare ad admin.atlassian.com.

3. Nella pagina App, fai clic su (l'icona con tre puntini) accanto a Confluence e seleziona il pulsante Manage users (Gestisci utenti).

   

   Gestisci utenti

4. Fai clic su Groups (Gruppi) in Manage users (Gestione utenti).

5. Nella pagina Groups (Gruppi):

   1. Fai clic su Crea gruppo.
   2. Inserisci un nome per il gruppo.

   

   Crea gruppo

   Questo gruppo riceve le autorizzazioni richieste dal connettore. Gli utenti aggiunti a questo gruppo ereditano queste autorizzazioni. Il connettore utilizza questo gruppo per autenticarsi e recuperare i documenti.

6. Nella pagina del gruppo, fai clic su Add product (Aggiungi prodotto).

   1. Seleziona User access admin (Amministratore accesso utente) come ruolo del prodotto.

   2. Fai clic su Aggiungi.

      

      Amministratore dell'accesso utente di Confluence

7. Fai clic su Add group members (Aggiungi membri del gruppo) per aggiungere un account utente o membri del gruppo che il connettore utilizza per l'autenticazione.

   

   Aggiungere membri al gruppo

Installare e configurare User Identity Accessor per Confluence Cloud

Se gli indirizzi email degli utenti non sono accessibili pubblicamente per impostazione predefinita a causa delle impostazioni della privacy in Confluence Cloud, devi installare l'app User Identity Accessor per Confluence Cloud per recuperare in modo sicuro gli indirizzi email degli utenti. Se gli indirizzi email degli utenti sono già visibili pubblicamente, potresti non dover installare l'app. Per ulteriori informazioni sulla visibilità limitata delle email, vedi Gestire la visibilità degli utenti e concedere ruoli.

Ruoli e autorizzazioni

Per installare e configurare l'app User Identity Accessor per Confluence Cloud, devi disporre del ruolo amministrativo appropriato e concedere le autorizzazioni a livello di app richieste.

• Ruolo richiesto: devi essere un Confluence Site administrator per installare e configurare l'app.
• Autorizzazioni a livello di app: devi concedere le seguenti autorizzazioni durante l'installazione dell'app:
  • Read Email Address: consente all'app di recuperare in modo sicuro gli indirizzi email degli utenti, anche quando la visibilità del profilo è limitata.
  • App Storage scope: consente all'app di leggere e scrivere sul dispositivo di archiviazione.

Installa User Identity Accessor per Confluence Cloud

Per installare l'app User Identity Accessor per Confluence Cloud sul tuo sito Confluence, segui questi passaggi:

1. Vai all'Atlassian Developer Console.

2. Rivedi le autorizzazioni Read Email Address (Leggi indirizzo email) e App Storage scope (Ambito di archiviazione app) e fai clic su Get app (Scarica app).

   

   Rivedi le autorizzazioni e scarica l'app

3. Dall'elenco Select a site to install this app on (Seleziona un sito su cui installare questa app), seleziona il sito Confluence su cui vuoi installare l'app. Questo elenco mostra solo i siti per cui hai accesso amministrativo.

   Nota: per installare l'app, devi essere amministratore di almeno un sito Confluence.

4. Fai clic su Install (Installa) per completare l'installazione dell'app.

Configura User Identity Accessor per Confluence Cloud

Dopo aver installato l'app User Identity Accessor per Confluence Cloud, configura una chiave API che il tuo sistema esterno (ad esempio, il tuo connettore Confluence Cloud) utilizza per chiamare in modo sicuro il webtrigger dell'app per recuperare le email.

Accedi alla pagina di configurazione

Per accedere alla pagina di configurazione dell'app User Identity Accessor per Confluence Cloud in Confluence Cloud, segui questi passaggi:

1. Nella tua istanza Confluence Cloud, fai clic sull'icona Settings (Impostazioni) ⚙️ nel menu di navigazione.
2. Seleziona Apps (App) dal menu.
3. Nella pagina Apps administration (Amministrazione app), individua l'app User Identity Accessor per Confluence Cloud nell'elenco Manage apps (Gestisci app).

4. Fai clic su Configure (Configura) o sul link associato alla tua app. Si apre la pagina di configurazione dedicata dell'app in Confluence.

   

   Configurare l'app User Identity Accessor per Confluence Cloud

Configurare la chiave API

Per configurare la chiave API nella pagina di configurazione, segui questi passaggi:

1. Nella sezione API Key Configuration (Configurazione chiave API), specifica la chiave segreta per autenticare le richieste al webtrigger dell'app. Puoi autenticare le richieste utilizzando uno dei seguenti metodi:

   • Enter your own key (Inserisci la tua chiave): digita o incolla la tua chiave API univoca e complessa nel campo Chiave API. Utilizza una chiave di almeno 20-30 caratteri con una combinazione di lettere maiuscole, minuscole, numeri e simboli.

     

     Inserisci la tua chiave

   • Generate a key: fai clic sul pulsante Generate a key (Genera nuova chiave). Il sistema genera e visualizza una chiave casuale complessa nel campo.

     

     Genera una chiave

     Importante: copia immediatamente la chiave API visualizzata nel campo. Per motivi di sicurezza, potresti non essere in grado di visualizzare di nuovo la chiave completa dopo averla salvata o dopo aver abbandonato la pagina. In caso di perdita, devi impostarne o generarne uno nuovo.

2. Fai clic su Save API Key (Salva chiave API). Un messaggio di operazione riuscita conferma che la chiave è stata salvata in modo sicuro.

Nota: la chiave API generata o creata in questa sezione funge da valore per il campo Confluence Identity Sync Forge Client Secret (Client secret Forge per la sincronizzazione delle identità in Confluence) nella sezione Advanced Options (Opzioni avanzate) durante la configurazione del connettore.

Testa la configurazione dell'app

Verifica che l'app User Identity Accessor per Confluence Cloud sia configurata correttamente inviando una richiesta dal tuo sistema esterno e confermando che gli indirizzi email degli utenti vengano restituiti correttamente.

Recupera l'URL del webtrigger

1. Nella pagina Apps administration (Amministrazione app), individua la sezione Webtrigger URL (URL webtrigger), che mostra l' URL univoco specifico per il tuo sito Confluence e l'installazione di questa app:
   • Il tuo sistema esterno deve chiamare questo URL per richiedere le email degli utenti.
   • In genere, l'URL ha il seguente aspetto: http://uuid/domain.net/x1/randomId. Ad esempio, https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/WEBTRIGGER_ID, dove YOUR_INSTANCE_ID è l'identificatore dell'istanza Confluence Cloud e WEBTRIGGER_ID è l'identificatore unico dell'endpoint webtrigger generato per la tua app.
2. Fai clic sul pulsante Copy URL (Copia URL) o copia l'intero URL.

Configura il sistema esterno

• Configura il tuo sistema esterno che deve recuperare le email degli utenti Confluence con la chiave API e l'URL del webtrigger ottenuti nei passaggi precedenti.

  • URL endpoint: l'URL del webtrigger che hai copiato.
  • Metodo HTTP: POST

  • Intestazioni obbligatorie:

    • Tipo di contenuti: application/json

    • X-Api-Key: YOUR_API_KEY

      Sostituisci YOUR_API_KEY con la chiave API che hai impostato o generato nella sezione Configurare la chiave API.

Comando curl di esempio

Questo esempio mostra la chiamata al web trigger User Identity Accessor per Confluence Cloud, che accetta un array di ID account e restituisce gli indirizzi email.

curl --location --request POST 'https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/ENDPOINT_PATH' \
--header 'X-Api-Key: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "accountIds": [
       "ACCOUNT_ID_1",
       "ACCOUNT_ID_2"
   ]
}'

Sostituisci:

• YOUR_INSTANCE_ID con l'ID istanza Confluence Cloud
• ENDPOINT_PATH con il percorso dell'endpoint API
• YOUR_API_KEY con la chiave API che hai impostato o generato nella sezione Configura la chiave API
• ACCOUNT_ID con gli ID account Atlassian che desideri come target

Risposta prevista

[{"accountId":"ACCOUNT_ID_1","emailAddress":"EMAIL_ADDRESS_1"},
 {"accountId":"ACCOUNT_ID_2","emailAddress":"EMAIL_ADDRESS_2"}]

Sostituisci:

• ACCOUNT_ID_X con gli ID account Atlassian effettivi
• USER_EMAIL_X con gli indirizzi email degli utenti restituiti dalla chiamata API

Implementa le best practice per la sicurezza

Per confermare la sicurezza della tua chiave API, segui questi suggerimenti:

• Memorizza la chiave API in modo sicuro nella configurazione del connettore Confluence Cloud.
• Verifica che tutte le comunicazioni con l'URL webhook avvengano tramite HTTPS. Questo è il valore predefinito per i web trigger User Identity Accessor per Confluence Cloud.

Supporto per User Identity Accessor per Confluence Cloud

Le offerte di assistenza sono disponibili a partire da Google per l'app User Identity Accessor per Confluence Cloud, che può includere la manutenzione e aggiornamenti regolari per mantenere l'app aggiornata. Se riscontri problemi o hai domande specifiche sulle funzionalità dell'app, contatta l'assistenzaGoogle Cloud .

Gestisci i datastore Confluence Cloud

Questa sezione fornisce istruzioni su come creare, aggiornare ed eseguire l'upgrade di un datastore Confluence Cloud.

Crea un datastore Confluence Cloud

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Confluence Cloud a Gemini Enterprise, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Fai clic su Create data store (Crea datastore).

4. Nella pagina Select a data source (Seleziona un'origine dati), scorri o cerca Confluence Cloud per connettere l'origine di terze parti.

5. Nella pagina Specify the Confluence Cloud for your data store (Specifica l'origine Confluence Cloud per il datastore), esegui le seguenti operazioni:

   1. Seleziona il metodo di autenticazione:

      

      Inserisci i dettagli di autenticazione

      • Per utilizzare OAuth per l'autenticazione, seleziona OAuth 2.0 Client Credentials (Credenziali client OAuth 2.0) e poi specifica l'URI dell'istanza, l'ID istanza, l'ID client e il client secret.

        • Fai clic su Login (Accedi) e scegli un sito per l'app.
        • Fai clic su Accetto.

        Il tempo di scadenza predefinito per un token di aggiornamento è di 365 giorni. Se il token di aggiornamento scade o viene revocato, puoi procedere in uno dei seguenti modi:

        • Riavviare il flusso OAuth. L'utente che esegue la riautenticazione deve disporre dei privilegi amministrativi.
        • Utilizzare il token di aggiornamento per ottenere una nuova coppia di token di accesso e token di aggiornamento.

        Per maggiori informazioni, vedi Il token di accesso scade o viene revocato.

        

        Scegli un sito su cui utilizzare l'app

      • Per utilizzare il token API per l'autenticazione, seleziona API Token (Token API) e poi specifica l'URI dell'istanza, il nome utente Confluence e il token API.

   2. Fai clic su Continua.

6. (Facoltativo) Nella sezione Advanced options (Opzioni di notifica), segui questi passaggi:

   1. Per inserire nella lista consentita solo un insieme di indirizzi IP statici, seleziona la casella di controllo Enable Static IP Addresses (Abilita indirizzi IP statici).
   2. Per applicare limiti di frequenza alle query che i connettori inviano all'istanza Confluence, specifica il numero massimo di query al secondo nel campo Max QPS (QPS max). Il valore predefinito è 20 QPS. Puoi aumentare gradualmente il valore QPS in base al rendimento del server Confluence. Prima di aumentare il valore QPS, tieni presente quanto segue:
      • Il carico esistente sul server Confluence.
      • Il throughput di altre applicazioni di terze parti che utilizzano il server.
   3. Nel campo Confluence Identity Sync Forge URL (URL di sincronizzazione delle identità di Confluence Forge), inserisci l'URL generato dall'app User Identity Accessor per Confluence Cloud.
   4. Nel campo Confluence Identity Sync Forge Client Secret (Client secret Forge per la sincronizzazione delle identità in Confluence), inserisci il client secret configurato in User Identity Accessor per Confluence Cloud, ovvero la chiave API che hai generato o creato nella sezione Configura la chiave API.

7. Nella sezione Entities to sync (Entità da sincronizzare), segui questi passaggi:

   1. Seleziona le entità da sincronizzare:

      • Pagina

      • Lavagna

      • Blog

      • Allegato

      • Commento

      I dati vengono importati in base alle autorizzazioni di amministratore che hai quando crei il datastore. Oltre alle autorizzazioni di amministratore, devi disporre anche dell'accesso ai record di entità specifici, come blog o post.

      Nota: quando sincronizzi l'entità Page (Pagina), vengono sincronizzati anche i contenuti del documento live.

      

      Seleziona le entità da sincronizzare

   2. (Facoltativo) Per sincronizzare da spazi specifici, segui questi passaggi:

      1. Fai clic su Filter (Filtro).
      2. Per filtrare le entità dall'indice, seleziona Exclude from the index (Escludi dall'indice) o, per assicurarti che siano incluse nell'indice, seleziona Include to the index (Includi nell'indice).
      3. Inserisci le chiavi dello spazio. Premi Invio dopo ogni barra spaziatrice.
      4. Fai clic su Salva.

   

   Specifica i filtri per includere o escludere le entità.

8. Fai clic su Continua.

9. Seleziona la Sync frequency (Frequenza di sincronizzazione) per la Full Sync (Sincronizzazione completa) e la Incremental sync frequency (Frequenza di sincronizzazione incrementale) per la Incremental data sync (Sincronizzazione incrementale dei dati). Per saperne di più, vedi Pianificazioni di sincronizzazione.

   Se vuoi pianificare sincronizzazioni complete separate dei dati di entità e identità, espandi il menu in Full Sync (Sincronizzazione completa) e seleziona Custom options (Opzioni personalizzate).

   

   Impostazione di pianificazioni separate per la sincronizzazione completa delle entità e la sincronizzazione completa delle identità.

10. Seleziona una regione per il connettore dati.

11. Inserisci un nome per il tuo connettore dati.

12. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Data Stores (Datastore).

13. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Data (Dati). Lo stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato cambia in Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Aggiornare il datastore

Puoi aggiornare i seguenti parametri del datastore:

• Nome datastore
• Credenziali di autenticazione, come ID client, client secret, account utente e token API.
• Parametri QPS max e dell'app Forge, come l'URL di sincronizzazione delle identità di Confluence Forge e il client secret.
• Frequenza di sincronizzazione completa, frequenza di sincronizzazione incrementale e sincronizzazione in tempo reale.
• Condizione di filtro per l'importazione dei dati delle entità.

Per aggiornare il datastore:

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Nel menu di navigazione, fai clic su Datastore.

3. Fai clic sul nome del datastore da aggiornare.

4. Aggiorna i seguenti valori:

   • Per aggiornare il nome del datastore, la frequenza di sincronizzazione completa o la frequenza di sincronizzazione incrementale, fai clic sull'icona Edit (Modifica) .
   • Per aggiornare la frequenza di sincronizzazione in tempo reale, fai clic su View/Edit (Visualizza/modifica) accanto a Real-time sync (Sincronizzazione in tempo reale).
   • Per aggiornare le credenziali di autenticazione, fai clic su Re-authenticate (Esegui di nuovo l'autenticazione) e poi specifica i valori.
   • Per aggiornare i parametri QPS max o dell'app Forge, fai clic su View/edit Parameters (Visualizza/modifica parametri), quindi specifica i valori.
   • Per aggiornare la condizione di filtro per le entità, nella sezione Entities (Entità), fai clic su Edit parameters (Modifica parametri) e poi su Filters (Filtri).

Esegui l'upgrade a un nuovo datastore

Se riscontri problemi con l'accuratezza dei risultati di ricerca delle entità pagina, esegui le seguenti operazioni per eseguire l'upgrade all'ultima versione del datastore:

1. Identifica se utilizzi l'ultima versione del datastore:
   1. Nel menu di navigazione, fai clic su Data Stores (Datastore).
   2. Fai clic sul nome del datastore.
   3. Nella pagina dei dettagli del datastore visualizzata, fai clic sull'entità Page (Pagina) nella scheda Entities (Entità).
   4. Nella pagina Data (Dati), controlla il valore del campo Type (Tipo). Se il valore è Unstructured data, viene utilizzata l'ultima versione del datastore e non è richiesta alcuna azione. Se il valore è Structured data, procedi con i seguenti passaggi per creare il nuovo datastore ed eseguire la migrazione.
2. Crea un nuovo datastore.
3. Assicurati che venga completata una sincronizzazione completa per il nuovo datastore con i dati richiesti.
4. Aggiungi il nuovo datastore all'app.
5. Metti in pausa le sincronizzazioni nel datastore precedente.
6. Dopo aver verificato che il nuovo datastore funzioni come previsto per la ricerca delle entità pagina, elimina il datastore precedente dall'app.

Abilita sincronizzazione in tempo reale

Anteprima: devi essere nella lista consentita per utilizzare questa funzionalità.

La sincronizzazione in tempo reale sincronizza solo le entità documento e non i dati correlati alle entità identità. La tabella seguente mostra gli eventi dei documenti supportati con la sincronizzazione in tempo reale.

Entità Confluence	Crea	Aggiornamento	Elimina	Modifiche alle autorizzazioni
Spazi
Pagine
Blog
Allegati
Commenti
Lavagne

Abilita la sincronizzazione in tempo reale 20 minuti dopo aver creato il datastore Confluence Cloud. Per abilitare la sincronizzazione in tempo reale per un'origine dati Confluence:

Genera un URL webhook

1. Vai alla pagina Gemini Enterprise e fai clic su Data Stores (Datastore) nel menu di navigazione.
2. Seleziona un datastore Confluence.

3. Fai clic su View/Edit (Visualizza/Modifica) nella riga Realtime sync (Sincronizzazione in tempo reale).

   

   Sincronizzazione in tempo reale : stato disattivato

4. Nella finestra di dialogo View and edit realtime sync parameters (Visualizza e modifica i parametri di sincronizzazione in tempo reale), procedi nel seguente modo:

   1. Per attivare la sincronizzazione in tempo reale, fai clic sul pulsante di attivazione/disattivazione Enable realtime sync (Abilita sincronizzazione in tempo reale).
   2. Nel campo Client secret, inserisci un valore segnaposto, ad esempio clientsecret.
   3. Fai clic su Salva.

      

      Abilita sincronizzazione in tempo reale

5. Dopo che lo stato di Realtime sync (Sincronizzazione in tempo reale) cambia in Running, fai clic su View/Edit (Visualizza/Modifica).

   

   Sincronizzazione in tempo reale : stato di esecuzione

6. Nella finestra di dialogo View and edit realtime sync parameters (Visualizza e modifica i parametri di sincronizzazione in tempo reale), procedi nel seguente modo:

   1. Copia l'URL webhook.
   2. Fai clic su Chiudi.

      

      Copia l'URL del webhook

Iscriviti agli eventi utilizzando l'API

Per ricevere aggiornamenti in tempo reale da Confluence, devi iscriverti a eventi specifici utilizzando una richiesta POST. Per effettuare chiamate API, utilizza lo stesso account amministratore utilizzato per configurare l'autenticazione e le autorizzazioni in Confluence per creare l'datastore.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

• INSTANCE_URL: l'indirizzo web di base del tuo sito Atlassian Cloud.

• USERNAME: il nome utente Atlassian Cloud.

• API_TOKEN: il token API generato dal tuo account Atlassian. Per scoprire di più, consulta Configura un token API in Confluence.

• SUBSCRIPTION_NAME: nome univoco per l'iscrizione agli eventi.

• LISTENER_URL: l'URL webhook copiato dalla console Google Cloud una volta attivata la sincronizzazione in tempo reale (RTS, Real-Time Sync) nel datastore.

• EVENT_TYPE: i tipi di eventi a cui vuoi iscriverti. Puoi abbonarti per creare, aggiornare ed eliminare eventi per allegati, post del blog, pagine, spazi e commenti.

  L'utente può iscriversi ai seguenti eventi:

  • space_created
  • space_updated
  • page_created
  • page_updated
  • attachment_created
  • attachment_updated
  • comment_created
  • comment_updated
  • blog_created
  • blog_updated
  Nota: gli eventi Whiteboard e trashed non sono supportati. Crea abbonamenti solo per le entità già aggiunte al datastore per evitare di importare dati indesiderati.

  Esempio di comando e risultato

  curl -X POST \
      https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
      -H "Content-Type: application/json" \
      -u "admin1:######" \
      -d '{
        "name": "Cymbal_DCT",
        "events": [
          "attachment_created",
          "attachment_updated"
        ],
        "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
        "active": true
      }'
  
  {
  "name": "Cymbal_DCT",
  "url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
  "description": " Webhook for Cymbal DCT group to fetch attachments.",
  "excludeBody": false,
  "filters": {},
  "events": [
      "attachment_created",
      "attachment_updated",
  ],
  "enabled": true,
  "self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
  "lastUpdatedUser": "Cymb_389",
  "lastUpdatedDisplayName": "Ariel",
  "lastUpdated": 1752095647212
  }
  

Codici di errore API

Questa tabella elenca i codici di errore API comuni che gli utenti riscontrano durante la creazione di webhook.

Classe di errore	Codice di errore	Messaggio di errore	Risoluzione dei problemi
403	FORBIDDEN	L'utente corrente non è autorizzato a utilizzare Confluence.	Assicurati di avere un token valido da un account amministratore e un endpoint API corretto.

Messaggi di errore

La seguente tabella descrive i messaggi di errore comuni, le relative descrizioni e le possibili soluzioni quando colleghi Confluence Cloud a Gemini Enterprise.

Codice di errore	Messaggio di errore	Descrizione	Risoluzione dei problemi
CONFLUENCE_INVALID_AUTHENTICATION_1	Errore di autenticazione. Ulteriori informazioni:	Il connettore non può essere autenticato con Confluence Cloud.	Esegui nuovamente l'autenticazione del datastore con le credenziali dell'amministratore.
CONFLUENCE_INVALID_AUTHORIZATION_1	Errore di autorizzazione. Ulteriori informazioni:	Un account utente senza privilegi amministrativi ha tentato di accedere a Confluence Cloud.	Esegui nuovamente l'autenticazione del datastore utilizzando le credenziali dell'amministratore.
CONFLUENCE_TOO_MANY_REQUEST	Troppe richieste HTTP 429 a Confluence Cloud.	Il numero di richieste inviate dal connettore supera il valore QPS predefinito.	Se il problema persiste, riduci il valore QPS del datastore utilizzando il campo Max QPS (QPS max).

Limitazioni note

• Il modello di gestione utenti legacy non è supportato per l'integrazione con Confluence Cloud. È supportato solo il modello di gestione centralizzata degli utenti. Per ulteriori informazioni, vedi la guida al consolidamento dell'organizzazione Atlassian.
• L'aspetto delle macro che hai aggiunto alle pagine Confluence può variare da utente a utente in base alle autorizzazioni di accesso.
• Questo connettore non supporta la sincronizzazione incrementale per l'entità Spazi.
• Non puoi utilizzare un service account Google Cloud per l'autenticazione in Confluence Cloud.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Crea un'app.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app e del datastore, consulta Visualizzare l'anteprima dei risultati di ricerca.

• Per abilitare gli avvisi per il datastore, vedi Configura gli avvisi per i datastore di terze parti.