Skip to content

docs: add cross-links to Microsoft Learn how-to #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
msmbaldwin wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: add cross-links to Microsoft Learn how-to #6

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ KvRbacMigrator provides a comprehensive solution for:
- **Generating** deployment artifacts (ARM, Bicep, CLI commands)
- **Applying** RBAC role assignments with safety controls

## Documentation

For the Microsoft Learn how-to that places this toolkit in the broader Azure Key Vault access-control migration workflow, see [Migrate Key Vaults to Azure RBAC at scale with KvRbacMigrator](https://learn.microsoft.com/azure/key-vault/general/rbac-migration-toolkit). For the end-to-end migration guidance — including Azure Policy governance and the manual single-vault workflow — see [Migrate to Azure RBAC from access policies](https://learn.microsoft.com/azure/key-vault/general/rbac-migration).

## Features

**Discovery & Analysis**
Expand Down Expand Up @@ -74,6 +78,8 @@ KvRbacMigrator provides a comprehensive solution for:

## Quick Start

This Quick Start is the fastest path through the toolkit. For migration context — when to use it, how it fits with Azure Policy governance, and how to switch authentication mode safely — see the [Microsoft Learn how-to](https://learn.microsoft.com/azure/key-vault/general/rbac-migration-toolkit).

### 1. Install Prerequisites

```powershell
Expand Down Expand Up @@ -386,3 +392,5 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
---

**Important:** Always test in non-production environments first. Switching to RBAC disables access policy authorization immediately - ensure proper RBAC roles are assigned before switching authentication modes.

For end-to-end migration guidance, see [Migrate to Azure RBAC from access policies](https://learn.microsoft.com/azure/key-vault/general/rbac-migration) on Microsoft Learn.