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
+13-11Lines changed: 13 additions & 11 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,7 +158,7 @@ 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
@@ -168,7 +168,7 @@ Start on your app registration page in the Azure portal.
168
168
169
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).
170
170
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.":::
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":::
172
172
173
173
>[!IMPORTANT]
174
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.
@@ -222,13 +222,13 @@ Use these steps to create the role assignment for your registration.
222
222
| Assign access to | User, group, or service principal |
223
223
| Members | Search for the name or [client ID](#collect-client-id-and-tenant-id) of the app registration |
224
224
225
-

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":::
226
226
227
227
#### Verify role assignment
228
228
229
229
You can view the role assignment you've set up under **Access control (IAM) > Role assignments**.
230
230
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.":::
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":::
232
232
233
233
The app registration should show up in the list along with the role you assigned to it.
234
234
@@ -276,7 +276,7 @@ Select **Add permissions** when finished.
276
276
277
277
On the **API permissions** page, verify that there's now an entry for Azure Digital Twins reflecting **Read.Write** permissions:
278
278
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.":::
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":::
280
280
281
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.
282
282
@@ -286,7 +286,7 @@ To do so, select **Manifest** from the menu to view the app registration's manif
286
286
287
287
These values are shown in the screenshot below:
288
288
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.":::
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":::
290
290
291
291
If these values are missing, retry the steps in the [section for adding the API permission](#provide-api-permissions).
292
292
@@ -307,10 +307,12 @@ It's possible that your organization requires more actions from subscription own
307
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.
308
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:
309
309
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.":::
311
-
- 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)**
312
313
313
-
:::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
+
314
316
* Activate public client access
315
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
+1-1Lines changed: 1 addition & 1 deletion
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*.
Copy file name to clipboardExpand all lines: articles/digital-twins/how-to-integrate-time-series-insights.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -159,7 +159,7 @@ In this section, you'll create an Azure function that will convert twin update e
159
159
160
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**.
161
161
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.":::
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":::
163
163
164
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
+1-1Lines changed: 1 addition & 1 deletion
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.
Copy file name to clipboardExpand all lines: articles/digital-twins/how-to-route-with-managed-identity.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -81,7 +81,7 @@ Start by opening the [Azure portal](https://portal.azure.com) in a browser.
81
81
82
82
1. Select the **Save** button, and **Yes** to confirm.
83
83
84
-
:::image type="content" source="media/how-to-route-with-managed-identity/identity-digital-twins.png" alt-text="Screenshot of the Azure portal showing the Identity page for an Azure Digital Twins instance.":::
84
+
:::image type="content" source="media/how-to-route-with-managed-identity/identity-digital-twins.png" alt-text="Screenshot of the Azure portal showing the Identity page for an Azure Digital Twins instance." lightbox="media/how-to-route-with-managed-identity/identity-digital-twins.png":::
85
85
86
86
After the change is saved, more fields will appear on this page for the new identity's **Object ID** and **Permissions**.
87
87
@@ -148,7 +148,7 @@ To assign a role to the identity, start by opening the [Azure portal](https://po
148
148
| Assign access to | Under **System assigned managed identity**, select **Digital Twins**. |
149
149
| Members | Select the managed identity of your Azure Digital Twins instance that's being assigned the role. The name of the managed identity matches the name of the instance, so choose the name of your Azure Digital Twins instance. |
150
150
151
-

151
+
:::image type="content" source="../../includes/role-based-access-control/media/add-role-assignment-page.png" alt-text="Screenshot of the 'Add role assignment' page for an Azure Digital Twins instance." lightbox="../../includes/role-based-access-control/media/add-role-assignment-page.png":::
0 commit comments