Skip to content

Commit d12ed4f

Browse files
authored
Update okta-integration.md
Alt text must be at least 40 characters long and at most 150 characters long.
1 parent 41d82ba commit d12ed4f

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

ATPDocs/okta-integration.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -48,18 +48,18 @@ This section provides instructions for connecting Microsoft Defender for Identit
4848
1. Select **Tokens**
4949
1. Select **Create Token**.
5050

51-
:::image type="content" source="media/okta-integration/create-an-okta-token.png" alt-text="Screenshot of the Okta admin portal showing the left-hand navigation menu. The Security section is expanded, displaying options such as General, Authentication Policies, Identity Providers, and others. The API option is highlighted at the bottom of the Security section, indicating where to access API settings.":::
51+
:::image type="content" source="media/okta-integration/create-an-okta-token.png" alt-text="Screenshot of the Okta admin portal navigation menu. The API option is highlighted, showing where to access API settings.":::
5252

5353
1. In the Create token pop-up:
5454
1. Enter a name for your Defender for Identity token
5555
2. Select Any IP
5656
3. Select Create token.
5757

58-
:::image type="content" source="media/okta-integration/enter-okta-token-details.png" alt-text="Screenshot of the Okta admin portal on the API > Tokens tab. The interface displays options for Authorization Servers, Tokens, and Trusted Origins. The “Create token” button is highlighted in the lower left area of the screen, indicating where to generate a new API token.":::
58+
:::image type="content" source="media/okta-integration/enter-okta-token-details.png" alt-text="Screenshot of the Okta admin portal on the API > Tokens tab, indicating how to generate a new API token.":::
5959

6060
1. In the **Token created successfully** pop-up, copy the **Token value** and store it securely. This token is used to connect Okta to Defender for Identity.
6161

62-
:::image type="content" source="media/okta-integration/okta-token-created-successfully.png" alt-text="Screenshot of the Okta token creation confirmation dialog. A success message states, “Token created successfully!” followed by a warning to save the token now, as it won’t be shown again. Below, the Token Value field displays the token with a copy button.":::
62+
:::image type="content" source="media/okta-integration/okta-token-created-successfully.png" alt-text="Screenshot of the Okta token creation success message.":::
6363

6464
### Add Custom user attributes
6565

@@ -81,7 +81,7 @@ This section provides instructions for connecting Microsoft Defender for Identit
8181
1. Select Save.
8282
1. Verify that the three custom attributes you added are displayed correctly.
8383

84-
:::image type="content" source="media/okta-integration/okta-custom-attributes.png" alt-text="Screenshot of the Okta Attributes page. The table lists custom attributes with columns for Display Name, Variable Name, Data type, and Attribute Type. Three attributes are shown: ObjectGuid, DistinguishedName, and ObjectSid. An “Add Attribute” button appears at the top of the table..":::
84+
:::image type="content" source="media/okta-integration/okta-custom-attributes.png" alt-text="Screenshot of the Okta Attributes page. Three attributes are shown: ObjectGuid, DistinguishedName, and ObjectSid.":::
8585

8686

8787
### Create a custom Okta role
@@ -101,7 +101,7 @@ After assigning both roles, you can remove the Super Admin role. This ensures th
101101
- **View roles, resources, and admin assignments**
102102
1. Select **Save role**.
103103

104-
:::image type="content" source="media/okta-integration/okta-permissions.png" alt-text="Screenshot showing a list of Okta permissions that need to be assigned when adding a custom role. The User section includes selected permissions such as Suspend users, Unsuspend users, and Clear users sessions. The Identity and Access Management section includes View roles, resources, and admin assignments.":::
104+
:::image type="content" source="media/okta-integration/okta-permissions.png" alt-text="Screenshot showing a list of Okta permissions that need to be assigned when adding a custom role.":::
105105

106106
### Create a resource set
107107

@@ -112,7 +112,7 @@ After assigning both roles, you can remove the Super Admin role. This ensures th
112112
- **All users**
113113
- **All Identity and Access Management resources**
114114

115-
:::image type="content" source="media/okta-integration/resource-set-information.png" alt-text="The resource set is named and described as Microsoft Defender for Identity. Under Resources, two entries are listed: Users with All users and Identity and Access Management with All Identity and Access Management resources.":::
115+
:::image type="content" source="media/okta-integration/resource-set-information.png" alt-text="Screenshot that shows the resource set name is Microsoft Defender for Identity.":::
116116

117117

118118
1. Select **Save selection**.
@@ -135,17 +135,17 @@ To complete the configuration in Okta, assign the custom role and resource set t
135135
1. Navigate to the Microsoft Defender Portal
136136
1. Select **Settings** > **Identities** > **Okta integration**
137137

138-
:::image type="content" source="media/okta-integration/select-settings-okta-integration.png" alt-text="Screenshot showing the Microsoft Defender for Identity settings page. The Settings menu is selected in the left-hand navigation pane, and under General, the Okta Integration option is highlighted. The right panel displays options to connect or disconnect Okta instances":::
138+
:::image type="content" source="media/okta-integration/select-settings-okta-integration.png" alt-text="Screenshot showing the Microsoft Defender for Identity settings page with the Okta Integration option is highlighted.":::
139139

140140
1. Select **+Connect Okta instance**.
141141
1. Enter your Okta domain (for example, acme.okta.com).
142142
1. Paste the API token you copied from your Okta account.
143143
1. Select **Save**.
144144

145-
:::image type="content" source="media/okta-integration/connect-okta-instance.png" alt-text=".":::
145+
:::image type="content" source="media/okta-integration/connect-okta-instance.png" alt-text="Screenshot showing how to connect your Okta instance.":::
146146
1. Verify that your Okta environment appears in the table as enabled.
147147

148-
:::image type="content" source="media/okta-integration/new-okta-domain.png" alt-text="Screenshot showing the Connect Okta Instance configuration screen in the Microsoft Defender portal. The screen includes required fields for Okta domain name and API token. The integration is toggled to “Enabled.” A blue Save button appears at the bottom of the screen.":::
148+
:::image type="content" source="media/okta-integration/new-okta-domain.png" alt-text="Screenshot that shows the Okta environment has been added and is enabled.":::
149149

150150
## Related articles
151151

0 commit comments

Comments
 (0)