Skip to content

Commit 927e0e2

Browse files
authored
Merge pull request #95792 from DCtheGeek/dmc-bp-ghi42654
Fixes MicrosoftDocs/azure-docs#42654 - Clarifies MI info
2 parents 217b2a2 + b887bae commit 927e0e2

File tree

1 file changed

+23
-11
lines changed

1 file changed

+23
-11
lines changed

articles/governance/blueprints/concepts/deployment-stages.md

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Stages of a blueprint deployment
33
description: Learn the steps the Azure Blueprint services goes through during a deployment.
4-
ms.date: 03/14/2019
4+
ms.date: 11/13/2019
55
ms.topic: conceptual
66
---
77
# Stages of a blueprint deployment
@@ -24,17 +24,24 @@ takes the following high-level steps:
2424
## Blueprints granted owner rights
2525

2626
The Azure Blueprints service principal is granted owner rights to the assigned subscription or
27-
subscriptions. The granted role allows Blueprints to create, and later revoke, the [system-assigned
28-
managed identity](../../../active-directory/managed-identities-azure-resources/overview.md).
27+
subscriptions when a [system-assigned managed
28+
identity](../../../active-directory/managed-identities-azure-resources/overview.md) managed identity
29+
is used. The granted role allows Blueprints to create, and later revoke, the **system-assigned**
30+
managed identity. If using a **user-assigned** managed identity, the Azure Blueprints service
31+
principal doesn't get and doesn't need owner rights on the subscription.
2932

3033
The rights are granted automatically if the assignment is done through the portal. However, if the
3134
assignment is done through the REST API, granting the rights needs to be done with a separate API
3235
call. The Azure Blueprint AppId is `f71766dc-90d9-4b7d-bd9d-4499c4331c3f`, but the service principal
33-
varies by tenant. Use [Azure Active Directory Graph API](../../../active-directory/develop/active-directory-graph-api.md)
36+
varies by tenant. Use
37+
[Azure Active Directory Graph API](../../../active-directory/develop/active-directory-graph-api.md)
3438
and REST endpoint [servicePrincipals](/graph/api/resources/serviceprincipal) to get the service
35-
principal. Then, grant the Azure Blueprints the _Owner_ role through the [Portal](../../../role-based-access-control/role-assignments-portal.md),
36-
[Azure CLI](../../../role-based-access-control/role-assignments-cli.md), [Azure PowerShell](../../../role-based-access-control/role-assignments-powershell.md),
37-
[REST API](../../../role-based-access-control/role-assignments-rest.md), or a [Resource Manager template](../../../role-based-access-control/role-assignments-template.md).
39+
principal. Then, grant the Azure Blueprints the _Owner_ role through the
40+
[Portal](../../../role-based-access-control/role-assignments-portal.md),
41+
[Azure CLI](../../../role-based-access-control/role-assignments-cli.md),
42+
[Azure PowerShell](../../../role-based-access-control/role-assignments-powershell.md),
43+
[REST API](../../../role-based-access-control/role-assignments-rest.md), or a
44+
[Resource Manager template](../../../role-based-access-control/role-assignments-template.md).
3845

3946
The Blueprints service doesn't directly deploy the resources.
4047

@@ -48,15 +55,20 @@ While creating the blueprint assignment, the type of [managed
4855
identity](../../../active-directory/managed-identities-azure-resources/overview.md) is selected. The
4956
default is a **system-assigned** managed identity. A **user-assigned** managed identity can be
5057
chosen. When using a **user-assigned** managed identity, it must be defined and granted permissions
51-
before the blueprint assignment is created.
58+
before the blueprint assignment is created. Both the
59+
[Owner](../../../role-based-access-control/built-in-roles.md#owner) and
60+
[Blueprint Operator](../../../role-based-access-control/built-in-roles.md#blueprint-operator)
61+
built-in roles have the necessary `blueprintAssignment/write` permission to create an assignment
62+
that uses a **user-assigned** managed identity.
5263

5364
## Optional - Blueprints creates system-assigned managed identity
5465

5566
When [system-assigned managed
5667
identity](../../../active-directory/managed-identities-azure-resources/overview.md) is selected
57-
during assignment, Blueprints creates the identity and grants the managed identity the [owner](../../../role-based-access-control/built-in-roles.md#owner)
58-
role. If an [existing assignment is upgraded](../how-to/update-existing-assignments.md), Blueprints
59-
uses the previously created managed identity.
68+
during assignment, Blueprints creates the identity and grants the managed identity the
69+
[owner](../../../role-based-access-control/built-in-roles.md#owner) role. If an
70+
[existing assignment is upgraded](../how-to/update-existing-assignments.md), Blueprints uses the
71+
previously created managed identity.
6072

6173
The managed identity related to the blueprint assignment is used to deploy or redeploy the resources
6274
defined in the blueprint. This design avoids assignments inadvertently interfering with each other.

0 commit comments

Comments
 (0)