Skip to content

Commit aefe208

Browse files
committed
Additional updates based on feedback.
1 parent 8b5499a commit aefe208

File tree

5 files changed

+20
-6
lines changed

5 files changed

+20
-6
lines changed

articles/healthcare-apis/iot/deploy-iot-connector-in-azure.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,21 @@ In this quickstart, you'll learn how to deploy the MedTech service in the Azure
1616

1717
## Deploy the MedTech service with a quickstart template
1818

19-
If you already have an active Azure account, you can use this [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.healthcareapis%2Fworkspaces%2Fiotconnectors%2Fazuredeploy.json) button to deploy a MedTech service that will include the following resources and permissions:
19+
If you already have an active Azure account, you can use this [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.healthcareapis%2Fworkspaces%2Fiotconnectors%2Fazuredeploy.json) button to deploy a MedTech service that will include the following resources and roles:
2020

2121
* An Azure Event Hubs Namespace and device message Azure event hub (the event hub is named: **devicedata**).
2222
* An Azure event hub consumer group (the consumer group is named: **$Default**).
2323
* An Azure event hub sender role (the sender role is named: **devicedatasender**).
2424
* An Azure Health Data Services workspace.
2525
* An Azure Health Data Services FHIR service.
26-
* An Azure Health Data Services MedTech service including the necessary system-assigned [managed identity](../../active-directory/managed-identities-azure-resources/overview.md) permissions to the device message event hub (**Azure Events Hubs Receiver**) and FHIR service (**FHIR Data Writer**).
26+
* An Azure Health Data Services MedTech service including the necessary system-assigned [managed identity](../../active-directory/managed-identities-azure-resources/overview.md) roles to the device message event hub (**Azure Events Hubs Receiver**) and FHIR service (**FHIR Data Writer**).
27+
28+
> [!TIP]
29+
>
30+
> By using the drop down menus, you can find all the values that can be selected. You can also begin to type the value to begin the search for the resource, however, selecting the resource from the drop down menu will ensure that there are no typos.
31+
>
32+
> :::image type="content" source="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png" alt-text="Screenshot of Azure portal page displaying drop down menu example." lightbox="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png":::
33+
>
2734
2835
1. When the Azure portal launches, the following fields must be filled out:
2936

@@ -69,6 +76,13 @@ It's important that you have the following prerequisites completed before you be
6976
* [Workspace deployed in Azure Health Data Services](../healthcare-apis-quickstart.md)
7077
* [FHIR service deployed in Azure Health Data Services](../fhir/fhir-portal-quickstart.md)
7178

79+
> [!TIP]
80+
>
81+
> By using the drop down menus, you can find all the values that can be selected. You can also begin to type the value to begin the search for the resource, however, selecting the resource from the drop down menu will ensure that there are no typos.
82+
>
83+
> :::image type="content" source="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png" alt-text="Screenshot of Azure portal page displaying drop down menu example." lightbox="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png":::
84+
>
85+
7286
1. Sign into the [Azure portal](https://portal.azure.com), and then enter your Health Data Services workspace resource name in the **Search** bar field located at the middle top of your screen. The name of the workspace you'll be deploying into will be of your own choosing. For this example deployment of the MedTech service, we'll be using a workspace named `azuredocsdemo`.
7387

7488
:::image type="content" source="media\iot-deploy-manual-in-portal\find-workspace-in-portal.png" alt-text="Screenshot of Azure portal and entering the workspace that will be used for the MedTech service deployment." lightbox="media\iot-deploy-manual-in-portal\find-workspace-in-portal.png":::
@@ -240,13 +254,13 @@ Tags are name and value pairs used for categorizing resources. For more informat
240254

241255
:::image type="content" source="media\iot-deploy-manual-in-portal\created-medtech-service.png" alt-text="Screenshot of the MedTech service deployment status and a red box around Go to resource button" lightbox="media\iot-deploy-manual-in-portal\created-medtech-service.png":::
242256

243-
4. Now that your MedTech service has been deployed, we're going to walk through the steps of assigning access permissions. Your MedTech service's system-assigned managed identity will require access to your device message event hub and your FHIR service.
257+
4. Now that your MedTech service has been deployed, we're going to walk through the steps of assigning access roles. Your MedTech service's system-assigned managed identity will require access to your device message event hub and your FHIR service.
244258

245259
:::image type="content" source="media\iot-deploy-manual-in-portal\display-medtech-service-configurations.png" alt-text="Screenshot of the MedTech service main configuration page." lightbox="media\iot-deploy-manual-in-portal\display-medtech-service-configurations.png":::
246260

247261
## Granting the MedTech service access to the device message event hub and FHIR service
248262

249-
To ensure that your MedTech service works properly, it's system-assigned managed identity must be granted access permissions to your device message event hub and FHIR service.
263+
To ensure that your MedTech service works properly, it's system-assigned managed identity must be granted access via role assignments to your device message event hub and FHIR service.
250264

251265
### Granting access to the device message event hub
252266

@@ -285,7 +299,7 @@ To ensure that your MedTech service works properly, it's system-assigned managed
285299

286300
8. Select the **Next** button.
287301

288-
:::image type="content" source="media\iot-deploy-manual-in-portal\select-event-hub-permissions-next-button.png" alt-text="Screenshot of the Azure Events Hubs Data Receiver role with a red box around the Next button." lightbox="media\iot-deploy-manual-in-portal\select-event-hub-permissions-next-button.png":::
302+
:::image type="content" source="media\iot-deploy-manual-in-portal\select-event-hub-roles-next-button.png" alt-text="Screenshot of the Azure Events Hubs Data Receiver role with a red box around the Next button." lightbox="media\iot-deploy-manual-in-portal\select-event-hub-roles-next-button.png":::
289303

290304
9. In the **Add role assignment** page, select **Managed identity** next to **Assign access to** and **+ Select members** next to **Members**.
291305

articles/healthcare-apis/iot/get-started-with-iot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,6 @@ You can verify that the data is correctly persisted into the FHIR service by usi
8888
This article only described the basic steps needed to get started using MedTech service. For information about deploying MedTech service in the workspace, see
8989

9090
>[!div class="nextstepaction"]
91-
>[Deploy MedTech service in the Azure portal](deploy-iot-connector-in-azure.md)
91+
>[Deploy the MedTech service in the Azure portal](deploy-iot-connector-in-azure.md)
9292
9393
FHIR® is a registered trademark of Health Level Seven International, registered in the U.S. Trademark Office and is used with their permission.
527 Bytes
Loading
527 Bytes
Loading

0 commit comments

Comments
 (0)