Skip to content

Commit

Permalink
Improved wording and cleanup regarding the tctx claim
Browse files Browse the repository at this point in the history
  • Loading branch information
gffletch authored Dec 18, 2024
1 parent 7dcc5aa commit ad97c32
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions draft-ietf-oauth-transaction-tokens.md
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ The JSON value of the `rctx` claim MAY include any values the Txn-Token Service
* `authn` The authentication method used to identify the requester. Its value is a StringOrURI that uniquely identifies the method used.
* `req_wl` The requesting workload. A StringOrURI that uniquely identifies the computational entity that requested the Txn-Token. This entity MUST be within the Trust Domain of the Txn-Token. If a replacement Txn-Token has been requested, then this claim will be an array of StringOrURIs representing the different workloads that have requested Txn-Tokens as part of the transaction processing.

### Authorization Details {#authorization-details}
### Transaction Context {#transaction-context}
The Txn-Token SHOULD contain an `tctx` claim. The value of this claim is a JSON object that contains name/value pairs (wherein the value could itself be an object), which together assert the details that remain immutable through the call-chain where this Txn-Token is used.

Txn-Tokens are primarily used to assure identity and context for a transaction, and the content of this field is a critical part of that context.
Expand Down Expand Up @@ -466,7 +466,7 @@ To request a Txn-Token the workload invokes the OAuth 2.0 {{RFC6749}} token endp
The following additional parameters MAY be present in a Txn-Token Request:

* `request_context` OPTIONAL. This parameter contains a base64url encoded JSON object which represents the context of this transaction. The parameter SHOULD be present and how the Transaction Token Service uses this parameter is out of scope for this specification.
* `request_details` OPTIONAL. This parameter contains a base64url encoded JSON object which represents additional details of the transaction that MUST remain immutable throughout the processing of the transaction by multiple workloads.
* `request_details` OPTIONAL. This parameter contains a base64url encoded JSON object which represents additional details of the transaction that MUST remain immutable throughout the processing of the transaction by multiple workloads. The Transaction Token Service uses this information to construct the `tctx` claim.

The requesting workload MUST authenticate its identity to the Transaction Token Service. The exact client authentication mechanism used is outside the scope of this specification.

Expand Down Expand Up @@ -644,7 +644,7 @@ A workload may accidently send a transaction token request to a service that is
# Privacy Considerations {#Privacy}

## Obfuscation of Personal Information
Some `rctx` claims may be considered personal information in some jurisdictions
Some `rctx` and `tctx` claims may be considered personal information in some jurisdictions
and if so their values need to be obfuscated. For example, originating IP address
(`req_ip`) is often considered personal information and in that case must be
protected through some obfuscation method (e.g. salted SHA256).
Expand Down Expand Up @@ -676,7 +676,7 @@ This specification registers the following token type identifiers to the "OAuth
## JWT Claims Registry Contents

* Claim Name: `tctx`
* Claim Description: The authorization context details
* Claim Description: The transaction authorization details
* Change Controller: IETF
* Specification Document: Section {{txn-token-claims}} of this specification

Expand Down

0 comments on commit ad97c32

Please sign in to comment.