Skip to content

docs: document Azure client-secret → federated identity migration#383

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/2cb36541
Open

docs: document Azure client-secret → federated identity migration#383
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/2cb36541

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the new Azure cloud-account migration flow that switches an existing client-secret connection to federated identity credentials (workload identity), so customers no longer need to rotate a client secret every 365 days.

Changes

  • Added a Migrating from a Client Secret to Federated Identity Credentials section to the Azure tab of the cloud account connection guide.
  • Covered prerequisites (Application.ReadWrite.All Microsoft Graph permission, with a pointer to the existing setup paths that already grant it).
  • Documented the in-dashboard migration trigger, the asynchronous status progression (pending → running → cutting over → completed), per-cluster cutover behavior, and automatic deletion of the stored client secret on success.
  • Added post-migration cleanup guidance.

Context

Triggered by porter-dev/code#6502, which shipped the async worker that drives the Azure FIC migration end to end: provisioning the federated identity, flipping each AKS cluster's CAPZ AzureClusterIdentity to workload identity, and removing the stored client secret once all clusters have cut over. The flow mirrors the existing GCP "Migrate to Workload Identity Federation" experience.

cc @

@mintlify mintlify Bot requested a review from JessicaGCarvalho June 24, 2026 17:07
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.

0 participants