Skip to content

Commit bfc5578

Browse files
authored
Merge pull request #268840 from rolyon/rolyon-rbac-classic-admins-service-admin
[Azure RBAC] Prepare for Service Administrator retirement
2 parents d6af49c + e2121bf commit bfc5578

File tree

5 files changed

+77
-74
lines changed

5 files changed

+77
-74
lines changed
Lines changed: 75 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Azure classic subscription administrators
3-
description: Describes how to remove or change the Azure Co-Administrator and Service Administrator roles, and how to view the Account Administrator.
3+
description: Describes how to prepare for the retirement of the Co-Administrator and Service Administrator roles and how to remove or change these role assignments.
44
author: rolyon
55
manager: amycolannino
66

77
ms.service: role-based-access-control
88
ms.topic: how-to
9-
ms.date: 03/08/2024
9+
ms.date: 03/15/2024
1010
ms.author: rolyon
1111
ms.reviewer: bagovind
1212
---
@@ -16,21 +16,25 @@ ms.reviewer: bagovind
1616
> [!IMPORTANT]
1717
> Classic resources and classic administrators will be [retired on August 31, 2024](https://azure.microsoft.com/updates/cloud-services-retirement-announcement/). Starting April 3, 2024, you won't be able to add new Co-Administrators. This date was recently extended. Remove unnecessary Co-Administrators and use Azure RBAC for fine-grained access control.
1818
19-
Microsoft recommends that you manage access to Azure resources using Azure role-based access control (Azure RBAC). However, if you are still using the classic deployment model, you'll need to use a classic subscription administrator role: Service Administrator and Co-Administrator. For information about how to migrate your resources from classic deployment to Resource Manager deployment, see [Azure Resource Manager vs. classic deployment](../azure-resource-manager/management/deployment-models.md).
19+
Microsoft recommends that you manage access to Azure resources using Azure role-based access control (Azure RBAC). However, if you're still using the classic deployment model, you'll need to use a classic subscription administrator role: Service Administrator and Co-Administrator. For information about how to migrate your resources from classic deployment to Resource Manager deployment, see [Azure Resource Manager vs. classic deployment](../azure-resource-manager/management/deployment-models.md).
2020

21-
This article describes how to remove or change the Co-Administrator and Service Administrator roles, and how to view the Account Administrator.
21+
This article describes how to prepare for the retirement of the Co-Administrator and Service Administrator roles and how to remove or change these role assignments.
2222

2323
## Frequently asked questions
2424

25-
Will Co-Administrators lose access after August 31, 2024?
25+
Will Co-Administrators and Service Administrator lose access after August 31, 2024?
2626

27-
- Starting on August 31, 2024, Microsoft will start the process to remove access for Co-Administrators.
27+
- Starting on August 31, 2024, Microsoft will start the process to remove access for Co-Administrators and Service Administrator.
2828

2929
What is the equivalent Azure role I should assign for Co-Administrators?
3030

3131
- [Owner](built-in-roles.md#owner) role at subscription scope has the equivalent access. However, Owner is a [privileged administrator role](role-assignments-steps.md#privileged-administrator-roles) and grants full access to manage Azure resources. You should consider a job function role with fewer permissions, reduce the scope, or add a condition.
3232

33-
What should I do if I have a strong dependency on Co-Administrators?
33+
What is the equivalent Azure role I should assign for Service Administrator?
34+
35+
- [Owner](built-in-roles.md#owner) role at subscription scope has the equivalent access.
36+
37+
What should I do if I have a strong dependency on Co-Administrators or Service Administrator?
3438

3539
- Email [email protected] and describe your scenario.
3640

@@ -40,15 +44,17 @@ Use the following steps to help you prepare for the Co-Administrator role retire
4044

4145
### Step 1: Review your current Co-Administrators
4246

47+
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
48+
4349
1. Use the Azure portal to [get a list of your Co-Administrators](#view-classic-administrators).
4450

45-
1. Review the [sign-in logs](/entra/identity/monitoring-health/concept-sign-ins) for your Co-Administrators to assess whether they are active users.
51+
1. Review the [sign-in logs](/entra/identity/monitoring-health/concept-sign-ins) for your Co-Administrators to assess whether they're active users.
4652

4753
### Step 2: Remove Co-Administrators that no longer need access
4854

4955
1. If user is no longer in your enterprise, [remove Co-Administrator](#remove-a-co-administrator).
5056

51-
1. If user was deleted, but their Co-Administrator assignment was not removed, [remove Co-Administrator](#remove-a-co-administrator).
57+
1. If user was deleted, but their Co-Administrator assignment wasn't removed, [remove Co-Administrator](#remove-a-co-administrator).
5258

5359
Users that have been deleted typically include the text **(User was not found in this directory)**.
5460

@@ -76,6 +82,38 @@ Some users might need more access than what a job function role can provide. If
7682

7783
1. [Remove Co-Administrator](#remove-a-co-administrator).
7884

85+
## Prepare for Service Administrator retirement
86+
87+
Use the following steps to help you prepare for Service Administrator role retirement. To remove the Service Administrator, you must have at least one user who is assigned the Owner role at subscription scope without conditions to avoid orphaning the subscription. A subscription Owner has the same access as the Service Administrator.
88+
89+
### Step 1: Review your current Service Administrator
90+
91+
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
92+
93+
1. Use the Azure portal to [get your Service Administrator](#view-classic-administrators).
94+
95+
1. Review the [sign-in logs](/entra/identity/monitoring-health/concept-sign-ins) for your Service Administrator to assess whether they're an active user.
96+
97+
### Step 2: Review your current Billing account owners
98+
99+
The user that is assigned the Service Administrator role might also be the same user that is the administrator for your billing account. You should review your current Billing account owners to ensure they are still accurate.
100+
101+
1. Use the Azure portal to [get your Billing account owners](../cost-management-billing/manage/understand-mca-roles.md#manage-billing-roles-in-the-azure-portal).
102+
103+
1. Review your list of Billing account owners. If necessary, [update or add another Billing account owner](../cost-management-billing/manage/understand-mca-roles.md#manage-billing-roles-in-the-azure-portal).
104+
105+
### Step 3: Replace existing Service Administrator with Owner role
106+
107+
Your Service Administrator might be a Microsoft account or a Microsoft Entra account. A Microsoft account is a personal account such as Outlook, OneDrive, Xbox LIVE, or Microsoft 365. A Microsoft Entra account is an identity created through Microsoft Entra ID.
108+
109+
1. If Service Administrator user is a Microsoft account and you want this user to keep the same permissions, [assign the Owner role](role-assignments-portal.md) to this user at subscription scope without conditions.
110+
111+
1. If Service Administrator user is a Microsoft Entra account and you want this user to keep the same permissions, [assign the Owner role](role-assignments-portal.md) to this user at subscription scope without conditions.
112+
113+
1. If you want to change the Service Administrator user to a different user, [assign the Owner role](role-assignments-portal.md) to this new user at subscription scope without conditions.
114+
115+
1. [Remove the Service Administrator](#remove-the-service-administrator).
116+
79117
## View classic administrators
80118

81119
Follow these steps to view the Service Administrator and Co-Administrators for a subscription using the Azure portal.
@@ -84,11 +122,11 @@ Follow these steps to view the Service Administrator and Co-Administrators for a
84122

85123
1. Open [Subscriptions](https://portal.azure.com/#blade/Microsoft_Azure_Billing/SubscriptionsBlade) and select a subscription.
86124

87-
1. Click **Access control (IAM)**.
125+
1. Select **Access control (IAM)**.
88126

89-
1. Click the **Classic administrators** tab to view a list of the Co-Administrators.
127+
1. Select the **Classic administrators** tab to view a list of the Co-Administrators.
90128

91-
![Screenshot that opens Classic administrators.](./media/shared/classic-administrators.png)
129+
:::image type="content" source="./media/shared/classic-administrators.png" alt-text="Screenshot of Access control (IAM) page with Classic administrators tab selected." lightbox="./media/shared/classic-administrators.png":::
92130

93131
## Remove a Co-Administrator
94132

@@ -101,17 +139,17 @@ Follow these steps to remove a Co-Administrator.
101139

102140
1. Open [Subscriptions](https://portal.azure.com/#blade/Microsoft_Azure_Billing/SubscriptionsBlade) and select a subscription.
103141

104-
1. Click **Access control (IAM)**.
142+
1. Select **Access control (IAM)**.
105143

106-
1. Click the **Classic administrators** tab to view a list of the Co-Administrators.
144+
1. Select the **Classic administrators** tab to view a list of the Co-Administrators.
107145

108146
1. Add a check mark next to the Co-Administrator you want to remove.
109147

110-
1. Click **Remove**.
148+
1. Select **Remove**.
111149

112-
1. In the message box that appears, click **Yes**.
150+
1. In the message box that appears, select **Yes**.
113151

114-
![Screenshot that removes co-administrator.](./media/classic-administrators/remove-coadmin.png)
152+
:::image type="content" source="./media/classic-administrators/remove-coadmin.png" alt-text="Screenshot of message box when removing a Co-Administrator." lightbox="./media/classic-administrators/remove-coadmin.png":::
115153

116154
## Add a Co-Administrator
117155

@@ -126,19 +164,19 @@ Follow these steps to remove a Co-Administrator.
126164

127165
Co-Administrators can only be assigned at the subscription scope.
128166

129-
1. Click **Access control (IAM)**.
167+
1. Select **Access control (IAM)**.
130168

131-
1. Click the **Classic administrators** tab.
169+
1. Select the **Classic administrators** tab.
132170

133-
![Screenshot that opens Classic administrators](./media/shared/classic-administrators.png)
171+
:::image type="content" source="./media/shared/classic-administrators.png" alt-text="Screenshot of Access control (IAM) page with Classic administrators tab selected." lightbox="./media/shared/classic-administrators.png":::
134172

135-
1. Click **Add** > **Add co-administrator** to open the Add co-administrators pane.
173+
1. Select **Add** > **Add co-administrator** to open the Add co-administrators pane.
136174

137-
If the Add co-administrator option is disabled, you do not have permissions.
175+
If the **Add co-administrator** option is disabled, you don't have permissions.
138176

139-
1. Select the user that you want to add and click **Add**.
177+
1. Select the user that you want to add and select **Add**.
140178

141-
![Screenshot that adds co-administrator](./media/classic-administrators/add-coadmin.png)
179+
:::image type="content" source="./media/classic-administrators/add-coadmin.png" alt-text="Screenshot of Add co-administrator pane to add a Co-Administrator." lightbox="./media/classic-administrators/add-coadmin.png":::
142180

143181
## Add a guest user as a Co-Administrator
144182

@@ -175,36 +213,21 @@ The user with the Account Administrator role can access the Azure portal and man
175213

176214
Follow these steps to change the Service Administrator in the Azure portal.
177215

178-
1. Make sure your scenario is supported by checking the [limitations for changing the Service Administrator](#limitations-for-changing-the-service-administrator).
179-
180216
1. Sign in to the [Azure portal](https://portal.azure.com) as the Account Administrator.
181217

182218
1. Open **Cost Management + Billing** and select a subscription.
183219

184-
1. In the left navigation, click **Properties**.
220+
1. In the left navigation, select **Properties**.
185221

186-
1. Click **Change service admin**.
222+
1. Select **Change service admin**.
187223

188-
![Screenshot showing the subscription properties in the Azure portal](./media/classic-administrators/service-admin.png)
224+
:::image type="content" source="./media/classic-administrators/service-admin.png" alt-text="Screenshot of subscription properties page that shows option to change Service Administrator." lightbox="./media/classic-administrators/service-admin.png":::
189225

190226
1. In the **Edit service admin** page, enter the email address for the new Service Administrator.
191227

192-
![Screenshot showing the Edit service admin page](./media/classic-administrators/service-admin-edit.png)
193-
194-
1. Click **OK** to save the change.
195-
196-
### Limitations for changing the Service Administrator
197-
198-
There can only be one Service Administrator per Azure subscription. Changing the Service Administrator will behave differently depending on whether the Account Administrator is a Microsoft account or whether it is a Microsoft Entra account (work or school account).
199-
200-
| Account Administrator account | Can change the Service Administrator to a different Microsoft account? | Can change the Service Administrator to a Microsoft Entra account in the same directory? | Can change the Service Administrator to a Microsoft Entra account in a different directory? |
201-
| --- | --- | --- | --- |
202-
| Microsoft account | Yes | No | No |
203-
| Microsoft Entra account | Yes | Yes | No |
204-
205-
If the Account Administrator is a Microsoft Entra account, you can change the Service Administrator to a Microsoft Entra account in the same directory, but not in a different directory. For example, [email protected] can change the Service Administrator to [email protected], but cannot change the Service Administrator to [email protected] unless [email protected] has a presence in the contoso.com directory.
228+
:::image type="content" source="./media/classic-administrators/service-admin-edit.png" alt-text="Screenshot of Edit service admin pane to change Service Administrator." lightbox="./media/classic-administrators/service-admin-edit.png":::
206229

207-
For more information about Microsoft accounts and Microsoft Entra accounts, see [What is Microsoft Entra ID?](../active-directory/fundamentals/active-directory-whatis.md).
230+
1. Select **OK** to save the change.
208231

209232
## Remove the Service Administrator
210233

@@ -214,36 +237,20 @@ To remove the Service Administrator, you must have a user who is assigned the [O
214237

215238
1. Open [Subscriptions](https://portal.azure.com/#blade/Microsoft_Azure_Billing/SubscriptionsBlade) and select a subscription.
216239

217-
1. Click **Access control (IAM)**.
240+
1. Select **Access control (IAM)**.
218241

219-
1. Click the **Classic administrators** tab.
242+
1. Select the **Classic administrators** tab.
220243

221244
1. Add a check mark next to the Service Administrator.
222245

223-
1. Click **Remove**.
224-
225-
1. In the message box that appears, click **Yes**.
226-
227-
![Screenshot that removes service administrator.](./media/classic-administrators/service-admin-remove.png)
228-
229-
## View the Account Administrator
230-
231-
The Account Administrator is the user that initially signed up for the Azure subscription, and is responsible as the billing owner of the subscription. To change the Account Administrator of a subscription, see [Transfer ownership of an Azure subscription to another account](../cost-management-billing/manage/billing-subscription-transfer.md).
232-
233-
Follow these steps to view the Account Administrator.
234-
235-
1. Sign in to the [Azure portal](https://portal.azure.com).
236-
237-
1. Open **Cost Management + Billing** and select a subscription.
238-
239-
1. In the left navigation, click **Properties**.
246+
1. Select **Remove**.
240247

241-
The Account Administrator of the subscription is displayed in the **Account Admin** box.
248+
1. In the message box that appears, select **Yes**.
242249

243-
![Screenshot showing the Account Administrator](./media/classic-administrators/account-admin.png)
250+
:::image type="content" source="./media/classic-administrators/service-admin-remove.png" alt-text="Screenshot of remove classic administrator message when removing a Service Administrator." lightbox="./media/classic-administrators/service-admin-remove.png":::
244251

245252
## Next steps
246253

247-
* [Understand the different roles](../role-based-access-control/rbac-and-directory-admin-roles.md)
248-
* [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md)
249-
* [Add or change Azure subscription administrators](../cost-management-billing/manage/add-change-subscription-administrator.md)
254+
- [Understand the different roles](../role-based-access-control/rbac-and-directory-admin-roles.md)
255+
- [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md)
256+
- [Understand Microsoft Customer Agreement administrative roles in Azure](../cost-management-billing/manage/understand-mca-roles.md)
Binary file not shown.

articles/role-based-access-control/rbac-and-directory-admin-roles.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ manager: amycolannino
66
ms.assetid: 174f1706-b959-4230-9a75-bf651227ebf6
77
ms.service: role-based-access-control
88
ms.topic: overview
9-
ms.date: 03/08/2024
9+
ms.date: 03/15/2024
1010
ms.author: rolyon
1111
ms.custom: it-pro;
1212
---
@@ -108,10 +108,6 @@ In the Azure portal, you can manage Co-Administrators or view the Service Admini
108108

109109
:::image type="content" source="./media/shared/classic-administrators.png" alt-text="Screenshot of Azure classic subscription administrators in the Azure portal." lightbox="./media/shared/classic-administrators.png":::
110110

111-
In the Azure portal, you can view or change the Service Administrator or view the Account Administrator on the properties page of your subscription.
112-
113-
:::image type="content" source="./media/rbac-and-directory-admin-roles/account-admin.png" alt-text="Screenshot of Account Administrator and Service Administrator in the Azure portal." lightbox="./media/rbac-and-directory-admin-roles/account-admin.png":::
114-
115111
For more information, see [Azure classic subscription administrators](classic-administrators.md).
116112

117113
### Azure account and Azure subscriptions

articles/role-based-access-control/transfer-subscription.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ To get a list of some of the Azure resources that are impacted when you transfer
9696
To complete these steps, you will need:
9797

9898
- [Bash in Azure Cloud Shell](../cloud-shell/overview.md) or [Azure CLI](/cli/azure)
99-
- Account Administrator of the subscription you want to transfer in the source directory
99+
- Billing account owner of the subscription you want to transfer in the source directory
100100
- A user account in both the source and target directory for the user making the directory change
101101

102102
## Step 1: Prepare for the transfer

0 commit comments

Comments
 (0)