Skip to content

docs(user-guide): add per-user oauth 2.0 sign-in for gitlab, jira, and confluence - #401

Open
batyrkhanmekin-glitch wants to merge 4 commits into
codemie-ai:mainfrom
batyrkhanmekin-glitch:docs/EPMCDME-13527-gitlab-jira-confluence-oauth
Open

docs(user-guide): add per-user oauth 2.0 sign-in for gitlab, jira, and confluence#401
batyrkhanmekin-glitch wants to merge 4 commits into
codemie-ai:mainfrom
batyrkhanmekin-glitch:docs/EPMCDME-13527-gitlab-jira-confluence-oauth

Conversation

@batyrkhanmekin-glitch

Copy link
Copy Markdown

Summary

Documents the per-user OAuth 2.0 sign-in flow for GitLab, Jira, and Confluence integrations (EPMCDME-13527). An administrator configures the OAuth application once; each member then authorizes under their own account so tokens are per-user — nobody borrows another member's token.

Changes

  • Updated jira.mdx and confluence.mdx with tabbed PAT / OAuth 2.0 integration setup and a new "Connect from Chat" section for the in-chat connect gate
  • Updated git-github-gitlab-bitbucket.md with a GitLab OAuth 2.0 authentication tab and in-chat connect section; feature-flag visibility note (GITLAB_OAUTH_ENABLED)
  • Added docs/admin/configuration/oauth-integrations.md — admin guide covering provider enable flags, GitLab OAuth app registration, Atlassian OAuth app registration (shared for Jira + Confluence), env vars, and troubleshooting table
  • Added OAuth info admonition to tools/overview.md and FeatureCard to admin configuration index
  • Added FAQ entry: "How do I connect my GitLab/Jira/Confluence account to a shared OAuth integration?"

Testing

  • Tested locally with npm start
  • All pages render correctly
  • Images display properly
  • Internal links work
  • Sidebar navigation works

Quality Checks

  • npm run check passes (typecheck + lint + commitlint)
  • No MDX compilation errors
  • No raw angle brackets
  • Sidebar references document IDs (not filenames)
  • Images stored locally next to content
  • Commit messages follow Conventional Commits
  • No secrets or credentials in documentation

Additional Notes

Screenshots for the new OAuth sections are pending capture. Placeholder filenames for when screenshots are added:

  • jira-oauth-integration-form.png, jira-chat-auth-prompt.png
  • confluence-oauth-integration-form.png, confluence-chat-auth-prompt.png
  • git-gitlab-oauth-integration-form.png, git-gitlab-chat-auth-prompt.png

@github-actions

Copy link
Copy Markdown

PR Preview Ready!

Your preview documentation is ready! Visit it here:

Preview URL: http://codemie-docs-pr-previews.s3-website.eu-central-1.amazonaws.com/pr-401/


This preview will be automatically updated when you push new commits to this PR.
Preview files will be deleted when the PR is closed or merged.


```yaml
env:
GITLAB_OAUTH_ENABLED: 'true'

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure that we require a new visual tile just for this page. Also there's a special doc page with API configuration Please move it also there

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

configuration, this page is not accessible for me. Can you please give me permission or share some other needed details

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

@batyrkhanmekin-glitch
batyrkhanmekin-glitch force-pushed the docs/EPMCDME-13527-gitlab-jira-confluence-oauth branch from 27ca100 to c029ea9 Compare September 10, 2026 11:42
@batyrkhanmekin-glitch
batyrkhanmekin-glitch force-pushed the docs/EPMCDME-13527-gitlab-jira-confluence-oauth branch from bcf98fa to d90aa37 Compare September 10, 2026 12:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants