Configurare un datastore Confluence Cloud

Questa pagina descrive come creare un datastore e collegare Confluence Cloud a Gemini Enterprise.

Prima di iniziare

Prima di configurare la connessione federata Confluence Cloud, assicurati di quanto segue:

  • 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 Modifica Modifica.
    3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

  • Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Google Gemini Enterprise, configura il tuo provider di identità.

  • Per configurare il connettore Confluence Cloud, devi utilizzare il nuovo modello di gestione centralizzata degli utenti Atlassian. Se utilizzi il modello originale, devi eseguire la migrazione della gestione utenti prima di procedere. Per saperne di più, vedi Ruolo di amministratore del sito.

  • Crea un'app OAuth 2.0, ottieni l'ID client e il client secret e configura le autorizzazioni minime dell'applicazione con il consenso di un amministratore di Confluence Cloud.

  • (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 con i privilegi di amministratore del sito di Confluence, quindi configurala per recuperare in modo sicuro gli indirizzi email degli utenti. Potresti non dover installare questa app se gli indirizzi email sono già accessibili pubblicamente.

Crea datastore Confluence Cloud

Per creare un datastore Confluence Cloud, segui questi passaggi:

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

    Gemini Enterprise

  2. Seleziona o crea un Google Cloud progetto.

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

  4. Fai clic su Crea datastore.

  5. Nella sezione Origine, cerca Confluence Cloud e fai clic su Seleziona.

  6. Nella sezione Dati:

    1. Nella sezione Modalità connettore, seleziona Importazione dati o Ricerca federata come modalità di connessione.

    2. Fai clic su Continua.

    3. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta.

      1. Se hai selezionato Importazione dati:

        1. Seleziona Credenziali client OAuth 2.0 o Token API come metodo di autenticazione.
        2. Se selezioni Credenziali client OAuth 2.0, inserisci i seguenti dettagli:
          • ID client
          • Client secret
          • URI istanza
          • ID istanza
        3. Se selezioni Token API, inserisci i seguenti dettagli:
          • URI istanza
          • Account utente
          • Token API

      2. Se hai selezionato Ricerca federata:

        1. Credenziali client OAuth 2.0 è l'unico metodo applicabile. Fornisci i seguenti dettagli:
          • ID client
          • Client secret
          • URI istanza

      Per saperne di più sulle credenziali, consulta Configurazione di Confluence Cloud.

      1. Fai clic su Accedi e completa l'accesso ad Atlassian.

    4. Fai clic su Continua.

    5. Nella sezione Destinazioni, inserisci l'URL dell'endpoint Confluence Cloud.

    6. Fai clic su Continua.

    7. Nella sezione Entities to sync (Entità da sincronizzare) (se hai selezionato Data ingestion (Importazione dati)) o Entities to search (Entità da cercare) (se hai selezionato Federated search (Ricerca federata)):

      1. Seleziona tutte le entità richieste.
      2. (Facoltativo) Per sincronizzare progetti specifici, segui questi passaggi:
        1. Fai clic su Filtro.
        2. Per filtrare le entità dall'indice, seleziona Escludi dall'indice o, per assicurarti che siano incluse nell'indice, seleziona Includi nell'indice.
        3. Inserisci le chiavi dello spazio. Premi Invio dopo ogni barra spaziatrice.
        4. Fai clic su Salva.

      3. Se hai selezionato Importazione dei dati, per configurare la pianificazione della sincronizzazione:

        1. Nell'elenco Frequenza di sincronizzazione, seleziona la frequenza di sincronizzazione.

          • Per pianificare sincronizzazioni complete separate dei dati di entità e identità, espandi il menu nella sezione Full Sync (Sincronizzazione completa) e seleziona Custom options (Opzioni personalizzate).

        2. Nell'elenco Frequenza di sincronizzazione incrementale, seleziona la frequenza di sincronizzazione incrementale.

      Per saperne di più, vedi Pianificazioni di sincronizzazione.

  7. Fai clic su Continua.

  8. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
    2. Nel campo Nome connettore dati, inserisci un nome per il connettore.
    3. Se hai selezionato US o EU come posizione, configura le impostazioni di crittografia:
      • (Facoltativo) Se non hai configurato le chiavi a singola regione, fai clic su Vai alla pagina delle impostazioni per farlo. Per saperne di più, consulta Registrare una chiave a singola regione per i connettori di terze parti.
      • Seleziona Chiave di crittografia gestita daGoogle o Chiave Cloud KMS.
      • Se hai selezionato Chiave Cloud KMS:
        • Nell'elenco Tipo di gestione delle chiavi, seleziona il tipo appropriato.
        • Nell'elenco Chiave Cloud KMS, seleziona la chiave.
      Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

  9. Fai clic su Continua.

  10. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

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

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creazione ad Attivo, il connettore Confluence Cloud è pronto per essere utilizzato.

Per un connettore di importazione creato con Confluence Cloud, lo stato del datastore passa da Creazione a In esecuzione all'avvio della sincronizzazione. Dopodiché, lo stato diventa Attivo al termine dell'importazione, a indicare che il datastore è completamente configurato. A seconda del volume di dati, l'importazione potrebbe richiedere diverse ore.

Dopo aver creato il datastore, crea un'app, collegala al datastore Confluence Cloud e autorizza Gemini Enterprise ad accedere a Confluence Cloud prima di eseguire qualsiasi query.

Abilitare la sincronizzazione in tempo reale per l'importazione dei dati

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 Aggiorna 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).
  4. Nella finestra di dialogo 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.
  5. Dopo che lo stato di Realtime sync (Sincronizzazione in tempo reale) cambia in Running, fai clic su View/Edit (Visualizza/Modifica).
  6. Nella finestra di dialogo Visualizza e modifica i parametri di sincronizzazione in tempo reale, procedi nel seguente modo:
    1. Copia l'URL webhook.
    2. Fai clic su Chiudi.

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

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.

Gestione dei dati ed esecuzione delle query

Questa sezione descrive come Gemini Enterprise gestisce la tua query e le implicazioni per la privacy dell'utilizzo del datastore federato.

Esecuzione delle query

Dopo aver autorizzato Confluence Cloud e inviato una query di ricerca a Gemini Enterprise:

  • Gemini Enterprise invia la query di ricerca direttamente all'API Atlassian.
  • Gemini Enterprise combina i risultati con quelli di altre origini dati connesse e mostra un risultato di ricerca completo.

Gestione dei dati

Quando utilizzi la ricerca federata di terze parti, si applicano le seguenti regole di gestione dei dati:

  • La stringa di query viene inviata al backend di ricerca di terze parti (API Atlassian).
  • Queste terze parti potrebbero associare le query alla tua identità.
  • Se sono abilitate più origini dati di ricerca federata, la query potrebbe essere inviata a tutte.
  • Una volta che i dati raggiungono il sistema di terze parti, sono regolati dai termini di servizio e dalle norme sulla privacy di quel sistema.

Passaggi successivi