Confluence
Oversigt
Confluence-forbindelsen muliggør en sikker forbindelse mellem Siesta AI-platformen og Atlassian Confluence via det officielle API. Integration giver kontrolleret adgang til indholdet af Confluence-rummet og muliggør:
- søgning efter sider,
- indlæsning af dokumentationsindhold,
- programmatisk oprettelse af nye sider,
- opdatering af eksisterende sider.
Forbindelsen er designet til enterprise-brug med fokus på styring af rettigheder, revidérbarhed og sikker adgang til data.
Krav
- Aktiv Confluence Cloud site.
- Atlassian-konto, der har adgang til Confluence-rummet/siderne, som forbindelsen skal arbejde med.
- Genereret API-token i Atlassian-kontoen (
id.atlassian.com→ Sikkerhed → API-tokens). - Administratorrettigheder til at administrere forbindelsen i Siesta AI.
Understøttede operationer
| Operation | Beskrivelse |
|---|---|
SearchPagesAsync | Fuldtekst søgning af sider inden for det valgte Confluence-rum |
GetPageAsync | Indlæsning af indholdet af en side inklusive metadata |
CreatePageAsync | Oprettelse af nye sider i Confluence |
UpdatePageAsync | Opdatering af eksisterende sider |
Styring af rettigheder
Hver operation kan indstilles separat:
- Tilladt – operationen er tilgængelig uden begrænsninger.
- Tilladt med bekræftelse – operationen kræver manuel godkendelse.
- Forbudt – operationen er ikke tilgængelig.
Denne model muliggør præcist at definere omfanget af adgang, f.eks. for:
- kun læseagenter,
- automatiserede dokumentationsprocesser,
- kontrollerede indtastninger til Confluence.
Konfigurationsparametre
Obligatoriske parametre
| Parameter | Beskrivelse |
|---|---|
| Navn | Intern betegnelse for forbindelsen |
| ApiKey | API-token genereret i Atlassian-kontoen |
| Confluence site URL | URL til Atlassian-instansen (f.eks. https://firma.atlassian.net) |
| E-mail eller brugernavn på Atlassian-konto | E-mail (eller brugernavn) på kontoen, hvor tokenet blev oprettet |
Procedure for tilføjelse af Confluence-forbindelsen
1) Forbered dine adgangsoplysninger
Før du begynder at oprette forbindelsen i Siesta AI, skal du forberede alle de værdier, du vil indsætte i formularen.
Åbn Sikkerhed og sektionen API Tokens i din Atlassian-konto.
Klik på Opret API-token (uden scopes), indtast navnet på tokenet og udløbsdatoen, og bekræft oprettelsen.
Efter oprettelsen skal du engang kopiere tokenet og gemme det sikkert.
Forbered derefter også:
- Confluence site URL (f.eks.
https://firma.atlassian.net) - E-mail eller brugernavn på Atlassian-kontoen, hvor tokenet blev oprettet
2) Åbn administrationspanelet for integrationer i Siesta AI
I Siesta AIs administration skal du gå til Administration → Forbundne apps.
3) Vælg Confluence
I dialogboksen Tilføj integration skal du vælge Confluence og fortsætte.
4) Udfyld Confluence-formularen
Udfyld:
- Navn
- ApiKey (token fra Atlassian)
- Confluence site URL (f.eks.
https://firma.atlassian.net) - E-mail / brugernavn på Atlassian-kontoen, hvor tokenet blev oprettet
Bekræft oprettelsen af integrationen.
5) Indstil rettigheder for operationer
Efter oprettelsen af integrationen skal du åbne Indstillinger for rettigheder og indstille de tilladte operationer.
Anbefaling: indstil skriveoperationer til Tilladt med bekræftelse.
Vigtig bemærkning om API-token og rettigheder
API-tokenet er knyttet til en specifik Atlassian-konto. Forbindelsen arver derefter rettighederne for denne konto i Confluence (hvad kontoen ikke kan se eller redigere, kan forbindelsen heller ikke).
Derfor anbefales det:
- at hver bruger har sit eget token, hvis forbindelsen kører under deres identitet,
- eller at bruge en dedikeret servicekonto til delte/produktionsautomatiseringer,
- at overvåge udløbet af tokenet og udføre regelmæssig rotation.
Typiske anvendelsesscenarier
Intern vidensbase
- Søgning i intern dokumentation
- Besvarelse af medarbejderspørgsmål
- Centraliseret adgang til aktuelle oplysninger
Automatisering af dokumentation
- Generering af release notes
- Oprettelse af mødenotater
- Opdatering af driftsprocedurer (SOP)
Sammenkobling af processer
- Synkronisering af Jira → Confluence
- Automatisk oprettelse af rapporter
- Dokumentation af hændelser og revisionsoptegnelser
Sikkerhedsarkitektur
Integration bruger:
- autoriseret adgang via Atlassian API,
- begrænsninger til specifikke Confluence-rum,
- granulær styring af operationers rettigheder,
- mulighed for revision af aktiviteter.
Der sker ikke uautoriseret download af indhold eller omgåelse af sikkerhedsforanstaltningerne i Atlassian-platformen.
Anbefalet driftskonfiguration
- Tillad læsning uden begrænsninger.
- Indstil skriveoperationer til Tilladt med bekræftelse.
- Brug separate rum til automatiseret dokumentation.
- Kontroller regelmæssigt rettighederne for forbindelsen.