Skip to content

Commit ebb340e

Browse files
committed
more updates
1 parent 5709270 commit ebb340e

1 file changed

Lines changed: 25 additions & 18 deletions

File tree

articles/healthcare-apis/register-application.md

Lines changed: 25 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -19,35 +19,41 @@ In this article, you learn how to register a client application in Microsoft Ent
1919

2020
1. In the [Azure portal](https://portal.azure.com), select **Microsoft Entra ID**.
2121
2. Select **App registrations**.
22-
[ ![Screen shot of new app registration window.](media/register-application-new-app-registration.png) ](media/register-application-new-app-registration.png#lightbox)
22+
:::image type="content" source="media/register-application-new-app-registration.png" alt-text="Screen shot of new app registration window." lightbox="media/register-application-new-app-registration.png":::
23+
2324
3. Select **New registration**.
2425
4. For Supported account types, select **Accounts in this organization directory only**. Don't change the other options.
25-
[ ![Screenshot of new registration account options.](media/register-application-account-types.png) ](media/register-application-account-types.png#lightbox)
26+
:::image type="content" source="media/register-application-account-types.png" alt-text="Screenshot of new registration account options." lightbox="media/register-application-account-types.png":::
27+
2628
5. Select **Register**.
2729

2830
## Application ID (client ID)
2931

3032
After registering a new application, you can find the application (client) ID and Directory (tenant) ID in the **Overview** menu option. Make a note of the values for use later.
3133

32-
[![Screenshot of client ID overview panel.](media/register-application-app-overview.png) ](media/register-application-app-overview.png#lightbox)
34+
:::image type="content" source="media/register-application-app-overview.png" alt-text="Screenshot of client ID overview panel." lightbox="media/register-application-app-overview.png":::
35+
3336

3437
## Authentication setting: confidential vs. public
3538

36-
Select **Authentication** > **Settings** to review the settings. The default value for **Allow public client flows** is **No**.
39+
Select **Authentication** and the **Settings** tab to review the settings. The default value for **Allow public client flows** is **Disabled**.
3740

3841
If you keep this default value, the application registration is a **confidential client application** and requires a certificate or secret.
3942

40-
[ ![Screenshot of confidential client application.](media/register-application-allow-public-client-flows.png) ](media/register-application-allow-public-client-flows.png#lightbox)
43+
:::image type="content" source="media/register-application-allow-public-client-flows.png" alt-text="Screenshot of confidential client application."::: ](media/register-application-allow-public-client-flows.png#lightbox)
4144

42-
If you change the default value to **Yes** for the **Allow public client flows** option in the advanced setting, the application registration is a **public client application** and doesn't require a certificate or secret. The **Yes** value is useful when you want to build a public client application using the OAuth authorization protocol or features as described in [Public client and confidential client applications](/entra/identity-platform/msal-client-applications#when-should-you-enable-a-public-client-flow-in-your-app-registration).
45+
46+
If you enable the **Allow public client flows** option, the application registration is a public client application and doesn't require a certificate or secret. Public client applications are useful when you want to use the OAuth 2.0 authorization protocol or features as described in [Public client and confidential client applications](/entra/identity-platform/msal-client-applications#when-should-you-enable-a-public-client-flow-in-your-app-registration).
4347

4448
For tools that require a redirect URI, such as [OAuth 2.0](/entra/identity-platform/v2-app-types), go to the **Redirect URI configuration** tab and select **Add Redirect URI** to configure the platform.
4549

46-
[ ![Screenshot of select a platform.](media/register-application-select-platform.png) ](media/register-application-select-platform.png#lightbox)
50+
:::image type="content" source="media/register-application-select-platform.png" alt-text="Screenshot of select a platform." lightbox="media/register-application-select-platform.png":::
51+
52+
53+
For example, when you choose **Mobile and desktop applications**, you select the redirect URI for that platform.
4754

48-
For example, when you choose **Mobile and desktop applications**, you then select the redirect URI for that platform.
55+
:::image type="content" source="media/register-application-add-redirect-uri-mobile-desktop-platform.png" alt-text="Screenshot of configure other platform." lightbox="media/register-application-add-redirect-uri-mobile-desktop-platform.png":::
4956

50-
[ ![Screenshot of configure other platform.](media/register-application-add-redirect-uri-mobile-desktop-platform.png) ](media/register-application-add-redirect-uri-mobile-desktop-platform.png#lightbox)
5157

5258

5359

@@ -60,10 +66,10 @@ To create a new client secret, use the following steps.
6066
1. In **Add a client secret**, enter a **Description**.
6167
1. Accept the recommended 180-day value in the **Expires** field, or select a different value from the list.
6268
1. Select **Add**.
63-
[ ![Screenshot of certificates and secrets.](media/register-application-new-client-secret.png) ](media/register-application-new-client-secret.png#lightbox)
69+
:::image type="content" source="media/register-application-new-client-secret.png" alt-text="Screenshot of certificates and secrets." lightbox="media/register-application-new-client-secret.png":::
6470

6571
1. Copy the secret value by selecting the copy button next to the **Value**.
66-
[ ![Screenshot of copy client secret.](media/register-application-copy-client-secret.png) ](media/register-application-copy-client-secret.png#lightbox)
72+
:::image type="content" source="media/register-application-copy-client-secret.png" alt-text="Screenshot of copy client secret." lightbox="media/register-application-copy-client-secret.png":::
6773

6874

6975
>[!NOTE]
@@ -78,27 +84,28 @@ The following steps are required for the DICOM service, but optional for the FHI
7884

7985
1. Select **API permissions**.
8086

81-
[ ![Screenshot of API permission page with Add a permission button highlighted.](dicom/media/dicom-add-apis-permissions.png) ](dicom/media/dicom-add-apis-permissions.png#lightbox)
87+
:::image type="content" source="dicom/media/dicom-add-apis-permissions.png" alt-text="Screenshot of API permission page with Add a permission button highlighted." lightbox="dicom/media/dicom-add-apis-permissions.png":::
8288

8389
2. Select **Add a permission**.
8490

8591
If you're using Azure Health Data Services, add a permission to the DICOM service by searching for **Azure API for DICOM** under **APIs my organization** uses.
8692

87-
[ ![Screenshot of Search API permissions page with the APIs my organization uses tab selected.](dicom/media/dicom-search-apis-permissions.png) ](dicom/media/dicom-search-apis-permissions.png#lightbox)
93+
:::image type="content" source="dicom/media/dicom-search-apis-permissions.png" alt-text="Screenshot of Search API permissions page with the APIs my organization uses tab selected." lightbox="dicom/media/dicom-search-apis-permissions.png":::
8894

8995
The search result for Azure API for DICOM appears only if you already deployed the DICOM service in the workspace.
9096

9197
If you're referencing a different resource application, select your DICOM API Resource Application Registration that you created previously under **APIs my organization**.
9298

9399
3. Select scopes (permissions) that the confidential client application asks for on behalf of a user. Select **Dicom.ReadWrite**, and then select **Add permissions**.
94100

95-
[ ![Screenshot of scopes (permissions) that the client application will ask for on behalf of a user.](dicom/media/dicom-select-scope.png) ](dicom/media/dicom-select-scope.png#lightbox)
101+
:::image type="content" source="dicom/media/dicom-select-scope.png" alt-text="Screenshot of scopes (permissions) that the client application will ask for on behalf of a user." lightbox="dicom/media/dicom-select-scope.png":::
96102

97103
>[!NOTE]
98-
>Use `grant_type` of `client_credentials` when getting an access token for the FHIR service using tools such as REST Client. For more information, see [Accessing Azure Health Data Services using the REST Client Extension in Visual Studio Code](./fhir/using-rest-client.md).
104+
>Use `grant_type` of `client_credentials` when getting an access token for the FHIR service by using tools such as REST Client. For more information, see [Accessing Azure Health Data Services using the REST Client Extension in Visual Studio Code](./fhir/using-rest-client.md).
99105
>>Use `grant_type` of `client_credentials` or `authentication_code` when getting an access token for the DICOM service. For more information, see [Using DICOM with cURL](dicom/dicomweb-standard-apis-curl.md).
100106
101-
## Related content
107+
## Next steps
102108

103-
[Register an application with REST API](register-application-cli-rest.md)
104-
[Access Azure Health Data Services with a REST Client](fhir/using-rest-client.md)
109+
>[!NEXT STEPS]
110+
> - [Grant permissions to the client application](configure-azure-rbac.md)
111+
> - [Access Azure Health Data Services](access-healthcare-apis.md)

0 commit comments

Comments
 (0)