Skip to content

Commit 2e6ed92

Browse files
committed
Clarify troubleshooting articles for ADT
1 parent 81cb08d commit 2e6ed92

File tree

9 files changed

+27
-17
lines changed

9 files changed

+27
-17
lines changed

articles/digital-twins/.openpublishing.redirection.digital-twins.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,16 @@
207207
"redirect_url": "/azure/digital-twins/how-to-manage-routes",
208208
"redirect_document_id": false
209209
},
210+
{
211+
"source_path": "troubleshoot-error-403.md",
212+
"redirect_url": "/azure/digital-twins/troubleshoot-error-403-digital-twins",
213+
"redirect_document_id": true
214+
},
215+
{
216+
"source_path": "troubleshoot-error-404.md",
217+
"redirect_url": "/azure/digital-twins/troubleshoot-error-404-digital-twins",
218+
"redirect_document_id": true
219+
},
210220
{
211221
"source_path": "how-to-multitenant-applications.md",
212222
"redirect_url": "/previous-versions/azure/digital-twins/how-to-multitenant-applications",

articles/digital-twins/TOC.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -149,12 +149,12 @@
149149
href: troubleshoot-performance.md
150150
- name: Known issues
151151
href: troubleshoot-known-issues.md
152-
- name: Problem resolution
152+
- name: Problem resolution in Azure Digital Twins
153153
items:
154154
- name: Error 403 (Forbidden)
155-
href: troubleshoot-error-403.md
155+
href: troubleshoot-error-403-digital-twins.md
156156
- name: Error 404 (Sub-Domain not found)
157-
href: troubleshoot-error-404.md
157+
href: troubleshoot-error-404-digital-twins.md
158158
- name: Azure Digital Twins Explorer authentication error
159159
href: troubleshoot-error-azure-digital-twins-explorer-authentication.md
160160
- name: CLI parsing failures

articles/digital-twins/concepts-security.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ The following list describes the levels at which you can scope access to Azure D
8585

8686
### Troubleshoot permissions
8787

88-
If a user attempts to perform an action not allowed by their role, they may receive an error from the service request reading `403 (Forbidden)`. For more information and troubleshooting steps, see [Troubleshoot failed service request: Error 403 (Forbidden)](troubleshoot-error-403.md).
88+
If a user attempts to perform an action not allowed by their role, they may receive an error from the service request reading `403 (Forbidden)`. For more information and troubleshooting steps, see [Troubleshoot Azure Digital Twins failed service request: Error 403 (Forbidden)](troubleshoot-error-403-digital-twins.md).
8989

9090
## Managed identity for accessing other resources
9191

articles/digital-twins/troubleshoot-error-403.md renamed to articles/digital-twins/troubleshoot-error-403-digital-twins.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
2-
title: "Troubleshoot failed service request: Error 403 (Forbidden)"
2+
title: "Troubleshoot Azure Digital Twins: Error 403 (Forbidden)"
33
titleSuffix: Azure Digital Twins
4-
description: Learn how to diagnose and resolve error 403 (Forbidden) status responses from Azure Digital Twins.
4+
description: Learn how to diagnose and resolve error 403 (Forbidden) failed service requests from Azure Digital Twins.
55
ms.service: digital-twins
66
author: baanders
77
ms.author: baanders
88
ms.topic: troubleshooting
9-
ms.date: 02/24/2022
9+
ms.date: 09/06/2022
1010
---
1111

12-
# Troubleshoot failed service request: Error 403 (Forbidden)
12+
# Troubleshoot Azure Digital Twins failed service request: Error 403 (Forbidden)
1313

14-
This article describes causes and resolution steps for receiving a 403 error from service requests to Azure Digital Twins.
14+
This article describes causes and resolution steps for receiving a 403 error from service requests to Azure Digital Twins. This information is specific to the Azure Digital Twins service.
1515

1616
## Symptoms
1717

@@ -70,15 +70,15 @@ Switch to the **All applications** tab to see all the app registrations that hav
7070

7171
You should see the app registration you created in the list. Select it to open up its details.
7272

73-
:::image type="content" source="media/troubleshoot-error-403/app-registrations.png" alt-text="Screenshot of the app registrations page in the Azure portal.":::
73+
:::image type="content" source="media/troubleshoot-error-403-digital-twins/app-registrations.png" alt-text="Screenshot of the app registrations page in the Azure portal.":::
7474

7575
First, verify that the Azure Digital Twins permissions settings were properly set on the registration: Select **Manifest** from the menu bar to view the app registration's manifest code. Scroll to the bottom of the code window and look for these fields under `requiredResourceAccess`. The values should match the ones in the screenshot below:
7676

77-
:::image type="content" source="media/troubleshoot-error-403/verify-manifest.png" alt-text="Screenshot of the manifest for the Azure AD app registration in the Azure portal.":::
77+
:::image type="content" source="media/troubleshoot-error-403-digital-twins/verify-manifest.png" alt-text="Screenshot of the manifest for the Azure AD app registration in the Azure portal.":::
7878

7979
Next, select **API permissions** from the menu bar to verify that this app registration contains Read/Write permissions for Azure Digital Twins. You should see an entry like this:
8080

81-
:::image type="content" source="media/troubleshoot-error-403/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.":::
81+
:::image type="content" source="media/troubleshoot-error-403-digital-twins/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.":::
8282

8383
#### Fix issues
8484

articles/digital-twins/troubleshoot-error-404.md renamed to articles/digital-twins/troubleshoot-error-404-digital-twins.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
2-
title: "Troubleshoot failed service request: Error 404 (Sub-Domain not found)"
2+
title: "Troubleshoot Azure Digital Twins: Error 404 (Sub-Domain not found)"
33
titleSuffix: Azure Digital Twins
4-
description: Learn how to diagnose and resolve error 404 (Sub-Domain not found) status responses from Azure Digital Twins.
4+
description: Learn how to diagnose and resolve error 404 (Sub-Domain not found) failed service requests from Azure Digital Twins.
55
ms.service: digital-twins
66
author: baanders
77
ms.author: baanders
88
ms.topic: troubleshooting
9-
ms.date: 02/22/2022
9+
ms.date: 09/06/2022
1010
---
1111

12-
# Troubleshoot failed service request: Error 404 (Sub-Domain not found)
12+
# Troubleshoot Azure Digital Twins failed service request: Error 404 (Sub-Domain not found)
1313

14-
This article describes causes and resolution steps for receiving a 404 error from service requests to Azure Digital Twins.
14+
This article describes causes and resolution steps for receiving a 404 error from service requests to Azure Digital Twins. This information is specific to the Azure Digital Twins service.
1515

1616
## Symptoms
1717

0 commit comments

Comments
 (0)