Skip to content

Commit 215f081

Browse files
authored
Merge pull request #107772 from yoelhor/patch-2
Update validation-technical-profile.md
2 parents a4e6f59 + bfbac6b commit 215f081

File tree

2 files changed

+17
-18
lines changed

2 files changed

+17
-18
lines changed

articles/active-directory-b2c/restful-technical-profile.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: celestedg
99
ms.service: active-directory
1010
ms.workload: identity
1111
ms.topic: reference
12-
ms.date: 03/03/2020
12+
ms.date: 03/16/2020
1313
ms.author: mimart
1414
ms.subservice: B2C
1515
---
@@ -215,19 +215,7 @@ If the type of authentication is set to `Bearer`, the **CryptographicKeys** elem
215215

216216
## Returning error message
217217

218-
Your REST API may need to return an error message, such as 'The user was not found in the CRM system'. If an error occurs, the REST API should return an HTTP 409 error message (Conflict response status code) with following attributes:
219-
220-
| Attribute | Required | Description |
221-
| --------- | -------- | ----------- |
222-
| version | Yes | 1.0.0 |
223-
| status | Yes | 409 |
224-
| code | No | An error code from the RESTful endpoint provider, which is displayed when `DebugMode` is enabled. |
225-
| requestId | No | A request identifier from the RESTful endpoint provider, which is displayed when `DebugMode` is enabled. |
226-
| userMessage | Yes | An error message that is shown to the user. |
227-
| developerMessage | No | The verbose description of the problem and how to fix it, which is displayed when `DebugMode` is enabled. |
228-
| moreInfo | No | A URI that points to additional information, which is displayed when `DebugMode` is enabled. |
229-
230-
The following example shows a REST API that returns an error message formatted in JSON:
218+
Your REST API may need to return an error message, such as 'The user was not found in the CRM system'. If an error occurs, the REST API should return an HTTP 4xx error message, such as, 400 (bad request), or 409 (conflict) response status code. The response body contains error message formatted in JSON:
231219

232220
```JSON
233221
{
@@ -241,6 +229,17 @@ The following example shows a REST API that returns an error message formatted i
241229
}
242230
```
243231

232+
| Attribute | Required | Description |
233+
| --------- | -------- | ----------- |
234+
| version | Yes | Your REST API version. For example: 1.0.1 |
235+
| status | Yes | Must be 409 |
236+
| code | No | An error code from the RESTful endpoint provider, which is displayed when `DebugMode` is enabled. |
237+
| requestId | No | A request identifier from the RESTful endpoint provider, which is displayed when `DebugMode` is enabled. |
238+
| userMessage | Yes | An error message that is shown to the user. |
239+
| developerMessage | No | The verbose description of the problem and how to fix it, which is displayed when `DebugMode` is enabled. |
240+
| moreInfo | No | A URI that points to additional information, which is displayed when `DebugMode` is enabled. |
241+
242+
244243
The following example shows a C# class that returns an error message:
245244

246245
```csharp

articles/active-directory-b2c/validation-technical-profile.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: celestedg
99
ms.service: active-directory
1010
ms.workload: identity
1111
ms.topic: reference
12-
ms.date: 09/10/2018
12+
ms.date: 03/16/2020
1313
ms.author: mimart
1414
ms.subservice: B2C
1515
---
@@ -18,7 +18,7 @@ ms.subservice: B2C
1818

1919
[!INCLUDE [active-directory-b2c-advanced-audience-warning](../../includes/active-directory-b2c-advanced-audience-warning.md)]
2020

21-
A validation technical profile is an ordinary technical profile from any protocol, such as [Azure Active Directory](active-directory-technical-profile.md) or a [REST API](restful-technical-profile.md). The validation technical profile returns output claims or returns an HTTP 409 error message (Conflict response status code), with the following data:
21+
A validation technical profile is an ordinary technical profile from any protocol, such as [Azure Active Directory](active-directory-technical-profile.md) or a [REST API](restful-technical-profile.md). The validation technical profile returns output claims, or returns 4xx HTTP status code, with the following data. For more information, see [returning error message](restful-technical-profile.md#returning-error-message)
2222

2323
```JSON
2424
{
@@ -28,11 +28,11 @@ A validation technical profile is an ordinary technical profile from any protoco
2828
}
2929
```
3030

31-
Claims that are returned from a validation technical profile are added back to the claims bag. You can use those claims in the next validation technical profiles.
31+
The scope of the output claims of a validation technical profile is limited to the [self-asserted technical profile](self-asserted-technical-profile.md) that invokes the validation technical profile, and its validation technical profiles. If you want to use the output claims in the next orchestration step, add the output claims to the self-asserted technical profile that invokes the validation technical profile.
3232

3333
Validation technical profiles are executed in the sequence that they appear in the **ValidationTechnicalProfiles** element. You can configure in a validation technical profile whether the execution of any subsequent validation technical profiles should continue if the validation technical profile raises an error or is successful.
3434

35-
A validation technical profile can be conditionally executed based on preconditions defined in the **ValidationTechnicalProfile** element. For example, you can check whether a specific claims exists, or if a claim is equal or not to the specified value.
35+
A validation technical profile can be conditionally executed based on preconditions defined in the **ValidationTechnicalProfile** element. For example, you can check whether a specific claim exists, or if a claim is equal or not to the specified value.
3636

3737
A self-asserted technical profile may define a validation technical profile to be used for validating some or all of its output claims. All of the input claims of the referenced technical profile must appear in the output claims of the referencing validation technical profile.
3838

0 commit comments

Comments
 (0)