Atlassian Confluence
Prehľad
Confluence pripojenie umožňuje bezpečné prepojenie platformy Siesta AI s Atlassian Confluence cez oficiálne API. Integrácia poskytuje riadený prístup k obsahu Confluence priestoru a umožňuje:
- vyhľadávanie stránok,
- načítanie obsahu dokumentácie,
- programové vytváranie nových stránok,
- aktualizáciu existujúcich stránok.
Pripojenie je navrhnuté pre enterprise použitie s dôrazom na riadenie oprávnení, auditovateľnosť a bezpečnosť prístupu k dátam.
Požiadavky
- Aktívna Confluence Cloud stránka.
- Nainštalovaná aplikácia SiestaAI v Atlassian (Connected apps).
- Oprávnenie administrátora pre správu pripojenia v Siesta AI.
Podporované operácie
| Operácia | Popis |
|---|---|
SearchPagesAsync | Fulltextové vyhľadávanie stránok v rámci zvoleného Confluence priestoru |
GetPageAsync | Načítanie obsahu stránky vrátane metadát |
CreatePageAsync | Vytváranie nových stránok v Confluence |
UpdatePageAsync | Aktualizácia existujúcich stránok |
Riadenie oprávnení
Každú operáciu je možné nastaviť samostatne:
- Povolené – operácia je dostupná bez obmedzení.
- Povolené s potvrdením – operácia vyžaduje manuálne schválenie.
- Zakázané – operácia nie je dostupná.
Tento model umožňuje presne definovať rozsah prístupu, napr. pre:
- iba čítacie asistenty,
- automatizované dokumentačné procesy,
- kontrolované zápisy do Confluence.
Konfiguračné parametre
Povinné parametre
| Parametr | Popis |
|---|---|
| Názov integrácie | Interné označenie konektora |
| Confluence site URL | URL Atlassian instance (napr. https://firma.atlassian.net) |
| Space key | Kľúč cieľového Confluence priestoru (napr. ITOPS, DEV) |
Režim prístupu
- Zdieľané – integrácia je dostupná v rámci organizácie alebo tímu.
- Súkromné – integrácia je dostupná iba vlastníkovi.
Postup pridania Confluence konektora
Otvorenie správy integrácií
V administrácii Siesta AI prejdite do Administration → Connected Apps.
Výber Confluence
V dialógu Pridať integráciu vyberte Confluence a pokračujte.
Konfigurácia integrácie
Vyplňte:
- Názov integrácie
- Confluence site URL
- Space key
- Režim prístupu
Potvrďte vytvorenie integrácie.
Nastavenie oprávnení
Po vytvorení integrácie otvorte Nastavenie oprávnení a nastavte povolené operácie.
Odporúčanie: zápisové operácie nastavte na Povolené s potvrdením.
Typické scenáre využitia
Interná znalostná báza
- Vyhľadávanie v internej dokumentácii
- Odpovedanie na otázky zamestnancov
- Centralizovaný prístup k aktuálnym informáciám
Automatizácia dokumentácie
- Generovanie release notes
- Tvorba zápisov z meetingov
- Aktualizácia prevádzkových postupov (SOP)
Prepojenie procesov
- Synchronizácia Jira → Confluence
- Automatické vytváranie reportov
- Dokumentácia incidentov a auditných záznamov
Bezpečnostná architektúra
Integrácia využíva:
- autorizovaný prístup cez Atlassian API,
- obmedzenie na konkrétny Confluence priestor,
- granulárne riadenie oprávnení operácií,
- možnosť auditu aktivít.
Nedochádza k neautorizovanému sťahovaniu obsahu ani obchádzaniu bezpečnostných mechanizmov Atlassian platformy.
Odporúčaná prevádzková konfigurácia
- Povoľte čítanie bez obmedzení.
- Zápisové operácie nastavte na Povolené s potvrdením.
- Používajte oddelené priestory pre automatizovanú dokumentáciu.
- Pravidelne kontrolujte oprávnenia pripojenia.