Skip to content

Commit 6ed0631

Browse files
committed
add implementation consideration for Authorization Server Metadata
1 parent 693d9e7 commit 6ed0631

File tree

1 file changed

+25
-1
lines changed

1 file changed

+25
-1
lines changed

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

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -576,6 +576,14 @@ In any case the Authorization Server SHOULD ensure the freshness of the Client A
576576

577577
The approach using a challenge explicitly provided by the Authorization Server gives stronger replay attack detection guarantees, however support by the Authorization Server is OPTIONAL to simplify mandatory implementation requirements. The `jti` value is mandatory and hence acts as a default fallback.
578578

579+
# Implementation Consideration
580+
581+
## Authorization Server Metadata
582+
583+
The Authorization Server SHOULD communicate support and requirement for authentication with Attestation-Based Client Authentication by using the value `attest_jwt_client_auth` in the `token_endpoint_auth_methods_supported` within its published metadata.
584+
585+
The Authorization Server SHOULD communicate supported algorithms for client attestations by using `client_attestation_alg_values_supported` and `client_attestation_pop_alg_values_supported` within its published metadata. This enables the client to validate that its client attestation is understood by the Authorization Server prior to authentication. The client MAY try to get a new client attestation with different algorithms.
586+
579587
# Appendix A IANA Considerations
580588

581589
## OAuth Parameters Registration
@@ -595,12 +603,26 @@ This specification requests registration of the following values in the IANA "OA
595603
* Usage Location: token error response, resource access error response
596604
* Protocol Extension: OAuth 2.0 Attestation-Based Client Authentication
597605
* Change Controller: IETF
598-
* Reference: this specification
606+
* Reference: [](#checking-http-requests-with-client-attestations) of this specification
599607

600608
* Name: invalid_client_attestation
601609
* Usage Location: token error response, resource access error response
602610
* Protocol Extension: OAuth 2.0 Attestation-Based Client Authentication
603611
* Change Controller: IETF
612+
* Reference: [](#checking-http-requests-with-client-attestations) of this specification
613+
614+
## OAuth Authorization Server Metadata Registration
615+
616+
This specification requests registration of the following values in the IANA "OAuth Authorization Server Metadata" registry of {{IANA.OAuth.Params}} established by [RFC8414].
617+
618+
* Metadata Name: client_attestation_alg_values_supported
619+
* Metadata Description: JSON array containing a list of algorithms supported by the authorization server for client attestation signing
620+
* Change Controller: IETF
621+
* Reference: [](#checking-http-requests-with-client-attestations) of this specification
622+
623+
* Metadata Name: client_attestation_pop_alg_values_supported
624+
* Metadata Description: JSON array containing a list of algorithms supported by the authorization server for client attestation proof of possession signing
625+
* Change Controller: IETF
604626
* Reference: this specification
605627

606628
## Registration of attest_jwt_client_auth Token Endpoint Authentication Method
@@ -637,6 +659,8 @@ This section requests registration of the following scheme in the "Hypertext Tra
637659

638660
* require `iat` in Client Attestation PoP JWT
639661
* clarify `use_attestation_challenge` and add `invalid_client_attestation`
662+
* add `client_attestation_alg_values_supported` and `client_attestation_pop_alg_values_supported` to IANA registration
663+
* add implementation consideration for Authorization Server Metadata
640664

641665
-06
642666

0 commit comments

Comments
 (0)