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/digital-twins/how-to-create-app-registration.md
+14-18Lines changed: 14 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ Start by selecting the tab below for your preferred interface.
35
35
36
36
Navigate to [Azure Active Directory](https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview) in the Azure portal (you can use this link or find it with the portal search bar). Select **App registrations** from the service menu, and then **+ New registration**.
37
37
38
-
:::image type="content" source="media/how-to-create-app-registration/new-registration.png" alt-text="Screenshot of the Azure AD service page in the Azure portal, showing the steps to create a new registration in the 'App registrations' page.":::
38
+
:::image type="content" source="media/how-to-create-app-registration/new-registration.png" alt-text="Screenshot of the Azure AD service page in the Azure portal, showing the steps to create a new registration in the 'App registrations' page." lightbox="media/how-to-create-app-registration/new-registration.png":::
39
39
40
40
In the **Register an application** page that follows, fill in the requested values:
41
41
***Name**: An Azure AD application display name to associate with the registration
@@ -44,7 +44,7 @@ In the **Register an application** page that follows, fill in the requested valu
44
44
45
45
When you're finished, select the **Register** button.
46
46
47
-
:::image type="content" source="media/how-to-create-app-registration/register-an-application.png" alt-text="Screenshot of the 'Register an application' page in the Azure portal with the described values filled in.":::
47
+
:::image type="content" source="media/how-to-create-app-registration/register-an-application.png" alt-text="Screenshot of the 'Register an application' page in the Azure portal with the described values filled in." lightbox="media/how-to-create-app-registration/register-an-application.png":::
48
48
49
49
When the registration is finished setting up, the portal will redirect you to its details page.
50
50
@@ -158,23 +158,17 @@ Start on your app registration page in the Azure portal.
158
158
159
159
1. Select **Certificates & secrets** from the registration's menu, and then select **+ New client secret**.
160
160
161
-
:::image type="content" source="media/how-to-create-app-registration/client-secret.png" alt-text="Screenshot of the Azure portal showing an Azure AD app registration and a highlight around 'New client secret'.":::
161
+
:::image type="content" source="media/how-to-create-app-registration/client-secret.png" alt-text="Screenshot of the Azure portal showing an Azure AD app registration and a highlight around 'New client secret'." lightbox="media/how-to-create-app-registration/client-secret.png":::
162
162
163
163
1. Enter whatever values you want for Description and Expires, and select **Add**.
164
164
165
-
:::row:::
166
-
:::column:::
167
-
:::image type="content" source="media/how-to-create-app-registration/add-client-secret.png" alt-text="Screenshot of the Azure portal while adding a client secret.":::
168
-
:::column-end:::
169
-
:::column:::
170
-
:::column-end:::
171
-
:::row-end:::
165
+
:::image type="content" source="media/how-to-create-app-registration/add-client-secret.png" alt-text="Screenshot of the Azure portal while adding a client secret.":::
172
166
173
167
1. Verify that the client secret is visible on the **Certificates & secrets** page with Expires and Value fields.
174
168
175
169
1. Take note of its **Secret ID** and **Value** to use later (you can also copy them to the clipboard with the Copy icons).
176
170
177
-
:::image type="content" source="media/how-to-create-app-registration/client-secret-value.png" alt-text="Screenshot of the Azure portal showing how to copy the client secret value.":::
171
+
:::image type="content" source="media/how-to-create-app-registration/client-secret-value.png" alt-text="Screenshot of the Azure portal showing how to copy the client secret value." lightbox="media/how-to-create-app-registration/client-secret-value.png":::
178
172
179
173
>[!IMPORTANT]
180
174
>Make sure to copy the values now and store them in a safe place, as they can't be retrieved again. If you can't find them later, you'll have to create a new secret.
@@ -228,13 +222,13 @@ Use these steps to create the role assignment for your registration.
228
222
| Assign access to | User, group, or service principal |
229
223
| Members | Search for the name or [client ID](#collect-client-id-and-tenant-id) of the app registration |
230
224
231
-

225
+
:::image type="content" source="../../includes/role-based-access-control/media/add-role-assignment-page.png" alt-text="Screenshot of the 'Add role assignment' page." lightbox="../../includes/role-based-access-control/media/add-role-assignment-page.png":::
232
226
233
227
#### Verify role assignment
234
228
235
229
You can view the role assignment you've set up under **Access control (IAM) > Role assignments**.
236
230
237
-
:::image type="content" source="media/how-to-create-app-registration/verify-role-assignment.png" alt-text="Screenshot of the Role Assignments page for an Azure Digital Twins instance in the Azure portal.":::
231
+
:::image type="content" source="media/how-to-create-app-registration/verify-role-assignment.png" alt-text="Screenshot of the Role Assignments page for an Azure Digital Twins instance in the Azure portal." lightbox="media/how-to-create-app-registration/verify-role-assignment.png":::
238
232
239
233
The app registration should show up in the list along with the role you assigned to it.
240
234
@@ -282,7 +276,7 @@ Select **Add permissions** when finished.
282
276
283
277
On the **API permissions** page, verify that there's now an entry for Azure Digital Twins reflecting **Read.Write** permissions:
284
278
285
-
:::image type="content" source="media/how-to-create-app-registration/verify-api-permissions.png" alt-text="Screenshot of the API permissions for the Azure AD app registration in the Azure portal, showing 'Read/Write Access' for Azure Digital Twins.":::
279
+
:::image type="content" source="media/how-to-create-app-registration/verify-api-permissions.png" alt-text="Screenshot of the API permissions for the Azure AD app registration in the Azure portal, showing 'Read/Write Access' for Azure Digital Twins." lightbox="media/how-to-create-app-registration/verify-api-permissions.png":::
286
280
287
281
You can also verify the connection to Azure Digital Twins within the app registration's *manifest.json*, which was automatically updated with the Azure Digital Twins information when you added the API permissions.
288
282
@@ -292,7 +286,7 @@ To do so, select **Manifest** from the menu to view the app registration's manif
292
286
293
287
These values are shown in the screenshot below:
294
288
295
-
:::image type="content" source="media/how-to-create-app-registration/verify-manifest.png" alt-text="Screenshot of the manifest for the Azure AD app registration in the Azure portal.":::
289
+
:::image type="content" source="media/how-to-create-app-registration/verify-manifest.png" alt-text="Screenshot of the manifest for the Azure AD app registration in the Azure portal." lightbox="media/how-to-create-app-registration/verify-manifest.png":::
296
290
297
291
If these values are missing, retry the steps in the [section for adding the API permission](#provide-api-permissions).
298
292
@@ -313,10 +307,12 @@ It's possible that your organization requires more actions from subscription own
313
307
Here are some common potential activities that an owner or administrator on the subscription may need to do. These and other operations can be performed from the [Azure AD App registrations](https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps) page in the Azure portal.
314
308
* Grant admin consent for the app registration. Your organization may have **Admin Consent Required** globally turned on in Azure AD for all app registrations within your subscription. If so, the owner/administrator will need to select this button for your company on the app registration's **API permissions** page for the app registration to be valid:
315
309
316
-
:::image type="content" source="media/how-to-create-app-registration/grant-admin-consent.png" alt-text="Screenshot of the Azure portal showing the 'Grant admin consent' button under API permissions.":::
317
-
- If consent was granted successfully, the entry for Azure Digital Twins should then show a **Status** value of **Granted for (your company)**
310
+
:::image type="content" source="media/how-to-create-app-registration/grant-admin-consent.png" alt-text="Screenshot of the Azure portal showing the 'Grant admin consent' button under API permissions." lightbox="media/how-to-create-app-registration/grant-admin-consent.png":::
311
+
312
+
- If consent was granted successfully, the entry for Azure Digital Twins should then show a **Status** value of **Granted for (your company)**
318
313
319
-
:::image type="content" source="media/how-to-create-app-registration/granted-admin-consent-done.png" alt-text="Screenshot of the Azure portal showing the admin consent granted for the company under API permissions.":::
314
+
:::image type="content" source="media/how-to-create-app-registration/granted-admin-consent-done.png" alt-text="Screenshot of the Azure portal showing the admin consent granted for the company under API permissions." lightbox="media/how-to-create-app-registration/granted-admin-consent-done.png":::
315
+
320
316
* Activate public client access
321
317
* Set specific reply URLs for web and desktop access
Copy file name to clipboardExpand all lines: articles/digital-twins/how-to-enable-private-link.md
+2-8Lines changed: 2 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ The Private Link options are located in the **Networking** tab of instance setup
58
58
59
59
1. In the **Create private endpoint** page that opens, enter the details of a new private endpoint.
60
60
61
-
:::image type="content" source="media/how-to-enable-private-link/create-private-endpoint-full.png" alt-text="Screenshot of the Azure portal showing the Create private endpoint page. It contains the fields described below.":::
61
+
:::image type="content" source="media/how-to-enable-private-link/create-private-endpoint-full.png" alt-text="Screenshot of the Azure portal showing the Create private endpoint page. It contains the fields described below." lightbox="media/how-to-enable-private-link/create-private-endpoint-full.png":::
62
62
63
63
1. Fill in selections for your **Subscription** and **Resource group**. Set the **Location** to the same location as the VNet you'll be using. Choose a **Name** for the endpoint, and for **Target sub-resources** select *API*.
64
64
@@ -195,13 +195,7 @@ To disable or enable public network access in the [Azure portal](https://portal.
195
195
196
196
1. In the **Public access** tab, set **Allow public network access to** either **Disabled** or **All networks**.
197
197
198
-
:::row:::
199
-
:::column:::
200
-
:::image type="content" source="media/how-to-enable-private-link/network-flag-portal.png" alt-text="Screenshot of the Azure portal showing the Networking page for an Azure Digital Twins instance, highlighting how to toggle public access." lightbox="media/how-to-enable-private-link/network-flag-portal.png":::
201
-
:::column-end:::
202
-
:::column:::
203
-
:::column-end:::
204
-
:::row-end:::
198
+
:::image type="content" source="media/how-to-enable-private-link/network-flag-portal.png" alt-text="Screenshot of the Azure portal showing the Networking page for an Azure Digital Twins instance, highlighting how to toggle public access." lightbox="media/how-to-enable-private-link/network-flag-portal.png":::
Copy file name to clipboardExpand all lines: articles/digital-twins/how-to-integrate-time-series-insights.md
+2-8Lines changed: 2 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,13 +40,7 @@ Before you can set up a relationship with Time Series Insights, you'll need to s
40
40
41
41
You'll be attaching Time Series Insights to Azure Digital Twins through the following path.
42
42
43
-
:::row:::
44
-
:::column:::
45
-
:::image type="content" source="media/how-to-integrate-time-series-insights/diagram-simple.png" alt-text="Diagram of Azure services in an end-to-end scenario, highlighting Time Series Insights." lightbox="media/how-to-integrate-time-series-insights/diagram-simple.png":::
46
-
:::column-end:::
47
-
:::column:::
48
-
:::column-end:::
49
-
:::row-end:::
43
+
:::image type="content" source="media/how-to-integrate-time-series-insights/diagram-simple.png" alt-text="Diagram of Azure services in an end-to-end scenario, highlighting Time Series Insights." lightbox="media/how-to-integrate-time-series-insights/diagram-simple.png":::
50
44
51
45
## Create Event Hubs namespace
52
46
@@ -165,7 +159,7 @@ In this section, you'll create an Azure function that will convert twin update e
165
159
166
160
2. Create a new Azure function called *ProcessDTUpdatetoTSI.cs* to update device telemetry events to the Time Series Insights. The function type will be **Event Hub trigger**.
167
161
168
-
:::image type="content" source="media/how-to-integrate-time-series-insights/create-event-hub-trigger-function.png" alt-text="Screenshot of Visual Studio to create a new Azure function of type event hub trigger.":::
162
+
:::image type="content" source="media/how-to-integrate-time-series-insights/create-event-hub-trigger-function.png" alt-text="Screenshot of Visual Studio to create a new Azure function of type event hub trigger." lightbox="media/how-to-integrate-time-series-insights/create-event-hub-trigger-function.png":::
169
163
170
164
3. Add the following packages to your project (you can use the Visual Studio NuGet package manager, or the [dotnet add package](/dotnet/core/tools/dotnet-add-package) command in a command-line tool).
Copy file name to clipboardExpand all lines: articles/digital-twins/how-to-manage-routes.md
+7-36Lines changed: 7 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ You can find these details in the [Azure portal](https://portal.azure.com) after
34
34
35
35
Select your instance from the results to see these details in the Overview for your instance:
36
36
37
-
:::image type="content" source="media/how-to-manage-routes/instance-details.png" alt-text="Screenshot of the Overview page for an Azure Digital Twins instance in the Azure portal. The name and resource group are highlighted.":::
37
+
:::image type="content" source="media/how-to-manage-routes/instance-details.png" alt-text="Screenshot of the Overview page for an Azure Digital Twins instance in the Azure portal. The name and resource group are highlighted." lightbox="media/how-to-manage-routes/instance-details.png":::
38
38
39
39
Follow the instructions below if you intend to use the Azure CLI while following this guide.
40
40
@@ -83,13 +83,7 @@ To create a new endpoint, go to your instance's page in the [Azure portal](https
83
83
1. Complete the other details that are required for your endpoint type, including your subscription and the endpoint resources described [above](#prerequisite-create-endpoint-resources).
84
84
1. For Event Hubs and Service Bus endpoints only, you must select an **Authentication type**. You can use key-based authentication with a pre-created authorization rule, or identity-based authentication if you'll be using the endpoint with a [managed identity](concepts-security.md#managed-identity-for-accessing-other-resources) for your Azure Digital Twins instance.
85
85
86
-
:::row:::
87
-
:::column:::
88
-
:::image type="content" source="media/how-to-manage-routes/create-endpoint-event-hub-authentication.png" alt-text="Screenshot of creating an endpoint of type Event Hubs in the Azure portal." lightbox="media/how-to-manage-routes/create-endpoint-event-hub-authentication.png":::
89
-
:::column-end:::
90
-
:::column:::
91
-
:::column-end:::
92
-
:::row-end:::
86
+
:::image type="content" source="media/how-to-manage-routes/create-endpoint-event-hub-authentication.png" alt-text="Screenshot of creating an endpoint of type Event Hubs in the Azure portal." lightbox="media/how-to-manage-routes/create-endpoint-event-hub-authentication.png":::
93
87
94
88
1. Finish creating your endpoint by selecting **Save**.
95
89
@@ -98,13 +92,8 @@ To create a new endpoint, go to your instance's page in the [Azure portal](https
98
92
99
93
After creating your endpoint, you can verify that the endpoint was successfully created by checking the notification icon in the top Azure portal bar:
100
94
101
-
:::row:::
102
-
:::column:::
103
-
:::image type="content" source="media/how-to-manage-routes/create-endpoint-notifications.png" alt-text="Screenshot of the notification to verify the creation of an endpoint in the Azure portal.":::
104
-
:::column-end:::
105
-
:::column:::
106
-
:::column-end:::
107
-
:::row-end:::
95
+
:::image type="content" source="media/how-to-manage-routes/create-endpoint-notifications.png" alt-text="Screenshot of the notification to verify the creation of an endpoint in the Azure portal.":::
96
+
108
97
109
98
If the endpoint creation fails, observe the error message and retry after a few minutes.
110
99
@@ -356,37 +345,19 @@ You can either select from some basic common filter options, or use the advanced
356
345
357
346
To use the basic filters, expand the **Event types** option and select the checkboxes corresponding to the events you want to send to your endpoint.
358
347
359
-
:::row:::
360
-
:::column:::
361
-
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-basic-1.png" alt-text="Screenshot of creating an event route with a basic filter in the Azure portal, highlighting the checkboxes of the events.":::
362
-
:::column-end:::
363
-
:::column:::
364
-
:::column-end:::
365
-
:::row-end:::
348
+
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-basic-1.png" alt-text="Screenshot of creating an event route with a basic filter in the Azure portal, highlighting the checkboxes of the events.":::
366
349
367
350
Doing so will autopopulate the filter text box with the text of the filter you've selected:
368
351
369
-
:::row:::
370
-
:::column:::
371
-
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-basic-2.png" alt-text="Screenshot of creating an event route with a basic filter in the Azure portal, highlighting the autopopulated filter text after selecting the events.":::
372
-
:::column-end:::
373
-
:::column:::
374
-
:::column-end:::
375
-
:::row-end:::
352
+
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-basic-2.png" alt-text="Screenshot of creating an event route with a basic filter in the Azure portal, highlighting the autopopulated filter text after selecting the events.":::
376
353
377
354
### Use the advanced filters
378
355
379
356
You can also use the advanced filter option to write your own custom filters.
380
357
381
358
To create an event route with advanced filter options, toggle the switch for the **Advanced editor** to enable it. You can then write your own event filters in the **Filter** box:
382
359
383
-
:::row:::
384
-
:::column:::
385
-
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-advanced.png" alt-text="Screenshot of creating an event route with an advanced filter in the Azure portal.":::
386
-
:::column-end:::
387
-
:::column:::
388
-
:::column-end:::
389
-
:::row-end:::
360
+
:::image type="content" source="media/how-to-manage-routes/create-event-route-filter-advanced.png" alt-text="Screenshot of creating an event route with an advanced filter in the Azure portal.":::
0 commit comments