Skip to content

Commit 28334ef

Browse files
authored
Merge pull request #204278 from SnehaSudhirG/11July-update3-managedidentity
Added a new section on checking role assignment
2 parents 0d0127a + 240f18b commit 28334ef

13 files changed

+34
-4
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5906,6 +5906,11 @@
59065906
"redirect_url": "source-control-integration",
59075907
"redirect_document_id": false
59085908
},
5909+
{
5910+
"source_path_from_root": "/articles/automation/manage-runas-account.md",
5911+
"redirect_url": "/azure/automation/manage-run-as-account",
5912+
"redirect_document_id": false
5913+
},
59095914
{
59105915
"source_path_from_root": "/articles/best-practices-availability-paired-regions.md",
59115916
"redirect_url": "/azure/availability-zones/cross-region-replication-azure",

articles/automation/manage-runas-account.md renamed to articles/automation/manage-run-as-account.md

Lines changed: 29 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,13 +38,13 @@ Use the following steps to renew the self-signed certificate.
3838

3939
1. Go to your Automation account and select **Run As Accounts** in the account settings section.
4040

41-
:::image type="content" source="media/manage-runas-account/automation-account-properties-pane.png" alt-text="Automation account properties pane.":::
41+
:::image type="content" source="media/manage-run-as-account/automation-account-properties-pane.png" alt-text="Automation account properties pane.":::
4242

4343
1. On the **Run As Accounts** properties page, select either **Run As Account** or **Classic Run As Account** depending on which account you need to renew the certificate for.
4444

4545
1. On the **Properties** page for the selected account, select **Renew certificate**.
4646

47-
:::image type="content" source="media/manage-runas-account/automation-account-renew-runas-certificate.png" alt-text="Renew certificate for Run As account.":::
47+
:::image type="content" source="media/manage-run-as-account/automation-account-renew-run-as-certificate.png" alt-text="Renew certificate for Run As account.":::
4848

4949
1. While the certificate is being renewed, you can track the progress under **Notifications** from the menu.
5050

@@ -98,6 +98,31 @@ For detailed steps for how to add role assignments, check out the following arti
9898

9999
After assigning the Run As account to the role, in your runbook specify `Set-AzContext -SubscriptionId "xxxx-xxxx-xxxx-xxxx"` to set the subscription context to use. For more information, see [Set-AzContext](/powershell/module/az.accounts/set-azcontext).
100100

101+
## Check role assignment for Azure Automation Run As account
102+
103+
To check the role assigned to the Automation Run As account Azure AD, follow these steps:
104+
105+
1. Sign in to the [Azure portal](https://portal.azure.com/).
106+
1. Go to your Automation account and in **Account Settings**, select **Run as accounts**.
107+
1. Select **Azure Run as Account** to view the **Application ID**.
108+
109+
:::image type="content" source="media/manage-run-as-account/automation-run-as-app-id.png" alt-text="Screenshot that describes on how to copy application ID.":::
110+
111+
1. Go to Azure portal and search for **Azure Active Directory**.
112+
1. On the **Active Directory Overview** page, **Overview** tab, in the search box, enter the Application ID.
113+
114+
:::image type="content" source="media/manage-run-as-account/active-directory-app-id-inline.png" alt-text="Screenshot that describes application ID copied in the Overview tab." lightbox="media/manage-run-as-account/active-directory-app-id-expanded.png":::
115+
116+
In the **Enterprise applications** section, you will see the display name of your Run As Account.
117+
118+
1. Select the application ID and in the properties page of that ID, go to **Overview** blade, **Properties**, and copy the name of the Enterprise application.
119+
1. Go to Azure portal and search for your **Subscription** and select your subscription.
120+
1. Go to **Access Control (IAM)**, **Role Assignment** and paste the name of the Enterprise application in the search box to view the App along with the role and scope assigned to it.
121+
For example: in the screenshot below, the Run As Account Azure AD App has the Contributor access at the subscription level.
122+
123+
:::image type="content" source="media/manage-run-as-account/check-role-assignments-inline.png" alt-text="Screenshot that describes how to view the role and scope assigned to the enterprise application." lightbox="media/manage-run-as-account/check-role-assignments-expanded.png":::
124+
125+
101126
## Limit Run As account permissions
102127

103128
To control the targeting of Automation against resources in Azure, you can run the [Update-AutomationRunAsAccountRoleAssignments.ps1](https://aka.ms/AA5hug8) script. This script changes your existing Run As account service principal to create and use a custom role definition. The role has permissions for all resources except [Key Vault](../key-vault/index.yml).
@@ -120,7 +145,7 @@ You can determine if the service principal used by your Run As account assigned
120145
1. Select **Azure Run As Account**.
121146
1. Select **Role** to locate the role definition that is being used.
122147

123-
:::image type="content" source="media/manage-runas-account/verify-role.png" alt-text="Verify the Run As Account role." lightbox="media/manage-runas-account/verify-role-expanded.png":::
148+
:::image type="content" source="media/manage-run-as-account/verify-role.png" alt-text="Verify the Run As Account role." lightbox="media/manage-run-as-account/verify-role-expanded.png":::
124149

125150
You can also determine the role definition used by the Run As accounts for multiple subscriptions or Automation accounts. Do this by using the [Check-AutomationRunAsAccountRoleAssignments.ps1](https://aka.ms/AA5hug5) script in the PowerShell Gallery.
126151

@@ -144,7 +169,7 @@ Some configuration items necessary for a Run As or Classic Run As account might
144169

145170
For such misconfiguration instances, the Automation account detects the changes and displays a status of *Incomplete* on the Run As Accounts properties pane for the account.
146171

147-
:::image type="content" source="media/manage-runas-account/automation-account-runas-config-incomplete.png" alt-text="Incomplete Run As account configuration.":::
172+
:::image type="content" source="media/manage-run-as-account/automation-account-run-as-config-incomplete.png" alt-text="Incomplete Run As account configuration.":::
148173

149174
When you select the Run As account, the account properties pane displays the following error message:
150175

147 KB
Loading
147 KB
Loading
81.1 KB
Loading
247 KB
Loading

0 commit comments

Comments
 (0)