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/healthcare-apis/register-application.md
+25-18Lines changed: 25 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,35 +19,41 @@ In this article, you learn how to register a client application in Microsoft Ent
19
19
20
20
1. In the [Azure portal](https://portal.azure.com), select **Microsoft Entra ID**.
21
21
2. Select **App registrations**.
22
-
[](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
+
23
24
3. Select **New registration**.
24
25
4. For Supported account types, select **Accounts in this organization directory only**. Don't change the other options.
25
-
[](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
+
26
28
5. Select **Register**.
27
29
28
30
## Application ID (client ID)
29
31
30
32
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.
31
33
32
-
[](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
+
33
36
34
37
## Authentication setting: confidential vs. public
35
38
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**.
37
40
38
41
If you keep this default value, the application registration is a **confidential client application** and requires a certificate or secret.
39
42
40
-
[](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)
41
44
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).
43
47
44
48
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.
45
49
46
-
[](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.
47
54
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":::
49
56
50
-
[](media/register-application-add-redirect-uri-mobile-desktop-platform.png#lightbox)
51
57
52
58
53
59
@@ -60,10 +66,10 @@ To create a new client secret, use the following steps.
60
66
1. In **Add a client secret**, enter a **Description**.
61
67
1. Accept the recommended 180-day value in the **Expires** field, or select a different value from the list.
62
68
1. Select **Add**.
63
-
[](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":::
64
70
65
71
1. Copy the secret value by selecting the copy button next to the **Value**.
66
-
[](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":::
67
73
68
74
69
75
>[!NOTE]
@@ -78,27 +84,28 @@ The following steps are required for the DICOM service, but optional for the FHI
78
84
79
85
1. Select **API permissions**.
80
86
81
-
[](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":::
82
88
83
89
2. Select **Add a permission**.
84
90
85
91
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.
86
92
87
-
[](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":::
88
94
89
95
The search result for Azure API for DICOM appears only if you already deployed the DICOM service in the workspace.
90
96
91
97
If you're referencing a different resource application, select your DICOM API Resource Application Registration that you created previously under **APIs my organization**.
92
98
93
99
3. Select scopes (permissions) that the confidential client application asks for on behalf of a user. Select **Dicom.ReadWrite**, and then select **Add permissions**.
94
100
95
-
[](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":::
96
102
97
103
>[!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).
99
105
>>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).
100
106
101
-
## Related content
107
+
## Next steps
102
108
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