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
In this article, you'll learn how to use [Azure role-based access control (Azure RBAC)](../../role-based-access-control/index.yml) to assign access to the Azure API for FHIR data plane. Azure RBAC is the preferred methods for assigning data plane access when data plane users are managed in the Microsoft Entra tenant associated with your Azure subscription. If you're using an external Microsoft Entra tenant, refer to the [local RBAC assignment reference](configure-local-rbac.md).
16
+
In this article, you learn how to use [Azure role-based access control (Azure RBAC)](../../role-based-access-control/index.yml) to assign access to the Azure API for FHIR® data plane. Azure RBAC is the preferred methods for assigning data plane access when data plane users are managed in the Microsoft Entra tenant associated with your Azure subscription. If you're using an external Microsoft Entra tenant, refer to the [local RBAC assignment reference](configure-local-rbac.md).
17
17
18
18
## Confirm Azure RBAC mode
19
19
20
-
To use Azure RBAC, your Azure API for FHIR must be configured to use your Azure subscription tenant for data plane and there should be no assigned identity object IDs. You can verify your settings by inspecting the **Authentication** blade of your Azure API for FHIR:
20
+
To use Azure RBAC, your Azure API for FHIR must be configured to use your Azure subscription tenant for data plane, and there should be no assigned identity object IDs. You can verify your settings by inspecting the **Authentication** of your Azure API for FHIR:
The **Authority** should be set to the Microsoft Entra tenant associated with your subscription and there should be no GUIDs in the box labeled **Allowed object IDs**. You'll also notice that the box is disabled and a label indicates that Azure RBAC should be used to assign data plane roles.
24
+
The **Authority** should be set to the Microsoft Entra tenant associated with your subscription and there should be no GUIDs in the box labeled **Allowed object IDs**. Notice the box is disabled and a label indicates that Azure RBAC should be used to assign data plane roles.
25
25
26
26
## Assign roles
27
27
28
-
To grant users, service principals or groups access to the FHIR data plane, select **Access control (IAM)**, then select **Role assignments** and select **+ Add**:
28
+
To grant users, service principals, or groups access to the FHIR data plane, select **Access control (IAM)**, then select **Role assignments** and select **+ Add**.
29
29
30
30
:::image type="content" source="media/rbac/add-azure-rbac-role-assignment.png" alt-text="Add Azure role assignment":::
31
31
32
-
In the **Role** selection, search for one of the built-in roles for the FHIR data plane:
32
+
In the **Role** selection, search for one of the built-in roles for the FHIR data plane.
33
33
34
34
:::image type="content" source="media/rbac/built-in-fhir-data-roles.png" alt-text="Built-in FHIR data roles":::
35
35
36
-
You can choose between:
36
+
You can choose from among the following.
37
37
38
-
* FHIR Data Reader: Can read (and search) FHIR data.
39
-
* FHIR Data Writer: Can read, write, and soft delete FHIR data.
40
-
* FHIR Data Exporter: Can read and export (`$export` operator) data.
41
-
* FHIR Data Contributor: Can perform all data plane operations.
38
+
* FHIR Data Reader: Can read (and search) FHIR data
39
+
* FHIR Data Writer: Can read, write, and soft delete FHIR data
40
+
* FHIR Data Exporter: Can read and export (`$export` operator) data
41
+
* FHIR Data Contributor: Can perform all data plane operations
42
42
43
43
In the **Select** box, search for a user, service principal, or group that you wish to assign the role to.
44
44
@@ -48,7 +48,7 @@ In the **Select** box, search for a user, service principal, or group that you w
48
48
49
49
## Caching behavior
50
50
51
-
The Azure API for FHIR will cache decisions for up to 5 minutes. If you grant a user access to the FHIR server by adding them to the list of allowed object IDs, or you remove them from the list, you should expect it to take up to five minutes for changes in permissions to propagate.
51
+
The Azure API for FHIR caches decisions for up to 5 minutes. If you grant a user access to the FHIR server by adding them to the list of allowed object IDs, or you remove them from the list, you should expect it to take up to five minutes for changes in permissions to propagate.
52
52
53
53
## Next steps
54
54
@@ -72,4 +72,4 @@ In this article, you learned how to assign Azure roles for the FHIR data plane.
Azure API for FHIR supports [cross-origin resource sharing (CORS)](https://wikipedia.org/wiki/Cross-Origin_Resource_Sharing). CORS allows you to configure settings so that applications from one domain (origin) can access resources from a different domain, known as a cross-domain request.
15
+
Azure API for FHIR® supports [cross-origin resource sharing (CORS)](https://wikipedia.org/wiki/Cross-Origin_Resource_Sharing). CORS allows you to configure settings so that applications from one domain (origin) can access resources from a different domain, known as a cross-domain request.
16
16
17
17
CORS is often used in a single-page app that must call a RESTful API to a different domain.
18
18
19
19
## Configure CORS settings
20
20
21
-
To configure a CORS setting in the Azure API for FHIR, specify the following settings:
21
+
To configure a CORS setting in the Azure API for FHIR, specify the following settings.
22
22
23
23
-**Origins (Access-Control-Allow-Origin)**. A list of domains allowed to make cross-origin requests to the Azure API for FHIR. Each domain (origin) must be entered in a separate line. You can enter an asterisk (*) to allow calls from any domain, but we don't recommend it because it's a security risk.
24
24
@@ -42,4 +42,4 @@ In this article, you learned how to configure cross-origin resource sharing in A
42
42
>[!div class="nextstepaction"]
43
43
>[Deploy Azure API for FHIR](fhir-paas-portal-quickstart.md)
44
44
45
-
FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.
0 commit comments