Atlassian Confluence
Översikt
Confluence-anslutningen möjliggör en säker koppling mellan Siesta AI-plattformen och Atlassian Confluence via det officiella API:et. Integrationen ger kontrollerad åtkomst till innehållet i Confluence-området och möjliggör:
- sökning av sidor,
- hämtning av dokumentationsinnehåll,
- programmatisk skapande av nya sidor,
- uppdatering av befintliga sidor.
Anslutningen är utformad för företagsanvändning med fokus på hantering av behörigheter, regelefterlevnad och säkerhet för datatillgång.
Krav
- Aktiv Confluence Cloud-webbplats.
- Installerad app SiestaAI i Atlassian (Anslutna appar).
- Administratörsbehörighet för att hantera anslutningen i Siesta AI.
Stödda operationer
| Operation | Beskrivning |
|---|---|
SearchPagesAsync | Fulltextsökning av sidor inom det valda Confluence-området |
GetPageAsync | Hämtning av sidinnehåll inklusive metadata |
CreatePageAsync | Skapande av nya sidor i Confluence |
UpdatePageAsync | Uppdatering av befintliga sidor |
Hantering av behörigheter
Varje operation kan ställas in separat:
- Tillåten – operationen är tillgänglig utan begränsningar.
- Tillåten med bekräftelse – operationen kräver manuell godkännande.
- Förbjuden – operationen är inte tillgänglig.
Denna modell möjliggör en exakt definition av åtkomstområdet, t.ex. för:
- endast läsassistenter,
- automatiserade dokumentationsprocesser,
- kontrollerade skrivningar till Confluence.
Konfigurationsparametrar
Obligatoriska parametrar
| Parameter | Beskrivning |
|---|---|
| Integrationsnamn | Intern beteckning för kopplingen |
| Confluence webbplats URL | URL till Atlassian-instansen (t.ex. https://firma.atlassian.net) |
| Space key | Nyckel för det mål Confluence-området (t.ex. ITOPS, DEV) |
Åtkomstläge
- Delad – integrationen är tillgänglig inom organisationen eller teamet.
- Privat – integrationen är endast tillgänglig för ägaren.
Steg för att lägga till Confluence-kopplingen
Öppna integrationshantering
I Siesta AI-administrationen, gå till Administration → Anslutna appar.
Välj Confluence
I dialogrutan Lägg till integration välj Confluence och fortsätt.
Konfigurera integrationen
Fyll i:
- Integrationsnamn
- Confluence webbplats URL
- Space key
- Åtkomstläge
Bekräfta skapandet av integrationen.
Ställ in behörigheter
Efter att integrationen har skapats, öppna Behörighetsinställningar och ställ in tillåtna operationer.
Rekommendation: ställ in skrivoperationer på Tillåten med bekräftelse.
Typiska användningsscenarier
Intern kunskapsbas
- Sökning i intern dokumentation
- Svara på anställdas frågor
- Centraliserad åtkomst till aktuell information
Automatisering av dokumentation
- Generering av release notes
- Skapande av mötesprotokoll
- Uppdatering av driftsprocedurer (SOP)
Koppling av processer
- Synkronisering av Jira → Confluence
- Automatisk skapande av rapporter
- Dokumentation av incidenter och revisionsposter
Säkerhetsarkitektur
Integrationen använder:
- auktoriserad åtkomst via Atlassian API,
- begränsningar till specifika Confluence-områden,
- granulär hantering av operationers behörigheter,
- möjlighet till granskning av aktiviteter.
Det sker ingen obehörig nedladdning av innehåll eller kringgående av säkerhetsmekanismerna i Atlassian-plattformen.
Rekommenderad driftskonfiguration
- Tillåt läsning utan begränsningar.
- Ställ in skrivoperationer på Tillåten med bekräftelse.
- Använd separata områden för automatiserad dokumentation.
- Kontrollera regelbundet behörigheterna för anslutningen.