You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/role-based-access-control/classic-administrators.md
+24-30Lines changed: 24 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Azure classic subscription administrators
3
-
description: Describes the retirement of the Co-Administrator and Service Administrator roles and how to replace or remove these role assignments.
3
+
description: Describes the retirement of the Co-Administrator and Service Administrator roles and how to convert these role assignments.
4
4
author: rolyon
5
5
manager: amycolannino
6
6
@@ -14,17 +14,17 @@ ms.reviewer: bagovind
14
14
# Azure classic subscription administrators
15
15
16
16
> [!IMPORTANT]
17
-
> Classic resources and classic administrators are [retired as of August 31, 2024](https://azure.microsoft.com/updates/cloud-services-retirement-announcement/). Replace or remove classic administrators and use Azure RBAC instead for fine-grained access control.
17
+
> As of **August 31, 2024**, Azure classic administrator roles (along with Azure classic resources and Azure Service Manager) are retired and no longer supported.
18
18
19
19
Microsoft recommends that you manage access to Azure resources using Azure role-based access control (Azure RBAC). If you're still using the classic deployment model, you'll need to migrate your resources from classic deployment to Resource Manager deployment. For more information, see [Azure Resource Manager vs. classic deployment](../azure-resource-manager/management/deployment-models.md).
20
20
21
-
If you still have classic administrators, you should replace or remove these role assignments. This article describes the retirement of the Co-Administrator and Service Administrator roles and how to replace or remove these role assignments.
21
+
If you still have active Co-Administrator or Service Administrator role assignments, convert these roles to Azure RBAC immediately. This article describes the retirement of the Co-Administrator and Service Administrator roles and how to convert these role assignments.
22
22
23
23
## Frequently asked questions
24
24
25
-
Do Co-Administrators and Service Administrator lose access after August 31, 2024?
25
+
What happens to classic administrator role assignments after August 31, 2024?
26
26
27
-
-Starting on August 31, 2024, Microsoft will start the process to remove access for Co-Administrators and Service Administrator.
27
+
-Co-Administrator and Service Administrator roles are retired and no longer supported. You should convert these roles to Azure RBAC immediately.
28
28
29
29
How do I know what subscriptions have classic administrators?
30
30
@@ -40,11 +40,11 @@ What is the equivalent Azure role I should assign for Service Administrator?
40
40
41
41
Why do I need to migrate to Azure RBAC?
42
42
43
-
-Classic administrators are retired. Azure RBAC offers fine grained access control, compatibility with Microsoft Entra Privileged Identity Management (PIM), and full audit logs support. All future investments will be in Azure RBAC.
43
+
- Azure RBAC offers fine grained access control, compatibility with Microsoft Entra Privileged Identity Management (PIM), and full audit logs support. All future investments will be in Azure RBAC.
44
44
45
45
What about the Account Administrator role?
46
46
47
-
- The Account Administrator is the primary user for your billing account. Account Administrator isn't being deprecated and you don't need to replace this role assignment. Account Administrator and Service Administrator might be the same user. However, you only need to replace or remove the Service Administrator role assignment.
47
+
- The Account Administrator is the primary user for your billing account. Account Administrator isn't being deprecated and you don't need to convert this role assignment. Account Administrator and Service Administrator might be the same user. However, you only need to convert the Service Administrator role assignment.
48
48
49
49
What should I do if I lose access to a subscription?
50
50
@@ -112,7 +112,7 @@ Follow these steps to list the number of Service Administrator and Co-Administra
112
112
113
113
## Co-Administrators retirement
114
114
115
-
If you still have classic administrators, use the following steps to help you replace or remove Co-Administrator role assignments.
115
+
If you still have classic administrators, use the following steps to help you convert Co-Administrator role assignments.
116
116
117
117
### Step 1: Review your current Co-Administrators
118
118
@@ -134,7 +134,7 @@ If you still have classic administrators, use the following steps to help you re
134
134
135
135
1. After reviewing activity of user, if user is no longer active, [remove Co-Administrator](#how-to-remove-a-co-administrator).
136
136
137
-
### Step 3: Replace Co-Administrators with job function roles
137
+
### Step 3: Convert Co-Administrators to job function roles
138
138
139
139
Most users don't need the same permissions as a Co-Administrator. Consider a job function role instead.
140
140
@@ -146,25 +146,25 @@ Most users don't need the same permissions as a Co-Administrator. Consider a job
### Step 4: Replace Co-Administrators with Owner role and constraints
149
+
### Step 4: Convert Co-Administrators to Owner role with conditions
150
150
151
151
Some users might need more access than what a job function role can provide. If you must assign the [Owner](built-in-roles.md#owner) role, consider adding a condition or using Microsoft Entra Privileged Identity Management (PIM) to constrain the role assignment.
152
152
153
-
1. Assign the Owner role with constraints.
153
+
1. Assign the Owner role with conditions.
154
154
155
155
For example, assign the [Owner role at subscription scope with conditions](role-assignments-portal-subscription-admin.yml). If you have PIM, make the user [eligible for Owner role assignment](/entra/id-governance/privileged-identity-management/pim-resource-roles-assign-roles).
### Step 5: Replace Co-Administrators with Owner role
159
+
### Step 5: Convert Co-Administrators to Owner role
160
160
161
161
If a user must be an administrator for a subscription, assign the [Owner](built-in-roles.md#owner) role at subscription scope.
162
162
163
-
- Follow the steps in [Replace a Co-Administrator with Owner role](#replace-a-co-administrator-with-owner-role).
163
+
- Follow the steps in [How to convert a Co-Administrator with Owner role](#how-to-convert-a-co-administrator-to-owner-role).
164
164
165
-
### How to replace a Co-Administrator with Owner role
165
+
### How to convert a Co-Administrator to Owner role
166
166
167
-
The easiest way to replace a Co-Administrator role assignment with the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
167
+
The easiest way to covert a Co-Administrator role assignment to the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
168
168
169
169
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
170
170
@@ -174,13 +174,13 @@ The easiest way to replace a Co-Administrator role assignment with the [Owner](b
174
174
175
175
1. Select the **Classic administrators** tab to view a list of the Co-Administrators.
176
176
177
-
1. For the Co-Administrator you want to replace with the Owner role, under the **Remediate** column, select the **Assign RBAC role** link.
177
+
1. For the Co-Administrator you want to convert to the Owner role, under the **Remediate** column, select the **Assign RBAC role** link.
178
178
179
179
1. In the **Add role assignment** pane, review the role assignment.
180
180
181
181
:::image type="content" source="./media/classic-administrators/remediate-assign-role.png" alt-text="Screenshot of Add role assignment pane after selecting Assign RBAC role link." lightbox="./media/classic-administrators/remediate-assign-role.png":::
182
182
183
-
1. Select **Review + assign** to remove the Co-Administrator role assignment and assign the Owner role.
183
+
1. Select **Review + assign** to assign the Owner role and remove the Co-Administrator role assignment.
184
184
185
185
### How to remove a Co-Administrator
186
186
@@ -204,7 +204,7 @@ Follow these steps to remove a Co-Administrator.
204
204
205
205
## Service Administrator retirement
206
206
207
-
If you still have classic administrators, use the following steps to help you replace or remove Service Administrator role assignment. Before you 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.
207
+
If you still have classic administrators, use the following steps to help you convert the Service Administrator role assignment. Before you 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.
208
208
209
209
### Step 1: Review your current Service Administrator
210
210
@@ -222,19 +222,19 @@ The user that is assigned the Service Administrator role might also be the same
222
222
223
223
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).
224
224
225
-
### Step 3: Replace Service Administrator with Owner role
225
+
### Step 3: Convert Service Administrator to Owner role
226
226
227
227
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.
228
228
229
-
1. If Service Administrator user is a Microsoft account and you want this user to keep the same permissions, [replace the Service Administrator with Owner role](#replace-the-service-administrator-with-owner-role).
229
+
1. If Service Administrator user is a Microsoft account and you want this user to keep the same permissions, [convert the Service Administrator to Owner role](#how-to-convert-the-service-administrator-to-owner-role).
230
230
231
-
1. If Service Administrator user is a Microsoft Entra account and you want this user to keep the same permissions, [replace the Service Administrator with Owner role](#replace-the-service-administrator-with-owner-role).
231
+
1. If Service Administrator user is a Microsoft Entra account and you want this user to keep the same permissions, [convert the Service Administrator to Owner role](#how-to-convert-the-service-administrator-to-owner-role).
232
232
233
233
1. If you want to change the Service Administrator user to a different user, [assign the Owner role](role-assignments-portal.yml) to this new user at subscription scope without conditions. Then, [remove the Service Administrator](#how-to-remove-the-service-administrator).
234
234
235
-
### How to replace the Service Administrator with Owner role
235
+
### How to convert the Service Administrator to Owner role
236
236
237
-
The easiest way to replace the Service Administrator role assignment with the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
237
+
The easiest way to convert the Service Administrator role assignment to the [Owner](built-in-roles.md#owner) role at subscription scope is to use the **Remediate** steps.
238
238
239
239
1. Sign in to the [Azure portal](https://portal.azure.com) as an [Owner](built-in-roles.md#owner) of a subscription.
240
240
@@ -250,7 +250,7 @@ The easiest way to replace the Service Administrator role assignment with the [O
250
250
251
251
:::image type="content" source="./media/classic-administrators/remediate-assign-role.png" alt-text="Screenshot of Add role assignment pane after selecting Assign RBAC role link." lightbox="./media/classic-administrators/remediate-assign-role.png":::
252
252
253
-
1. Select **Review + assign** to remove the Service Administrator role assignment and assign the Owner role.
253
+
1. Select **Review + assign** to assign the Owner role and remove the Service Administrator role assignment.
254
254
255
255
### How to remove the Service Administrator
256
256
@@ -273,12 +273,6 @@ The easiest way to replace the Service Administrator role assignment with the [O
273
273
274
274
:::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":::
275
275
276
-
If the Service Administrator user is not in the directory, you might get the following error when you try to remove the Service Administrator:
277
-
278
-
`Call GSM to delete service admin on subscription <subscriptionId> failed. Exception: Cannot delete user <principalId> since they are not the service administrator. Please retry with the right service administrator user PUID.`
279
-
280
-
If the Service Administrator user is not in the directory, try to change the Service Administrator to an existing user and then try to remove the Service Administrator.
281
-
282
276
## Next steps
283
277
284
278
- [Understand the different roles](../role-based-access-control/rbac-and-directory-admin-roles.md)
0 commit comments