Skip to content
Registry StackDocsv0.25.0

Publish OAuth protected-resource metadata

GET
/.well-known/oauth-protected-resource
curl --request GET \
--url https://example.com/.well-known/oauth-protected-resource

RFC 9728 metadata binds this exact Evidence resource origin to one authorization-server issuer, the Evidence response JWKS, and header-only bearer transport. It contains no requester-scoped or operator-private configuration.

If-None-Match
string
/^"[a-f0-9]{64}"$/

The exact strong entity tag from a prior response.

OAuth protected-resource metadata

Media typeapplication/json
object
authorization_servers
required
Array<string>
>= 1 items <= 1 items unique items
bearer_methods_supported
required
Array
>= 1 items <= 1 items unique items
jwks_uri
required
string format: uri
<= 1024 characters
resource
required
string format: uri
<= 512 characters
Example
{
"bearer_methods_supported": [
"header"
]
}
Cache-Control
string
Allowed values: public, max-age=600

Public metadata may be cached for at most ten minutes.

ETag
string
/^"[a-f0-9]{64}"$/

Strong SHA-256 entity tag over the exact response bytes.

traceparent
string
/^00-(?!0{32}-)[0-9a-f]{32}-(?!0{16}-)[0-9a-f]{16}-[0-9a-f]{2}$/

Effective W3C trace context. One valid inbound traceparent is retained; missing, invalid, or duplicate values are replaced and tracestate is never reflected.

The protected-resource metadata is unchanged

Cache-Control
string
Allowed values: public, max-age=600

Public metadata may be cached for at most ten minutes.

ETag
string
/^"[a-f0-9]{64}"$/

Strong SHA-256 entity tag over the exact response bytes.

traceparent
string
/^00-(?!0{32}-)[0-9a-f]{32}-(?!0{16}-)[0-9a-f]{16}-[0-9a-f]{2}$/

Effective W3C trace context. One valid inbound traceparent is retained; missing, invalid, or duplicate values are replaced and tracestate is never reflected.