Confluence
Yhteenveto
Confluence-yhteys mahdollistaa turvallisen yhdistämisen Siesta AI -alustan ja Atlassian Confluencen välillä virallisen API:n kautta. Integraatio tarjoaa hallitun pääsyn Confluence-tilan sisältöön ja mahdollistaa:
- sivujen hakemisen,
- dokumentaation sisällön lataamisen,
- uusien sivujen ohjelmallisen luomisen,
- olemassa olevien sivujen päivittämisen.
Yhteys on suunniteltu yrityskäyttöön, painottaen käyttöoikeuksien hallintaa, auditoitavuutta ja tietojen pääsyn turvallisuutta.
Vaatimukset
- Aktiivinen Confluence Cloud -sivusto.
- Atlassian-tili, jolla on pääsy Confluence-tilaan/sivuille, joiden kanssa liitin toimii.
- Generoitu API-tunnus Atlassian-tilillä (
id.atlassian.com→ Security → API tokens). - Ylläpitäjän oikeudet liitännän hallintaan Siesta AI:ssa.
Tuetut toiminnot
| Toiminto | Kuvaus |
|---|---|
SearchPagesAsync | Kokotekstihaku sivuista valitussa Confluence-tilassa |
GetPageAsync | Sivun sisällön lataaminen metatietoineen |
CreatePageAsync | Uusien sivujen luominen Confluencessa |
UpdatePageAsync | Olemassa olevien sivujen päivittäminen |
Käyttöoikeuksien hallinta
Jokainen toiminto voidaan määrittää erikseen:
- Sallittu – toiminto on käytettävissä ilman rajoituksia.
- Sallittu vahvistuksella – toiminto vaatii manuaalista hyväksyntää.
- Kielletty – toiminto ei ole käytettävissä.
Tämä malli mahdollistaa pääsyn tarkkaan määrittämisen, esimerkiksi:
- vain lukuoikeudelliset agentit,
- automatisoidut dokumentointiprosessit,
- hallitut kirjoitukset Confluenceen.
Konfigurointiparametrit
Pakolliset parametrit
| Parametri | Kuvaus |
|---|---|
| Nimi | Liittimen sisäinen tunnus |
| ApiKey | API-tunnus, joka on generoitu Atlassian-tilillä |
| Confluence-sivuston URL | Atlassian-instanssin URL (esim. https://firma.atlassian.net) |
| Atlassian-tilin sähköposti tai käyttäjänimi | Sähköposti (tai käyttäjänimi) tililtä, jonka alla tunnus on luotu |
Confluence-liittimen lisäämisprosessi
1) Valmistele pääsytiedot
Ennen kuin aloitat liitännän luomisen Siesta AI:ssa, valmistele kaikki arvot, jotka aiot syöttää lomakkeeseen.
Avaa Atlassian-tililläsi Security ja API Tokens -osio.
Napsauta Create API token (ilman scopes), syötä tunnuksen nimi ja voimassaoloaika, ja vahvista luominen.
Kun tunnus on luotu, kopioi se kertaluonteisesti ja tallenna se turvallisesti.
Valmistele myös:
- Confluence-sivuston URL (esim.
https://firma.atlassian.net) - Sähköposti tai käyttäjänimi Atlassian-tililtä, jonka alla tunnus on luotu
2) Avaa integraatioiden hallinta Siesta AI:ssa
Siesta AI:n hallinnassa siirry kohtaan Administration → Connected Apps.
3) Valitse Confluence
Lisää integraatio -dialogissa valitse Confluence ja jatka.
4 Täytä Confluence-lomake
Täytä:
- Nimi
- ApiKey (tunnus Atlassianista)
- Confluence-sivuston URL (esim.
https://firma.atlassian.net) - Sähköposti / käyttäjänimi Atlassian-tililtä, jonka alla tunnus on luotu
Vahvista integraation luominen.
5 Määritä toimintojen käyttöoikeudet
Integraation luomisen jälkeen avaa Käyttöoikeusasetukset ja määritä sallitut toiminnot.
Suositus: kirjoitustoiminnot määritä Sallituksi vahvistuksella.
Tärkeä huomautus API-tunnuksesta ja käyttöoikeuksista
API-tunnus on sidottu tiettyyn Atlassian-tiliin. Liitin perii tämän tilin käyttöoikeudet Confluencessa (mitä tili ei näe tai voi muuttaa, ei voi liitinkään).
Tämän vuoksi suositellaan:
- että jokaisella käyttäjällä on oma tunnus, jos liitäntä toimii hänen identiteettinsä alla,
- tai käyttää erillistä palvelutiliä jaetuille/tuotantoon liittyville automaatioille,
- valvoa tunnuksen voimassaoloaikaa ja suorittaa säännöllistä vaihtoa.
Tyypilliset käyttötilanteet
Sisäinen tietopankki
- Haku sisäisestä dokumentaatiosta
- Työntekijöiden kysymyksiin vastaaminen
- Keskitetty pääsy ajankohtaisiin tietoihin
Dokumentoinnin automatisointi
- Julkaisumuistioiden generointi
- Kokousmuistioiden laatiminen
- Toimintamenettelyjen (SOP) päivittäminen
Prosessien yhdistäminen
- Jira → Confluence -synkronointi
- Automaattinen raporttien luominen
- Tapahtumien ja auditointitietojen dokumentointi
Turvallisuusarkkitehtuuri
Integraatio hyödyntää:
- valtuutettua pääsyä Atlassian API:n kautta,
- rajoituksia tiettyyn Confluence-tilaan,
- hienojakoista käyttöoikeuksien hallintaa toiminnoille,
- mahdollisuutta auditoida toimintoja.
Ei tapahdu valtuuttamatonta sisällön lataamista tai Atlassian-alustan turvallisuusmekanismien kiertämistä.
Suositeltu käyttökonfiguraatio
- Salli lukeminen ilman rajoituksia.
- Kirjoitustoiminnot määritä Sallituksi vahvistuksella.
- Käytä erillisiä tiloja automatisoidulle dokumentoinnille.
- Tarkista säännöllisesti liitännän käyttöoikeudet.