Skip to content

Commit 80c93fa

Browse files
authored
Merge pull request #218667 from w-azure/winona-adt-html-columns
Removed HTML image code
2 parents ca34101 + b4c67ca commit 80c93fa

29 files changed

+44
-173
lines changed

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

Lines changed: 14 additions & 18 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,23 +158,17 @@ 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

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.":::
172166

173167
1. Verify that the client secret is visible on the **Certificates & secrets** page with Expires and Value fields.
174168

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

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

179173
>[!IMPORTANT]
180174
>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.
228222
| Assign access to | User, group, or service principal |
229223
| Members | Search for the name or [client ID](#collect-client-id-and-tenant-id) of the app registration |
230224

231-
![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":::
232226

233227
#### Verify role assignment
234228

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

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

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

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

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

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

287281
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.
288282

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

293287
These values are shown in the screenshot below:
294288

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

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

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

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

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

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

Lines changed: 2 additions & 8 deletions
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

@@ -195,13 +195,7 @@ To disable or enable public network access in the [Azure portal](https://portal.
195195

196196
1. In the **Public access** tab, set **Allow public network access to** either **Disabled** or **All networks**.
197197

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

206200
Select **Save**.
207201

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

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -40,13 +40,7 @@ Before you can set up a relationship with Time Series Insights, you'll need to s
4040

4141
You'll be attaching Time Series Insights to Azure Digital Twins through the following path.
4242

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

5145
## Create Event Hubs namespace
5246

@@ -165,7 +159,7 @@ In this section, you'll create an Azure function that will convert twin update e
165159

166160
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**.
167161

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

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

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

Lines changed: 7 additions & 36 deletions
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

@@ -83,13 +83,7 @@ To create a new endpoint, go to your instance's page in the [Azure portal](https
8383
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).
8484
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.
8585

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

9488
1. Finish creating your endpoint by selecting **Save**.
9589

@@ -98,13 +92,8 @@ To create a new endpoint, go to your instance's page in the [Azure portal](https
9892
9993
After creating your endpoint, you can verify that the endpoint was successfully created by checking the notification icon in the top Azure portal bar:
10094

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+
10897

10998
If the endpoint creation fails, observe the error message and retry after a few minutes.
11099

@@ -356,37 +345,19 @@ You can either select from some basic common filter options, or use the advanced
356345

357346
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.
358347

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.":::
366349

367350
Doing so will autopopulate the filter text box with the text of the filter you've selected:
368351

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.":::
376353

377354
### Use the advanced filters
378355

379356
You can also use the advanced filter option to write your own custom filters.
380357

381358
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:
382359

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.":::
390361

391362
# [API](#tab/api)
392363

0 commit comments

Comments
 (0)