Skip to content

chore: rename embedded identity to admin#8392

Open
leiicamundi wants to merge 3 commits intomainfrom
chore/rename-embedded-identity-to-admin
Open

chore: rename embedded identity to admin#8392
leiicamundi wants to merge 3 commits intomainfrom
chore/rename-embedded-identity-to-admin

Conversation

@leiicamundi
Copy link
Copy Markdown
Contributor

@leiicamundi leiicamundi commented Mar 26, 2026

Description

Related to https://github.com/camunda/team-infrastructure-experience/issues/1070 and https://github.com/camunda/camunda-deployment-references/pull/2150/changes

This pull request updates documentation to reflect a terminology change from "Identity" to "Admin" for the authentication and configuration component across several deployment and operational guides. This ensures consistency and clarity in the documentation regarding the component responsible for authentication and administration.

Terminology updates:

  • Updated references from "Identity" to "Admin" in the context of authentication setup and configuration in the AWS ECS deployment guide (aws-ecs.md).
  • Changed "embedded Identity" to "embedded Admin" in the dual-region operational tasks documentation (dual-region-ops.md).
  • Updated references from "Identity" to "Admin" in the context of authentication methods in the dual-region operational tasks documentation (dual-region-ops.md).
  • Replaced "Identity" with "Admin" in the list of components connecting to secondary storage in the manual installation guide (install.md).
  • Changed the documentation to refer to "Admin" instead of "Identity" regarding OIDC configuration on first access in the manual installation guide (install.md).

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).
  • My changes are for an already released minor and are in a /versioned_docs directory.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 26, 2026

👋 🤖 🤔 Hello, @hisImminence! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.8/.

  • docs/self-managed/concepts/multi-region/img/dual-region.jpg
  • docs/self-managed/deployment/containers/cloud-providers/amazon/aws-ecs.md
  • docs/self-managed/deployment/helm/operational-tasks/dual-region-ops.md
  • docs/self-managed/deployment/helm/operational-tasks/img/10.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/11.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/12.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/13.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/14.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/15.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/4.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/5.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/6.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/8.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/9.jpg
  • docs/self-managed/deployment/helm/operational-tasks/img/oc-pod.jpg
  • docs/self-managed/deployment/manual/install.md
  • docs/self-managed/reference-architecture/img/k8s-cluster-view-orchestration.jpg
  • docs/self-managed/reference-architecture/img/manual-ha.jpg
  • docs/self-managed/reference-architecture/img/manual-single.jpg
  • docs/self-managed/reference-architecture/img/orchestration-cluster.jpg

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@leiicamundi leiicamundi added component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed component:infraex Issues related with Infrastructure-Experience team 8.9.0 labels Mar 26, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates self-managed documentation to reflect the terminology change from embedded “Identity” to “Admin” in deployment and operational guides, aligning wording with the current Orchestration Cluster component naming.

Changes:

  • Renamed “Identity” to “Admin” in the manual installation guide where referring to embedded authentication/admin behavior.
  • Updated dual-region operational tasks wording to refer to “Admin” configuration and “embedded Admin”.
  • Adjusted AWS ECS guide bullet points to refer to “Admin” for basic authentication setup examples.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/self-managed/deployment/manual/install.md Replaces Identity references with Admin in secondary storage component list and first-access/OIDC wording.
docs/self-managed/deployment/helm/operational-tasks/dual-region-ops.md Updates Identity terminology to Admin in API/auth context and Orchestration Cluster pod description.
docs/self-managed/deployment/containers/cloud-providers/amazon/aws-ecs.md Updates the ECS Terraform example description from Identity to Admin for basic authentication setup.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@leiicamundi
Copy link
Copy Markdown
Contributor Author

@camunda/tech-writers there is still a bunch of schema to be updated and redownloaded from the https://miro.com/app/board/uXjVL-6SrPc=/ board to this doc, not sure how you would like to proceed?

I started to update some in Miro by copying the frame and adding "8.9", it's still incompleted, and the requires ilmports here

@infraex-misc
Copy link
Copy Markdown

infraex-misc bot commented Mar 26, 2026

🔍 InfraEx Content Detected

This PR modifies documentation pages owned or referenced by the Infrastructure Experience team.

A review from @camunda/infraex-medic has been requested to ensure technical consistency.

📎 Files referencing monitored repos

File
docs/self-managed/deployment/containers/cloud-providers/amazon/aws-ecs.md
docs/self-managed/deployment/helm/operational-tasks/dual-region-ops.md
docs/self-managed/deployment/manual/install.md

ℹ️ What to check
  • Link validity: Do links still point to existing files/branches?
  • Technical accuracy: Are references consistent with the deployment repo?
  • Version alignment: Do version-specific docs match the release branch?
  • Architecture consistency: Do changes align with the reference architecture?

Auto-generated by InfraEx Docs PR Watcher.

marcel-dias
marcel-dias previously approved these changes Mar 26, 2026
@giorgionaps giorgionaps requested review from giorgionaps and removed request for a team March 26, 2026 14:24
@giorgionaps
Copy link
Copy Markdown
Contributor

@leiicamundi, I will update the images within this same PR

@giorgionaps giorgionaps added the hold This issue is parked, do not merge. label Mar 27, 2026
@leiicamundi
Copy link
Copy Markdown
Contributor Author

Thanks a lot @giorgionaps <3

@giorgionaps
Copy link
Copy Markdown
Contributor

giorgionaps commented Mar 27, 2026

@leiicamundi I've updated the references to identity I could find in the images in the docs affected by this PR (based on my understanding). Can you pls check if anything else should be updated within this PR?

@hisImminence
Copy link
Copy Markdown
Contributor

@leiicamundi I've updated the references to identity I could find in the images in the docs affected by this PR (based on my understanding). Can you pls check if anything else should be updated within this PR?

Update some more (hope all) diagrams I found that needed still an update in identity --> admin.

Thanks team!

@hisImminence
Copy link
Copy Markdown
Contributor

P.s. we need to do some more changes on the diagrams (regarding secondary storage #8433). I put the other task on hold until this is merged 🙏

As I understood the check/ update of the diagrams was the last part missing for this PR?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

8.9.0 component:infraex Issues related with Infrastructure-Experience team component:self-managed Docs and issues related to Camunda Platform 8 Self-Managed hold This issue is parked, do not merge.

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

5 participants