Atlassian Confluence
Panoramica
La connessione Confluence consente un collegamento sicuro della piattaforma Siesta AI con Atlassian Confluence tramite API ufficiali. L'integrazione fornisce accesso controllato al contenuto dello spazio Confluence e consente di:
- cercare pagine,
- caricare contenuti della documentazione,
- creare nuove pagine programmaticamente,
- aggiornare pagine esistenti.
La connessione è progettata per un uso enterprise con un focus sulla gestione dei permessi, auditabilità e sicurezza nell'accesso ai dati.
Requisiti
- Sito Confluence Cloud attivo.
- Applicazione SiestaAI installata in Atlassian (App collegate).
- Permessi di amministratore per gestire la connessione in Siesta AI.
Operazioni supportate
| Operazione | Descrizione |
|---|---|
SearchPagesAsync | Ricerca full-text delle pagine all'interno dello spazio Confluence selezionato |
GetPageAsync | Caricamento del contenuto della pagina, inclusi i metadati |
CreatePageAsync | Creazione di nuove pagine in Confluence |
UpdatePageAsync | Aggiornamento di pagine esistenti |
Gestione dei permessi
Ogni operazione può essere impostata separatamente:
- Consentito – l'operazione è disponibile senza restrizioni.
- Consentito con conferma – l'operazione richiede approvazione manuale.
- Negato – l'operazione non è disponibile.
Questo modello consente di definire con precisione l'ambito di accesso, ad esempio per:
- assistenti solo in lettura,
- processi di documentazione automatizzati,
- registrazioni controllate in Confluence.
Parametri di configurazione
Parametri obbligatori
| Parametro | Descrizione |
|---|---|
| Nome integrazione | Designazione interna del connettore |
| URL sito Confluence | URL dell'istanza Atlassian (es. https://azienda.atlassian.net) |
| Space key | Chiave dello spazio Confluence di destinazione (es. ITOPS, DEV) |
Modalità di accesso
- Condiviso – l'integrazione è disponibile all'interno dell'organizzazione o del team.
- Privato – l'integrazione è disponibile solo per il proprietario.
Procedura per aggiungere il connettore Confluence
Apertura della gestione delle integrazioni
Nell'amministrazione di Siesta AI, vai su Amministrazione → App collegate.
Selezione di Confluence
Nella finestra di dialogo Aggiungi integrazione, seleziona Confluence e procedi.
Configurazione dell'integrazione
Compila:
- Nome integrazione
- URL sito Confluence
- Space key
- Modalità di accesso
Conferma la creazione dell'integrazione.
Impostazione dei permessi
Dopo aver creato l'integrazione, apri Impostazioni permessi e imposta le operazioni consentite.
Raccomandazione: imposta le operazioni di scrittura su Consentito con conferma.
Scenari tipici di utilizzo
Base di conoscenza interna
- Ricerca nella documentazione interna
- Risposta alle domande dei dipendenti
- Accesso centralizzato alle informazioni aggiornate
Automazione della documentazione
- Generazione di note di rilascio
- Creazione di verbali di riunioni
- Aggiornamento delle procedure operative standard (SOP)
Collegamento dei processi
- Sincronizzazione Jira → Confluence
- Creazione automatica di report
- Documentazione di incidenti e registri di audit
Architettura di sicurezza
L'integrazione utilizza:
- accesso autorizzato tramite API Atlassian,
- restrizioni su uno specifico spazio Confluence,
- gestione granulare dei permessi delle operazioni,
- possibilità di audit delle attività.
Non ci sono download non autorizzati di contenuti né bypass dei meccanismi di sicurezza della piattaforma Atlassian.
Configurazione operativa consigliata
- Consenti la lettura senza restrizioni.
- Imposta le operazioni di scrittura su Consentito con conferma.
- Utilizza spazi separati per la documentazione automatizzata.
- Controlla regolarmente i permessi della connessione.