Skip to content

Commit 2ca090d

Browse files
committed
add error response values
1 parent d5b7b4d commit 2ca090d

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

draft-ietf-oauth-attestation-based-client-auth.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -317,6 +317,8 @@ To validate an HTTP request which contains the client attestation headers, the r
317317
2. There is precisely one OAuth-Client-Attestation-PoP HTTP request header field, where its value is a single well-formed JWT conforming to the syntax outlined in [](client-attestation-pop-jwt).
318318
3. The signature of the Client Attestation PoP JWT obtained from the OAuth-Client-Attestation-PoP HTTP header verifies with the Client Instance Key contained in the `cnf` claim of the Client Attestation JWT obtained from the OAuth-Client-Attestation HTTP header.
319319

320+
An error parameter according to Section 3 of {{RFC6750}} SHOULD be included to indicate why a request was declined. If the client attestation is absent or not using an expected server-provided challenge, the value `use_attestation_challenge` can be used to indicate that an attestation with a server-provided challenge was expected. If the attestation was present but could not be successfully verified, the value `invalid_client_attestation` is used.
321+
320322
## Client Attestation at the Token Endpoint {#token-endpoint}
321323

322324
While usage of the the client attestation mechanism defined by this draft can be used in a variety of different HTTP requests to different endpoints, usage within the token request as defined by {{RFC6749}} has particular additional considerations outlined below.
@@ -522,6 +524,22 @@ This specification requests registration of the following values in the IANA "OA
522524
* Change Controller: IETF
523525
* Reference: [](#challenge-retrieval) of this specification
524526

527+
## OAuth Extensions Error Registration
528+
529+
This specification requests registration of the following values in the IANA "OAuth Extensions Error Registry" registry of {{IANA.OAuth.Params}} established by {{RFC6749}}.
530+
531+
* Name: use_attestation_challenge
532+
* Usage Location: token error response, resource access error response
533+
* Protocol Extension: OAuth 2.0 Attestation-Based Client Authentication
534+
* Change Controller: IETF
535+
* Reference: this specification
536+
537+
* Name: invalid_client_attestation
538+
* Usage Location: token error response, resource access error response
539+
* Protocol Extension: OAuth 2.0 Attestation-Based Client Authentication
540+
* Change Controller: IETF
541+
* Reference: this specification
542+
525543
## Registration of attest_jwt_client_auth Token Endpoint Authentication Method
526544

527545
This section registers the value "attest_jwt_client_auth" in the IANA "OAuth Token Endpoint Authentication Methods" registry established by OAuth 2.0 Dynamic Client Registration Protocol {{RFC7591}}.

0 commit comments

Comments
 (0)