Skip to content

Commit 3fff8a4

Browse files
committed
Fix numbering and screenshots
1 parent 1e23c80 commit 3fff8a4

File tree

1 file changed

+20
-14
lines changed

1 file changed

+20
-14
lines changed

CloudAppSecurityDocs/api-authentication-user.md

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,8 @@ In general, you need to take the following steps to use the APIs:
2525
This page explains how to create a Microsoft Entra application, get an access token to Microsoft Defender for Cloud Apps and validate the token.
2626

2727
>[!NOTE]
28-
> When accessing Microsoft Defender for Cloud Apps API on behalf of a user, you will need the correct Application permission and user permission.
29-
> If you are not familiar with user permissions on Microsoft Defender for Cloud Apps, see [Manage admin access](manage-admins.md).
28+
> When accessing Microsoft Defender for Cloud Apps API on behalf of a user, you'll need the correct Application permission and user permission.
29+
> If you aren't familiar with user permissions on Microsoft Defender for Cloud Apps, see [Manage admin access](manage-admins.md).
3030
3131
>[!TIP]
3232
> If you have the permission to perform an action in the portal, you have the permission to perform the action in the API.
@@ -57,31 +57,37 @@ This page explains how to create a Microsoft Entra application, get an access to
5757

5858
1. Allow your Application to access Microsoft Defender for Cloud Apps and assign it 'Read alerts' permission:
5959

60-
- On your application page, select **API Permissions** > **Add permission** > **APIs my organization uses** > type *Microsoft Cloud App Security* and then select **Microsoft Cloud App Security**.
60+
1. On your application page, select **API Permissions** > **Add permission** > **APIs my organization uses** > type *Microsoft Cloud App Security* and then select **Microsoft Cloud App Security**.
6161

62-
- **Note**: *Microsoft Cloud App Security* doesn't appear in the original list. Start writing its name in the text box to see it appear. Make sure to type this name, even though the product is now called Defender for Cloud Apps.
62+
> [!NOTE]
63+
> *Microsoft Cloud App Security* doesn't appear in the original list. Start writing its name in the text box to see it appear. Make sure to type this name, even though the product is now called Defender for Cloud Apps.
6364
6465
![Screenshot of adding permissions.](media/add-permission.png)
6566

66-
- Choose **Delegated permissions** > **Investigation.Read** > select **Add permissions**
67+
1. Choose **Delegated permissions** > **Investigation.Read** > select **Add permissions**
6768

68-
![Screenshot of adding application permissions.](media/application-permissions-public-client.png)
69+
:::image type="content" source="media/application-permissions-public-client.png" alt-text="Screenshot showing how to add application permissions.":::
6970

70-
- **Important note**: Select the relevant permissions. **Investigation.Read** is only an example. For other permission scopes, see [Supported permission scopes](#supported-permission-scopes)
7171

72-
- To determine which permission you need, view the **Permissions** section in the API you're interested to call.
72+
> [!NOTE]
73+
> Select the relevant permissions. **Investigation.Read** is only an example. For other permission scopes, see [Supported permission scopes](#supported-permission-scopes)
7374
74-
- Select **Grant admin consent**
75+
1. To determine which permission you need, view the **Permissions** section in the API you're interested to call.
7576

76-
**Note**: Every time you add permission you must select **Grant admin consent** for the new permission to take effect.
77+
1. Select **Grant admin consent**
7778

78-
![Screenshot of of granting admin permissions.](media/grant-consent.png)
79+
> [!NOTE]
80+
> Every time you add permission you must select **Grant admin consent** for the new permission to take effect.
7981
80-
1. Write down your application ID and your tenant ID:
82+
:::image type="content" source="media/api-authentication-application/grant-consent.png" alt-text="Screenshot that shows the option to grant admin consent." lightbox="media/api-authentication-application/grant-consent.png":::
8183

82-
- On your application page, go to **Overview** and copy the following information:
8384

84-
![Screenshot of the created app ID.](media/app-and-tenant-ids.png)
85+
1. Write down your application ID and your tenant ID.
86+
87+
1. On your application page, go to **Overview** and copy the following information:
88+
89+
:::image type="content" source="media/api-authentication-application/app-and-tenant-ids.png" alt-text="Screenshot that shows the created app ID." lightbox="media/api-authentication-application/app-and-tenant-ids.png":::
90+
8591

8692
## Supported permission scopes
8793

0 commit comments

Comments
 (0)