Configure Azure RBAC roles for Azure Health Data Services

In this article, you learn how to use Azure role-based access control (RBAC) to assign access to the Azure Health Data Services data plane. Using Azure RBAC roles is the preferred method for assigning data plane access when data plane users are managed in the Microsoft Entra tenant associated with your Azure subscription.

You can complete role assignments in the Azure portal. The FHIR® service and DICOM® service define application roles differently. Add or remove one or more roles to manage user access controls.

Assign roles for the FHIR service

To grant users, service principals, or groups access to the FHIR data plane, go to the FHIR service in the Azure portal. Select Access control (IAM), and then select the Role assignments tab. Select +Add, and then select Add role assignment.

If the role assignment option is grayed out, ask your Azure subscription administrator to grant you with the permissions to the subscription or the resource group, for example, User Access Administrator. For more information, see Azure built-in roles.

Screenshot showing role assignment selection.

In the Role selection, search for one of the built-in roles for the FHIR data plane. You can choose from these roles:

  • FHIR Data Reader: Can read (and search) FHIR data.
  • FHIR Data Writer: Can read, write, and soft delete FHIR data.
  • FHIR Data Exporter: Can read and export ($export operator) data.
  • FHIR Data Contributor: Can perform all data plane operations.
  • FHIR Data Converter: Can use the converter to perform data conversion.
  • FHIR SMART User: Can read and write FHIR data according to the SMART IG V1.0.0 specifications.

In the Select section, type the client application registration name. If the name is found, the application name is listed. Select the application name, and then select Save.

If the client application isn’t found, check your application registration. This is to ensure that the name is correct. Ensure that the client application is created in the same tenant where the FHIR service in Azure Health Data Services (hereby called the FHIR service) is deployed in.

Screenshot showing selection of role assignment.

You can verify the role assignment by selecting the Role assignments tab from the Access control (IAM) menu option.

Assign roles for the DICOM service

To grant users, service principals, or groups access to the DICOM data plane, select the Access control (IAM) blade. Select theRole assignments tab, and select + Add.

Screenshot showing DICOM access control.

In the Role selection, search for one of the built-in roles for the DICOM data plane:

Screenshot showing how to add an RBAC role assignment.

You can choose between:

  • DICOM Data Owner: Full access to DICOM data.
  • DICOM Data Reader: Read and search DICOM data.

If these roles aren’t sufficient, you can use PowerShell to create custom roles. For information about creating custom roles, see Create a custom role by using Azure PowerShell.

In the Select box, search for a user, service principal, or group that you want to assign the role to.

Note

If you can't access the FHIR or DICOM service in your application or other tools, you might need to wait a few more minutes for the role assignment to finish propagating in the system.

Next steps

Access by using Postman

Access by using the REST Client

Access by using cURL

Note

FHIR® is a registered trademark of HL7 and is used with the permission of HL7.

DICOM® is the registered trademark of the National Electrical Manufacturers Association for its Standards publications relating to digital communications of medical information.