Skip to content

Commit 7596c19

Browse files
committed
Resized a few images or added lightbox
1 parent ad4c3b1 commit 7596c19

27 files changed

+30
-28
lines changed

articles/digital-twins/how-to-create-app-registration.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Start by selecting the tab below for your preferred interface.
3535

3636
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**.
3737

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":::
3939

4040
In the **Register an application** page that follows, fill in the requested values:
4141
* **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
4444

4545
When you're finished, select the **Register** button.
4646

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":::
4848

4949
When the registration is finished setting up, the portal will redirect you to its details page.
5050

@@ -158,7 +158,7 @@ Start on your app registration page in the Azure portal.
158158

159159
1. Select **Certificates & secrets** from the registration's menu, and then select **+ New client secret**.
160160

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":::
162162

163163
1. Enter whatever values you want for Description and Expires, and select **Add**.
164164

@@ -168,7 +168,7 @@ Start on your app registration page in the Azure portal.
168168

169169
1. Take note of its **Secret ID** and **Value** to use later (you can also copy them to the clipboard with the Copy icons).
170170

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":::
172172

173173
>[!IMPORTANT]
174174
>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.
222222
| Assign access to | User, group, or service principal |
223223
| Members | Search for the name or [client ID](#collect-client-id-and-tenant-id) of the app registration |
224224

225-
![Add role assignment page](../../includes/role-based-access-control/media/add-role-assignment-page.png)
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":::
226226

227227
#### Verify role assignment
228228

229229
You can view the role assignment you've set up under **Access control (IAM) > Role assignments**.
230230

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":::
232232

233233
The app registration should show up in the list along with the role you assigned to it.
234234

@@ -276,7 +276,7 @@ Select **Add permissions** when finished.
276276

277277
On the **API permissions** page, verify that there's now an entry for Azure Digital Twins reflecting **Read.Write** permissions:
278278

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":::
280280

281281
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.
282282

@@ -286,7 +286,7 @@ To do so, select **Manifest** from the menu to view the app registration's manif
286286

287287
These values are shown in the screenshot below:
288288

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":::
290290

291291
If these values are missing, retry the steps in the [section for adding the API permission](#provide-api-permissions).
292292

@@ -307,10 +307,12 @@ It's possible that your organization requires more actions from subscription own
307307
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.
308308
* 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:
309309

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)**
312313

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+
314316
* Activate public client access
315317
* Set specific reply URLs for web and desktop access
316318
* Allow for implicit OAuth2 authentication flows

articles/digital-twins/how-to-enable-private-link.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ The Private Link options are located in the **Networking** tab of instance setup
5858

5959
1. In the **Create private endpoint** page that opens, enter the details of a new private endpoint.
6060

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":::
6262

6363
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*.
6464

articles/digital-twins/how-to-integrate-time-series-insights.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,7 @@ In this section, you'll create an Azure function that will convert twin update e
159159

160160
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**.
161161

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":::
163163

164164
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).
165165
* [Microsoft.Azure.WebJobs](https://www.nuget.org/packages/Microsoft.Azure.WebJobs/)

articles/digital-twins/how-to-manage-routes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ You can find these details in the [Azure portal](https://portal.azure.com) after
3434

3535
Select your instance from the results to see these details in the Overview for your instance:
3636

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":::
3838

3939
Follow the instructions below if you intend to use the Azure CLI while following this guide.
4040

articles/digital-twins/how-to-route-with-managed-identity.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ Start by opening the [Azure portal](https://portal.azure.com) in a browser.
8181

8282
1. Select the **Save** button, and **Yes** to confirm.
8383

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":::
8585

8686
After the change is saved, more fields will appear on this page for the new identity's **Object ID** and **Permissions**.
8787

@@ -148,7 +148,7 @@ To assign a role to the identity, start by opening the [Azure portal](https://po
148148
| Assign access to | Under **System assigned managed identity**, select **Digital Twins**. |
149149
| 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. |
150150

151-
![Add role assignment page](../../includes/role-based-access-control/media/add-role-assignment-page.png)
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":::
152152

153153
# [CLI](#tab/cli)
154154

0 commit comments

Comments
 (0)