Configurazione AI di Confluence e Jira: autorizzazioni e autorità

Table of Contents
Torna al corso di collaborazione AI
L’amministratore definisce l’autorità sul posto di lavoro prima di collegare gli strumenti di chat. I responsabili di prodotto e operazioni pubblicano requisiti e runbook in Confluence Cloud. Jira Cloud coordina la consegna. GitHub gestisce l’implementazione. Crea ambienti di test dedicati solo dopo aver preparato le basi, perché un’autorizzazione errata espone informazioni indipendentemente dal comportamento del modello.
Punti chiave
- Confluence conserva la formulazione approvata dei requisiti.
- Jira gestisce lo stato di consegna, non la politica di conservazione.
- GitHub gestisce la configurazione e le politiche condivise.
- I test di autorizzazione richiedono piani adeguati e utenti separati.
Prima di iniziare
Prerequisiti: le fondamenta , il repository del laboratorio, l’amministrazione degli spazi Confluence e di Jira, oltre a utenti separati con ruoli di collaboratore, responsabile e pubblicatore. Tempo stimato: da 90 a 120 minuti. Difficoltà: amministrazione avanzata.
Requisiti del piano: Confluence Free non supporta le restrizioni sui contenuti. Jira Free non offre schemi di autorizzazione configurabili, ruoli degli spazi o schemi di sicurezza per gli elementi di lavoro. Per questo percorso usa ambienti di test adeguati con piano Standard o superiore. Prima di eseguire i test, verifica piano e privilegi nelle fonti.
Nota sulla navigazione: la documentazione Jira attuale usa “space” e “work item”. Alcuni tenant mantengono “project” e “issue”. Scegli una configurazione gestita dall’azienda. Questa procedura non tratta i comportamenti delle autorizzazioni gestite dal team. Non servono Rovo, app del marketplace, approvazioni di Jira Service Management o connettori di chat a pagamento.
Risultato: prepara una matrice delle autorizzazioni, pagine di riferimento ufficiali nominate, un workflow Jira riservato al laboratorio e prove di accesso negato da utenti separati. Registra il piano del tenant e le ipotesi sui ruoli accanto ai risultati dei test.
Controlli preliminari prima di creare record:
| Controllo | Se disponibile | Se non disponibile |
|---|---|---|
| Restrizioni delle pagine e amministrazione dello spazio Confluence | Crea pagine separate approvate ed escluse | Segna come Bloccati i test di modifica della pagina e di lettura negata |
| Schema autorizzazioni e editor del workflow di Jira gestito dall’azienda | Copia uno schema e un workflow riservati al laboratorio | Segna come Bloccati i test delle transizioni |
| Utenti separati per collaboratore, responsabile, pubblicatore e utente escluso | Esegui test positivi e negativi specifici per ruolo | Segna come Bloccati i ruoli non testati |
| Manutentore del repository e branch protetto | Collega il percorso di implementazione revisionato | Completa prima il percorso GitHub-first, poi passa alla pubblicazione mista |
A ottobre 2026, usa il controllo Share o delle restrizioni per gestire l’accesso alla pagina, l’area delle autorizzazioni Space settings in Confluence per concessioni più ampie e Settings > Work items > Permission schemes in Jira per lo schema del laboratorio. L’editor del workflow di Jira gestito dall’azienda controlla le transizioni. Le etichette dell’interfaccia e le funzioni del piano variano tra tenant. Prima di seguire questi passaggi, registra nei tuoi dati di prova il percorso effettivo e il piano. Consulta le autorizzazioni a livello di pagina in Confluence e gli schemi di autorizzazione Jira .
Crea le pagine autorevoli
- Crea uno spazio Confluence chiamato
Export Service Lab. Disattiva l’accesso anonimo e la condivisione pubblica tramite i controlli disponibili per sito e spazio. - Crea pagine pubblicate, non documenti live, chiamate
REQ-17 Export Retention,RUN-04 Export CleanupeDecision Register. - Come responsabile di prodotto, pubblica il requisito iniziale riportato sotto. Registra l’ID e la versione effettivi della pagina nella mappa del repository.
- Come responsabile delle operazioni, pubblica RUN-04 con conservazione di sette giorni e con l’indicazione che in questo laboratorio non viene eseguito alcun processo di eliminazione.
- Su ogni pagina autorevole, apri Share. Imposta l’accesso generale in sola lettura per i membri dello spazio idonei e assegna autorizzazioni di modifica specifiche ai responsabili e ai pubblicatori designati. Salva e verifica con l’utente collaboratore.
Source ID: REQ-17
Owner role: product-owner
Status: Approved baseline
Scope: synthetic export files only
Retention: 7 days
Delivery state: baseline lab configuration
Exceptions: production data, backups, and legal holds excluded
Approval evidence: DEC-12 baseline review
Implementation reference: attach protected GitHub baseline commit
Applica restrizioni a ogni pagina autorevole. Non presumere che la restrizione di modifica di una pagina padre protegga anche le figlie. L’ereditarietà di lettura e modifica funziona in modo diverso e restano valide anche le autorizzazioni dello spazio. Un collegamento da solo non concede accesso. Controlla tutte le appartenenze se un utente che dovrebbe avere solo lettura riesce ancora a modificare.
Usa questi testi iniziali per le altre due pagine. Prima di approvare un record, sostituisci i campi di revisione segnaposto con prove reali dell’ambiente di test.
Source ID: RUN-04
Owner role: operations-owner
Status: Approved baseline
Scope: synthetic export files only
Configured retention: 7 days
Procedure: compare REQ-17 with config.json before a reviewed change
Runtime limit: this lab has no deletion job and produces no deletion evidence
Recovery: restore the prior approved configuration through review
Recovery limit: restoring configuration does not restore deleted files
Review evidence: add actual reviewer, page version, and decision reference
Page: Decision Register
Entry ID: DEC-12
Decision: use seven days as the synthetic baseline
Scope: export-service-lab only
Requirement: REQ-17 page version, record after publication
Runbook: RUN-04 page version, record after publication
Policy: POL-01 protected GitHub revision, record after review
Product review: pending until the named owner records a decision
Operations review: pending until the named owner records a decision
Status: draft example, replace with observed review evidence
Aggiorna la mappa
track: mixed-workplace
policy: {source_id: POL-01, home: GitHub, version: 1}
requirements: {source_id: REQ-17, home: Confluence, owner_role: product-owner}
runbook: {source_id: RUN-04, home: Confluence, owner_role: operations-owner}
decisions: {source_id: DEC-12, home: Confluence, owner_role: project-lead}
implementation: {home: GitHub, file: config.json}
delivery: {home: Jira, proposal_id: PROP-042}
snapshot_rule: repository requirement copies are not authoritative
Aggiungi alla mappa le posizioni private effettive dell’ambiente di test e gli ID delle pagine. Il modello indica le fonti autorevoli senza fingere di contenere indirizzi reali. Rimuovi dal README il testo che assegna al file JSON copiato l’autorità sui requisiti del percorso misto.
Mantieni POL-01 in GitHub per entrambi i percorsi. Confluence rimanda alla revisione verificata. Spostare l’autorità della politica durante un’attività richiede un altro passaggio di autorità soggetto a revisione.
Imposta le autorizzazioni Jira
- Crea uno spazio di laboratorio gestito dall’azienda e copia uno schema di autorizzazione in uno schema dedicato al laboratorio. Non modificare uno schema di produzione condiviso.
- Apri Settings, Work items, Permission Schemes, seleziona lo schema del laboratorio e aggiorna le concessioni.
- Concedi ai collaboratori i permessi di consultazione, creazione e commento. Limita i privilegi amministrativi. Verifica esplicitamente i permessi di modifica e Transition work items.
- Associa lo schema allo spazio del laboratorio e verifica che nessuno spazio di produzione lo condivida.
- Crea PROP-042 come elemento di lavoro. Registra nella mappa la chiave generata e mantieni PROP-042 come ID logico della proposta nella descrizione.
Incolla questa bozza in PROP-042. L’elemento Jira tiene traccia della consegna. Il testo non sostituisce la formulazione approvata in Confluence.
Proposal ID: PROP-042
Status: Draft
Current approved value: 7 days, REQ-17 page version to record
Proposed value: 30 days for synthetic export files
Exclusions: production data, backups, legal holds
Affected records: REQ-17, RUN-04, config.json, proposal.json
Fixed proposal attachment: pending
Product-owner review: pending
Operations-owner review: pending
Publication ledger: pending
Stop on changed source version, missing review, or denied access
| Ruolo | Confluence | Jira | GitHub |
|---|---|---|---|
| Collaboratore | Legge le pagine approvate | Crea e commenta le bozze | Branch della proposta o Issue |
| Responsabile di prodotto | Revisiona il requisito | Registra la revisione del requisito | Revisiona le prove della PR |
| Responsabile delle operazioni | Revisiona il runbook | Registra la revisione operativa | Revisiona l’impatto operativo |
| Pubblicatore | Modifica le pagine approvate | Registra lo stato di pubblicazione | Nessuna autorità automatica di merge |
| Manutentore | Legge il requisito | Registra l’implementazione | Revisiona e integra la PR protetta |
Le autorizzazioni assegnate tramite gruppi diversi si sommano. Rimuovi dal laboratorio le concessioni ampie non volute, invece di presumere che una concessione più limitata le sovrascriva. Non inserire le identità dei connettori nei gruppi amministrativi.
Imposta gli stati di consegna
Copia un workflow gestito dall’azienda in un workflow riservato al laboratorio. Aggiungi gli stati Bozza, Revisione, Approvato, Pubblicazione, Completato e Bloccato. Aggiungi le transizioni di invio, approvazione, pubblicazione, completamento, blocco e ritorno alla revisione. Associalo solo al tipo di lavoro del laboratorio.
- Nell’editor del workflow, seleziona la transizione verso Approvato.
- Aggiungi una condizione o restrizione che consenta l’attivazione solo al ruolo o al gruppo designato di responsabili/pubblicatori. Usa i controlli documentati e pubblica la bozza del workflow come amministratore.
- Verifica manualmente entrambe le revisioni dei responsabili prima della transizione. Ciascuna revisione identifica la proposta congelata e le versioni delle fonti.
- Limita Completato al ruolo responsabile della consegna. Rimuovi le transizioni alternative o globali che aggirano il limite.
Una transizione limitata non equivale all’approvazione di due persone. Controlla chi esegue la transizione. In questo progetto pilota, la verifica delle prove dei due ruoli resta procedurale. Registra esplicitamente questo limite.
Esempio di record di transizione: per Revisione ad Approvato, consenti l’attivazione solo al gruppo designato di responsabili/pubblicatori. Prima di attivarla, chi esegue la transizione apre l’allegato fisso PROP-042 e verifica le decisioni del responsabile di prodotto e di quello operativo sulla stessa revisione della proposta. Se manca una decisione o si riferisce a una revisione precedente, lascia l’elemento in Revisione e registra la lacuna. La restrizione del workflow controlla chi esegue la transizione. La verifica delle prove è un passaggio umano separato.
Verifica la negazione dell’accesso
Come collaboratore, leggi REQ-17, prova a modificarlo, crea la bozza Jira e tenta la transizione ad Approvato. I risultati attesi sono requisito leggibile, modifica negata, creazione della proposta riuscita e approvazione negata. Confronta le versioni della fonte prima e dopo il diniego.
Come utente escluso, apri una pagina sintetica con restrizioni separate. L’accesso ai contenuti deve essere negato. Verifica indipendentemente le pagine figlie. Non copiare il testo protetto nella chat dell’utente escluso per aggirare il controllo.
Adatta la mappa del repository
Mantieni stabili gli ID delle fonti quando cambia la loro posizione. REQ-17 indica ancora l’intento approvato di conservazione, ma nel percorso misto la sua sede è una pagina Confluence. Una copia nel repository supporta i controlli e la revisione. Non sostituisce la pagina autorevole.
| Record | Sede autorevole | Trattamento nel repository |
|---|---|---|
| REQ-17 | Pagina dei requisiti Confluence indicata nella mappa | Copia acquisita con prova della revisione della pagina |
| RUN-04 | Pagina del runbook Confluence indicata nella mappa | Estratto operativo acquisito per coerenza |
| POL-01 | Politica protetta in GitHub | Le istruzioni condivise degli agenti vi fanno riferimento |
| Configurazione | Record protetto in GitHub | Differenza di implementazione proposta |
| Consegna | Elemento di lavoro Jira | Collegamento di correlazione, non copia della politica |
Aggiungi la provenienza alle copie. Nel pacchetto privato della proposta registra l’ID della fonte, il riferimento alla pagina, la versione, l’ora di acquisizione e il ruolo di chi ha acquisito i dati. Non includere gli identificatori nativi delle pagine negli elaborati pubblici del corso. Se il pubblicatore trova una versione attuale diversa, risolvi la differenza prima di usare la copia.
Non rinominare l’autorità per adattarla allo strumento. La descrizione modificabile di Jira è utile per discutere, ma resta un record di consegna. Una frase di trenta giorni in Jira non sostituisce un requisito di sette giorni in Confluence.
Progetta i test di accesso
Separa lettura, bozza e pubblicazione. Un collaboratore deve poter comprendere il requisito sintetico e inviare una proposta. Non gli servono i permessi di modifica sulla pagina autorevole né il permesso di approvare la propria proposta.
Test record: PERM-REQ-EDIT
Role: contributor
Source: REQ-17
Precondition: source is readable, published revision captured
Attempt: edit the authoritative requirement
Expected: edit denied, published revision unchanged
Observed: fill from the sandbox
Evidence: native result and independent revision read-back
Reviewer: administrator or independent permission reviewer
Usa un record separato per testare la lettura negata. Il requisito leggibile dal collaboratore verifica la separazione tra pubblicazione e modifica. La pagina inaccessibile per l’utente escluso verifica la riservatezza. Riunire i due casi in un’unica riga nasconde quale limite è stato testato.
Verifica anche gli accessi consentiti. I responsabili e i pubblicatori devono poter usare il percorso assegnato. Se tutti gli utenti ricevono un diniego, l’ambiente di test è restrittivo ma inutilizzabile. Conserva una modifica autorizzata riuscita su una pagina di prova usa e getta senza alterare il requisito approvato durante la diagnosi delle autorizzazioni.
Prova la revisione Jira
Considera i nomi degli stati il progetto di questo pilota. Bozza contiene una richiesta. Revisione contiene un pacchetto congelato. Approvato indica che i responsabili hanno completato la revisione. Pubblicazione indica una consegna ancora in corso. Completato richiede una rilettura. Bloccato indica prove o accesso mancanti, oppure un conflitto irrisolto.
| Transizione | Pacchetto richiesto | Controllo responsabile |
|---|---|---|
| Bozza a Revisione | Proposta fissa e versioni delle fonti | Il collaboratore conferma la completezza |
| Revisione ad Approvato | Decisioni del responsabile di prodotto e di quello operativo | L’attore autorizzato verifica entrambi i ruoli |
| Approvato a Pubblicazione | Confronto con le fonti attuali | Il pubblicatore conferma che le basi non sono cambiate |
| Pubblicazione a Completato | Registro completato per ogni sistema | Il responsabile della consegna verifica la rilettura |
| Qualsiasi passaggio supportato a Bloccato | Errore e azione in sospeso | Responsabile del ripristino assegnato |
Prova con un pacchetto sintetico incompleto. Invia solo la revisione del prodotto e chiedi all’attore autorizzato di valutare la transizione. Il comportamento atteso è lasciare il lavoro in Revisione e richiedere la revisione operativa. Questo verifica il passaggio procedurale separatamente dal diniego sulla piattaforma per il collaboratore.
Verifica deliberatamente i percorsi alternativi. Nella vista workflow dell’ambiente di test controlla ogni percorso verso Approvato e Completato. Una transizione nominata e limitata non basta se un’altra via disponibile salta lo stesso controllo. Registra i percorsi ispezionati e l’utente usato, invece di dichiarare una copertura completa dopo un solo clic.
Diagnostica gli accessi imprevisti
Parti dall’identità effettiva. Verifica che la sessione del browser appartenga al ruolo di test previsto. Poi controlla appartenenza ai gruppi, autorizzazioni dello spazio, accesso alle pagine e associazione del workflow con gli strumenti amministrativi del prodotto. Non modificare più controlli insieme, perché così il diniego perde valore diagnostico.
- Conferma l’identità: usa sessioni separate per collaboratore, pubblicatore e utente escluso.
- Individua la concessione: trova l’appartenenza o l’impostazione che consente l’azione tentata.
- Modifica il controllo del laboratorio: conserva il legittimo accesso dei responsabili.
- Ripeti lo stesso tentativo: dopo il diniego acquisisci la versione invariata della fonte.
- Ripeti il caso positivo: conferma che la pubblicazione autorizzata funzioni ancora.
Elenco finale delle prove: registra l’albero delle pagine Confluence e i relativi ID, l’associazione dello schema Jira del laboratorio, l’associazione del workflow, l’appartenenza ai gruppi di ogni ruolo di test, una lettura consentita del requisito, una modifica negata con versione invariata, la creazione consentita di una bozza, una transizione ad Approvato negata con stato invariato, la lettura negata all’utente escluso e il responsabile della pulizia. Per ogni riga conserva il ruolo dell’attore, la versione o lo stato iniziale e finale, il risultato nativo e il revisore indipendente. Registra il percorso di navigazione osservato nel tenant, perché etichette e controlli disponibili variano in base al piano.
Verifica del completamento: consegna le pagine autorevoli mappate, il workflow riservato al laboratorio, la matrice dei ruoli prevista e i record delle autorizzazioni osservati. Se il piano non include un controllo richiesto, lascia la relativa riga in stato Bloccato. La lezione sulla pubblicazione presuppone che i test siano riusciti, non la sola esistenza di schermate delle impostazioni.
Risoluzione dei problemi e rollback
Il collaboratore riesce ancora a modificare: controlla accesso alla pagina, autorizzazioni dello spazio e appartenenze. La transizione riesce ancora: controlla l’associazione del workflow e i percorsi di bypass. Mancano impostazioni: verifica la configurazione gestita dall’azienda, l’edizione e i privilegi amministrativi.
Rollback: rimuovi le autorizzazioni dei connettori e archivia le bozze. Scollega schemi e workflow riservati al laboratorio dopo aver conservato le prove. Ripristina la formulazione approvata della pagina tramite la cronologia revisionata o una modifica correttiva. Non eliminare le prove di audit.
Esercizio e autoverifica
Jira indica trenta giorni, mentre REQ-17 ne indica sette. Identifica l’input dell’implementazione e il responsabile della riconciliazione.
Ragionamento atteso: Confluence definisce l’intento. Jira contiene un errore di proposta o di consegna. Interrompi la pubblicazione e chiedi al responsabile di prodotto di riconciliare i dati, invece di scegliere il timestamp più recente.
Riferimenti principali
- Restrizioni e piano: autorizzazioni Confluence .
- Controlli di condivisione: accesso a contenuti specifici .
- Amministrazione degli schemi: schemi di autorizzazione Jira .
- Condizioni delle transizioni: workflow avanzati .
Passaggi successivi
Dopo aver superato i test di accesso, continua con Pubblicazione tra sistemi .




