Skip to content

Draft feature docs: Azure WIF migration banner states#389

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

Draft feature docs: Azure WIF migration banner states#389
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/d57bd02a

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Document the Azure → Workload Identity Federation migration flow on the cloud account connection page, including the new status-aware banner that surfaces in-progress and failed migrations even when the migration dialog is closed.

Changes

  • Added a "Migrating from a Client Secret to Workload Identity Federation" section under the Azure tab in cloud-accounts/connecting-a-cloud-account.mdx.
  • Documented the three banner states (Migrate to WIF / View progress / Retry) with the corresponding user actions.
  • Added recovery steps for the Application.ReadWrite.All Microsoft Graph permission failure surfaced by the error banner.
  • Added post-migration cleanup steps for removing the now-unused client secret, plus a note on the rotation section that federated credentials don't expire.

Context

Upstream change made the Azure FIC migration banner status-aware: a running migration shows "View progress" and a failed migration shows "Retry", both reopening the migration dialog. Status polling was lifted to the cloud account detail page so the banner reflects the live state even when the dialog is closed. These doc updates explain what each state means and how to recover from a failure.

cc @JessicaGCarvalho for review.

@mintlify mintlify Bot requested a review from JessicaGCarvalho June 25, 2026 22:14
@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview Jun 25, 2026, 10:15 PM

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