Atlassian Confluence
Oversikt
Confluence-tilkoblingen muliggjør en sikker tilkobling mellom Siesta AI-plattformen og Atlassian Confluence via det offisielle API-et. Integrasjonen gir kontrollert tilgang til innholdet i Confluence-rommet og gjør det mulig å:
- søke etter sider,
- laste inn dokumentasjonsinnhold,
- programmatisk opprette nye sider,
- oppdatere eksisterende sider.
Tilkoblingen er designet for bedriftsbruk med fokus på tilgangskontroll, revideringsevne og datasikkerhet.
Krav
- Aktiv Confluence Cloud-side.
- Installert applikasjon SiestaAI i Atlassian (Connected apps).
- Administratorrettigheter for å administrere tilkoblingen i Siesta AI.
Støttede operasjoner
| Operasjon | Beskrivelse |
|---|---|
SearchPagesAsync | Fulltekst søk etter sider innen valgt Confluence-rom |
GetPageAsync | Laste inn innholdet på en side inkludert metadata |
CreatePageAsync | Opprette nye sider i Confluence |
UpdatePageAsync | Oppdatere eksisterende sider |
Tilgangskontroll
Hver operasjon kan settes opp individuelt:
- Tillatt – operasjonen er tilgjengelig uten begrensninger.
- Tillatt med bekreftelse – operasjonen krever manuell godkjenning.
- Forbudt – operasjonen er ikke tilgjengelig.
Denne modellen gjør det mulig å nøyaktig definere omfanget av tilgang, for eksempel for:
- kun leseassistenter,
- automatiserte dokumentasjonsprosesser,
- kontrollerte innføringer i Confluence.
Konfigurasjonsparametere
Obligatoriske parametere
| Parameter | Beskrivelse |
|---|---|
| Navn på integrasjon | Intern betegnelse for tilkoblingen |
| Confluence site URL | URL til Atlassian-instansen (f.eks. https://firma.atlassian.net) |
| Space key | Nøkkel for det målrettede Confluence-rommet (f.eks. ITOPS, DEV) |
Tilgangsmodus
- Delt – integrasjonen er tilgjengelig innen organisasjonen eller teamet.
- Privat – integrasjonen er kun tilgjengelig for eieren.
Fremgangsmåte for å legge til Confluence-tilkobling
Åpne integrasjonsadministrasjonen
I Siesta AI-administrasjonen, gå til Administration → Connected Apps.
Velg Confluence
I dialogboksen Legg til integrasjon, velg Confluence og fortsett.
Konfigurere integrasjonen
Fyll ut:
- Navn på integrasjon
- Confluence site URL
- Space key
- Tilgangsmodus
Bekreft opprettelsen av integrasjonen.
Angi tillatelser
Etter opprettelsen av integrasjonen, åpne Innstillinger for tillatelser og angi tillatte operasjoner.
Anbefaling: sett skriveoperasjoner til Tillatt med bekreftelse.
Typiske bruksområder
Intern kunnskapsbase
- Søking i intern dokumentasjon
- Svar på ansattes forespørsel
- Sentralisert tilgang til oppdatert informasjon
Automatisering av dokumentasjon
- Generering av release-notater
- Oppretting av møtereferater
- Oppdatering av driftsprosedyrer (SOP)
Kobling av prosesser
- Synkronisering av Jira → Confluence
- Automatisk oppretting av rapporter
- Dokumentasjon av hendelser og revisjonslogger
Sikkerhetsarkitektur
Integrasjonen bruker:
- autorisert tilgang via Atlassian API,
- begrensning til spesifikke Confluence-rom,
- granulær kontroll av operasjonstillatelser,
- mulighet for revisjon av aktiviteter.
Det skjer ingen uautorisert nedlasting av innhold eller omgåelse av sikkerhetsmekanismer i Atlassian-plattformen.
Anbefalt driftskonfigurasjon
- Tillat lesing uten begrensninger.
- Sett skriveoperasjoner til Tillatt med bekreftelse.
- Bruk separate rom for automatisert dokumentasjon.
- Kontroller regelmessig tillatelsene for tilkoblingen.