Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

Context

This PR updates all OIDC auth documentation files to reflect that machine identities can now be created at either the organization level or directly at the project level. Previously, the docs only showed the organization-level workflow.

This is a follow-up to PR #5260, which documented the GitHub Actions OIDC workflow using the project-level approach. The existing OIDC auth docs needed to be updated for consistency.

Files updated:

  • github.mdx
  • general.mdx
  • gitlab.mdx
  • azure.mdx
  • circleci.mdx
  • spire.mdx

Note: terraform-cloud.mdx was not updated as it references general.mdx for identity creation steps rather than duplicating them.

Screenshots

N/A - Documentation changes only. The Project Level tab does not include screenshots (unlike the Organization Level tab) since the UI screenshots for project-level identity creation may need to be added separately.

Steps to verify the change

  1. Run the docs locally or check the preview deployment
  2. Navigate to any OIDC auth page (e.g., Platform > Identities > OIDC Auth > GitHub)
  3. Verify the "Creating an identity" step shows tabs for "Organization Level" and "Project Level"
  4. Verify the "Adding an identity to a project" step clarifies it's only for org-level identities

Type

  • Fix
  • Feature
  • Improvement
  • Breaking
  • Docs
  • Chore

Checklist

Human review checklist

  • Verify the <Tabs> component renders correctly in the docs preview
  • Confirm whether screenshots for project-level identity creation should be added
  • Verify wording is consistent across all 6 updated files

Link to Devin run: https://app.devin.ai/sessions/43140af081144d888a1fbf095d193318
Requested by: jake@infisical.com

Updated all OIDC auth documentation files to reflect that machine identities
can now be created at either the organization level or project level:

- github.mdx
- general.mdx
- gitlab.mdx
- azure.mdx
- circleci.mdx
- spire.mdx

Changes include:
- Added Tabs component showing both Organization Level and Project Level
  workflows for creating identities
- Updated 'Adding an identity to a project' step to clarify it only applies
  to organization-level identities
- Added notes explaining that project-level identities can skip the project
  assignment step since they are already scoped to the project

Co-Authored-By: jake@infisical.com <jake@infisical.com>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@maidul98
Copy link
Collaborator

maidul98 commented Feb 3, 2026

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

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.

1 participant