Confluence and Jira AI Setup: Permissions and Authority

Table of Contents
Return to the AI Collaboration Course
The administrator configures workplace authority before connecting chat tools. Product and operations owners publish requirements and runbooks in Confluence Cloud. Jira Cloud coordinates delivery. GitHub owns implementation. You build dedicated sandboxes after the foundation, because an incorrect permission grant exposes information independently of model behavior.
Key Takeaways
- Confluence owns approved requirement wording.
- Jira owns delivery state, not retention policy.
- GitHub owns configuration and shared policy.
- Permission tests require suitable plans and separate users.
Before You Begin
Prerequisites: the foundation , lab repository, Confluence space administration, Jira administration, and separate contributor, owner, and publisher users. Estimated time: 90 to 120 minutes. Difficulty: advanced administration.
Plan requirement: Confluence Free does not support content restrictions. Jira Free lacks configurable permission schemes, space roles, and work-item security schemes. Use suitable Standard-or-higher sandboxes for this track. Verify the actual plan and privileges against the references before testing.
Navigation note: current Jira documentation uses “space” and “work item.” Some tenants retain “project” and “issue.” Select a company-managed configuration. Team-managed permission behavior is outside this procedure. No Rovo, marketplace app, Jira Service Management approvals, or paid chat connector is required.
Reader outcome: finish with a permission matrix, named authority pages, a lab-only Jira workflow, and denial evidence from separate users. Record tenant plan and role assumptions beside the test results.
Preflight before creating records:
| Check | If available | If missing |
|---|---|---|
| Confluence page restrictions and space administration | Create separate approved and excluded pages | Mark page-edit and denied-read tests Blocked |
| Company-managed Jira permission scheme and workflow editor | Copy lab-only scheme and workflow | Mark transition tests Blocked |
| Separate contributor, owner, publisher, and excluded users | Run role-specific positive and negative tests | Mark untested roles Blocked |
| Repository maintainer and protected branch | Link the reviewed implementation route | Complete the GitHub-first track before mixed publication |
As of October 2026, use the page Share or restriction control for page access, the Confluence Space settings permission area for broader grants, and Jira Settings > Work items > Permission schemes for the lab scheme. Jira’s company-managed workflow editor controls transitions. UI labels and plan features vary by tenant. Record the actual path and plan in your evidence before following these steps. See Confluence page-level permissions and Jira permission schemes .
Create Authority Pages
- Create a Confluence space named
Export Service Lab. Keep anonymous access and public sharing disabled through available site/space controls. - Create published pages, not live docs, named
REQ-17 Export Retention,RUN-04 Export Cleanup, andDecision Register. - Publish the initial requirement below as the product owner. Record its actual page ID and version in the repository map.
- Publish RUN-04 as operations owner with seven-day retention and the statement explaining no deletion job runs in this lab.
- Open Share on each authoritative page. Set general access to view-only for eligible space members and grant specific edit access to designated owners/publishers. Save and verify with the contributor user.
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
Apply restrictions to each authoritative page. Do not assume a parent’s edit restriction protects its children. View and edit inheritance differ, and space permissions still apply. A link alone does not grant access. Inspect all memberships when an allegedly read-only user still edits.
Use these starting bodies for the other two pages. Replace placeholder review fields with actual sandbox evidence before marking a record approved.
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
Update the Map
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
Add actual private sandbox locations and page IDs to the map. The template names authority without pretending to contain live addresses. Remove README wording assigning mixed-track requirement authority to the copied JSON file.
Keep POL-01 in GitHub for both tracks. Confluence links to its reviewed revision. Moving policy authority during a task requires another reviewed authority transition.
Set Jira Permissions
- Create a company-managed lab space and copy a permission scheme into a dedicated lab scheme. Do not edit a shared production scheme.
- Open Settings, Work items, Permission Schemes, then select the lab scheme and update grants.
- Grant browse, create, and comment to contributors. Restrict administrative privileges. Review editing and Transition work items permissions explicitly.
- Associate the scheme with the lab space and verify no production space shares it.
- Create PROP-042 as a work item. Record its generated key in the map and keep PROP-042 as the logical proposal ID in its description.
Paste this draft into PROP-042. The Jira item tracks delivery. Its text does not replace approved Confluence wording.
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
| Role | Confluence | Jira | GitHub |
|---|---|---|---|
| Contributor | Read approved pages | Create/comment on drafts | Proposal branch or Issue |
| Product owner | Review requirement | Record requirement review | Review PR evidence |
| Operations owner | Review runbook | Record operational review | Review operational impact |
| Publisher | Edit approved pages | Record publication state | No automatic merge authority |
| Maintainer | Read requirement | Record implementation | Review/merge protected PR |
Grants across groups are additive. Remove unintended broad grants in the lab rather than assuming a narrow grant overrides them. Keep connector identities out of administrative groups.
Set Delivery States
Copy a company-managed workflow into a lab-only workflow. Add Draft, Review, Approved, Publishing, Done, and Blocked states. Add submission, approval, publication, completion, blocking, and return-to-review transitions. Associate it with the lab work type only.
- Select the transition into Approved in the workflow editor.
- Add a condition/restriction limiting the actor to the designated owner/publisher role or group. Use the documented condition controls and publish the workflow draft as administrator.
- Check both owner reviews manually before transition. Each review identifies the frozen proposal and source versions.
- Restrict Done to the accountable delivery role. Remove alternate/global transitions bypassing the boundary.
A restricted transition is not two-person approval. It controls the actor performing the transition. The two-role evidence check remains procedural in this pilot. Record this limit explicitly.
Example transition record: For Review to Approved, permit only the designated owner/publisher group to activate the transition. Before activation, the actor opens the fixed PROP-042 attachment and checks a product-owner decision and an operations-owner decision against the same proposal revision. If either decision is missing or names an older revision, leave the item in Review and record the gap. The workflow restriction controls the actor. The evidence check is a separate human step.
Verify Denial
As contributor, read REQ-17, attempt an edit, create the Jira draft, and attempt the Approved transition. Expected results are readable requirement, denied edit, successful proposal creation, and denied approval transition. Compare source versions before and after denial.
As an excluded user, open a separately restricted synthetic page. Expect no content access. Test child pages independently. Do not paste protected text into the excluded user’s chat as a workaround.
Translate the Repository Map
Keep source IDs stable when their homes change. REQ-17 still means approved retention intent, but its mixed-track home is a Confluence page. A repository snapshot supports checks and review. It does not replace the page’s authority.
| Record | Authoritative home | Repository treatment |
|---|---|---|
| REQ-17 | Mapped Confluence requirement page | Captured snapshot with page revision evidence |
| RUN-04 | Mapped Confluence runbook page | Captured operating excerpt for consistency |
| POL-01 | Protected GitHub policy | Shared agent instructions reference it |
| Configuration | Protected GitHub record | Proposed implementation diff |
| Delivery | Jira work item | Correlation link rather than policy copy |
Add capture provenance alongside snapshots. Record source ID, page reference, page version, capture time, and capturing role in the private proposal packet. Keep native page identifiers out of public course submissions. If the publisher finds a different live version, reconcile before using the snapshot.
Do not rename authority to fit the tool. Jira’s editable description is convenient for discussion, but it remains a delivery record. A thirty-day sentence in Jira does not supersede a seven-day requirement in Confluence.
Design the Access Tests
Separate reading, drafting, and publishing. A contributor needs enough access to understand the synthetic requirement and submit a proposal. They do not need authority-page edit access or permission to mark their own proposal approved.
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
Use a separate record for denied reading. The contributor’s readable requirement tests publication separation. An excluded user’s inaccessible page tests confidentiality. Combining them into one row hides which boundary was exercised.
Check positive access too. Owners and publishers need their assigned route to work. If every user is denied, the sandbox is restrictive but unusable. Retain a successful authorized edit on a disposable test page without altering the approved requirement during permission diagnosis.
Rehearse the Jira Review
Treat the state names as this pilot’s design. Draft contains a request. Review contains a frozen package. Approved records completed owner review. Publishing records incomplete delivery. Done requires read-back. Blocked names missing evidence, access, or unresolved conflict.
| Transition | Required packet | Accountable check |
|---|---|---|
| Draft to Review | Fixed proposal and source versions | Contributor confirms completeness |
| Review to Approved | Product and operations decisions | Authorized actor checks both roles |
| Approved to Publishing | Current-source comparison | Publisher confirms unchanged bases |
| Publishing to Done | Completed per-system ledger | Delivery owner checks read-back |
| Any supported step to Blocked | Failure and pending action | Recovery owner assigned |
Rehearse with a synthetic incomplete package. Submit only a product review and ask the authorized transition actor to assess it. Expected reasoning is to leave work in Review and request operations review. This tests the procedural review step separately from the contributor’s platform denial.
Test alternate routes deliberately. Use your sandbox workflow view to inspect every route into Approved and Done. A restricted named transition is insufficient if another available route skips the same review boundary. Record the routes inspected and the actor used, rather than claiming complete coverage from one click.
Diagnose Unexpected Access
Start with the effective identity. Confirm the browser session belongs to the intended test role. Then inspect group membership, space grants, page access, and workflow association using the product’s administration tools. Do not change several controls at once, because the resulting denial loses its diagnostic value.
- Confirm identity: separate contributor, publisher, and excluded-user sessions.
- Locate the grant: identify the membership or setting permitting the attempted action.
- Adjust the lab control: retain legitimate owner access.
- Repeat the same attempt: capture unchanged source revision after denial.
- Repeat the positive case: confirm authorized publication still works.
Final evidence checklist: record the Confluence page tree and mapped page IDs, the Jira lab scheme association, the lab workflow association, each test role’s group membership, an allowed requirement read, a denied requirement edit with unchanged version, an allowed draft creation, a denied approval transition with unchanged state, an excluded-user denied read, and the cleanup owner. For each row, keep the actor role, initial and final revision or state, native result, and independent reviewer. Record the tenant navigation path you observed because labels and available controls vary by plan.
Completion check: deliver the mapped authority pages, lab-only workflow, intended role matrix, and observed permission records. If the plan lacks a required control, leave the relevant row Blocked. The publication lesson assumes these tests succeeded, not merely the existence of settings screenshots.
Troubleshooting and Rollback
Contributor still edits: inspect page access, space grants, and memberships. Transition still succeeds: inspect workflow association and bypass routes. Settings missing: verify company-managed type, edition, and administrator permission.
Rollback: remove connector grants and archive drafts. Detach lab-only schemes/workflows after retaining evidence. Restore approved page wording through reviewed history or a compensating edit. Do not delete audit evidence.
Exercise and Self-Check
Jira says thirty days while REQ-17 says seven. Identify the implementation input and reconciliation owner.
Expected reasoning: Confluence governs intent. Jira contains a proposal or delivery error. Stop publication and ask the product owner to reconcile, rather than choosing the newest timestamp.
Primary References
- Restrictions and plan: Confluence permissions .
- Share controls: Specific content access .
- Scheme administration: Jira permission schemes .
- Transition conditions: Advanced workflows .
Next Steps
Continue with Cross-System Publication after the permission tests pass.



