| Internet-Draft | SPICE-ACTOR-CHAINS | March 2026 |
| Prasad, et al. | Expires 17 September 2026 | [Page] |
This document defines five actor-chain profiles for OAuth 2.0 Token Exchange
{{!RFC8693}}. {{!RFC8693}} permits nested act claims, but prior actors remain
informational only and token exchange does not define how a delegation path is
preserved and validated across successive exchanges.¶
This document defines profile-specific processing for linear multi-hop workflows. The profiles are Asserted Delegation Path, Selectively Disclosed Asserted Delegation Path, Committed Delegation Path, Commitment-Only Delegation Path, and Selectively Disclosed Committed Delegation Path.¶
These profiles preserve the existing meanings of sub and act, support same-
domain and cross-domain delegation, require sender-constrained tokens, and
provide different tradeoffs among readable chain-based authorization,
cryptographic accountability, auditability, privacy, and long-running workflow
support.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 17 September 2026.¶
Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
In service-to-service, tool-calling, and agent-to-agent systems, a workload often receives a token, performs work, and then exchanges that token to call another workload. This pattern appears in microservices, workload identity systems, MCP-style tool invocation, and AI-agent orchestration pipelines. The resulting path can span multiple hops and multiple Authorization Servers (ASes).¶
defines token exchange and the act claim for the current actor,
but it does not define a standardized model for preserving and validating the
full delegation path across successive exchanges.¶
This document defines cryptographically verifiable actor-chain profiles for OAuth 2.0 Token Exchange.¶
For compactness on the wire, tokens and token-carried commitment objects use
the compact names achp (actor-chain profile), ach (actor chain), and
achc (actor-chain commitment). OAuth request parameters and metadata remain
descriptive.¶
sub continues to identify the token subject.¶
act, when present, continues to identify the current actor.¶
ach, when present, carries the ordered delegation path.¶
achc, when present, carries cumulative committed chain
state for stronger tamper evidence and auditability.¶
The design separates:¶
This document is format-agnostic. JWT deployments use JSON and JWS. CWT deployments use CBOR and COSE.¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 {{!RFC2119}} {{!RFC8174}} when, and only when, they appear in all capitals, as shown here.¶
This document also leverages terminology from OAuth 2.0 Token Exchange {{!RFC8693}}, the SPICE Architecture {{!I-D.ietf-spice-arch}}, and the RATS Architecture {{!RFC9334}}.¶
Actor: A workload, service, application component, agent, or other authenticated entity that receives a token, performs work, and MAY subsequently act toward another actor.¶
Current actor: The authenticated entity presently performing token exchange.¶
Presenting actor: The authenticated actor that presents a sender-constrained token to a recipient.¶
Example: when B exchanges a token at the Authorization Server, B is the
current actor. When B later presents the resulting sender-constrained token
to C, B is the presenting actor.¶
Recipient: The actor or resource server identified as the intended target of an issued token.¶
Actor chain: The ordered sequence of actors that have acted so far in one workflow instance.¶
Readable chain: An ach value carried in an ordinary token and visible
to downstream recipients.¶
Committed chain state: The cumulative cryptographic state that binds prior accepted chain state to a newly accepted hop.¶
Step proof: A profile-defined proof signed by the current actor that binds that actor's participation to the workflow, prior chain state, and target context.¶
Target context: The canonical representation of the intended audience and any other target-selection inputs that a profile-defined proof binds to the next hop.¶
Workflow identifier (sid): A stable identifier minted once at workflow
start and retained for the lifetime of the workflow instance.¶
Cross-domain re-issuance: A second token exchange performed at another domain's Authorization Server in order to obtain a local token trusted by the next recipient, without extending the actor chain.¶
Continuity: The property that the inbound token is being presented by the actor that the chain state indicates should be presenting it.¶
Append-only processing: The rule that a newly acting actor is appended to the prior chain state, without insertion, deletion, reordering, or modification of prior actors.¶
Terminal recipient: A recipient that performs work locally and does not extend the actor chain further.¶
Refresh-Exchange: A token-exchange operation by the same current actor that refreshes a short-lived transport token without appending the actor chain, changing the active profile, or generating a new step proof.¶
defines the top-level act claim for the current actor and allows
nested prior actors. However, prior nested act claims are informational only
for access-control decisions. In multi-hop systems, especially service-to-
service and agentic systems, that is not sufficient.¶
Consider:¶
User -> Orchestrator -> Planner -> Tool Agent -> Data API¶
By the time the request reaches the Data API, the immediate caller may be visible, but the upstream delegation path is not standardized as a policy input and is not bound across successive token exchanges in a way that can be independently validated or audited. This creates several concrete gaps:¶
This specification extends OAuth 2.0 Token Exchange {{!RFC8693}} without
changing the existing meanings of sub, act, or may_act.¶
The following rules apply:¶
sub continues to identify the subject of the issued token.¶
act, when present, MUST identify the current actor represented by the
issued token.¶
ach, when present, is the profile-defined ordered list of actors
that have acted so far in the workflow instance.¶
act claims, if present for compatibility or deployment-
specific reasons, remain informational only for access-control purposes,
consistent with {{!RFC8693}}.¶
may_act, when present in an inbound token, MAY be used by the accepting
Authorization Server as one input when determining whether the authenticated
current actor is authorized to perform token exchange for the requested
target context.¶
Nothing in this specification redefines the delegation and impersonation semantics described in {{!RFC8693}}.¶
This document specifies a family of profiles for representing and validating actor progression across a linear workflow using OAuth 2.0 Token Exchange.¶
The base workflow model is linear:¶
A -> B -> C -> D¶
The first actor initializes the workflow. Each subsequent actor MAY:¶
This document defines five profiles:¶
ach and
relies on AS-asserted chain continuity under a non-collusion assumption;¶
ach and relies on the issuing AS
for both chain continuity and disclosure policy;¶
ach and
adds actor-signed step proofs plus cumulative committed state;¶
ach from ordinary tokens and preserves only cumulative committed
state; and¶
The five profiles are organized in two branches so that later profiles can be read as deltas, not as full restatements:¶
Each derived profile inherits all requirements of its branch root except as modified in that profile. Readers therefore need only read:¶
The following table is a quick orientation aid.¶
| Profile | Readable ach in ordinary tokens |
achc
|
Selective disclosure | Next-hop authorization basis | Primary trust/evidence model |
|---|---|---|---|---|---|
| Asserted Delegation Path | Full | No | No | Full readable chain | AS-asserted continuity |
| Selectively Disclosed Asserted Delegation Path | Disclosed subset | No | Yes | Disclosed readable subset | AS-asserted continuity plus AS disclosure policy |
| Committed Delegation Path | Full | Yes | No | Full readable chain | Actor-signed step proofs plus cumulative commitment |
| Commitment-Only Delegation Path | No | Yes | No | Presenting actor only | Actor-signed step proofs plus cumulative commitment |
| Selectively Disclosed Committed Delegation Path | Disclosed subset | Yes | Yes | Disclosed readable subset plus commitment continuity | Actor-signed step proofs over full chain plus recipient-specific disclosure |
This document does not define branching or fan-out semantics. A single accepted prior state yields at most one accepted successor state unless a future specification defines branching behavior. This intentional linearity keeps the base profiles simple for replay detection, audit reconstruction, and interoperability.¶
A deployment that needs parallel downstream work today SHOULD initiate distinct
workflow instances for each branch, each with its own sid, rather than
treating multiple successors as one continued linear workflow. This
specification does not define shared-root, branch-merge, or branch-selection
semantics across those separate workflow instances.¶
The actor chain advances only when an actor acts. Mere receipt of a token does not append the recipient.¶
If A calls B, and B later calls C, then:¶
A begins the workflow and becomes the first acting actor.¶
A calls B, B validates a token representing A.¶
B later exchanges that token to call C, B becomes the next
acting actor.¶
C is not appended merely because C received a token. C is appended
only if C later acts toward another hop.¶
A typical same-domain progression looks like this:¶
A AS1 B C |-- bootstrap ----->| | |<- token T_A ------| | |------------------------------ present T_A ------------>| | | | |-- exchange T_A --> AS1 | |<- token T_B ------| |------------------------------------------------ present T_B --------->|¶
In that example, B is the current actor while exchanging T_A at AS1, and
B is the presenting actor when later sending T_B to C.¶
Within one trust domain, the current actor exchanges its inbound token at its home Authorization Server, which validates prior state and issues a token for the next hop.¶
Across a trust boundary, if the next recipient does not trust the current Authorization Server directly, the current actor performs a second token exchange at the next domain's Authorization Server. That second exchange preserves the already-established chain state and does not append the next recipient.¶
A typical cross-domain re-issuance looks like this:¶
B AS1 AS2 C |-- exchange ------>| | |<- token trusted by AS2 --| | |-------------------------- exchange preserved state ---->| |<------------------------- local token for C ------------| |------------------------------------------------ present local token -->|¶
This specification provides different assurances depending on the selected profile:¶
Tokens issued under any profile defined by this document:¶
Profiles that preserve readable chain state additionally carry ach.¶
Profiles that use selective-disclosure readable chain state carry ach
in a selective-disclosure representation appropriate to the token format.¶
Profiles that preserve committed chain state additionally carry
achc.¶
The sid value:¶
Implementation note: implementers MUST NOT assume that a familiar UUID helper
automatically satisfies the entropy requirement for sid. In particular,
standard UUIDv4 provides 122 bits of random entropy and therefore does not by
itself satisfy the requirement stated above.¶
Profile selection MUST be signaled explicitly using the token request parameter
actor_chain_profile and the corresponding token claim
achp.¶
The following normative requirements apply to target_context.¶
target_context MUST include aud.¶
A deployment MAY additionally include resource identifiers, operation names, tool identifiers, method names, request classes, or other target-selection inputs used by local authorization policy.¶
If no such additional values are available, target_context is identical to
aud.¶
Whenever target_context is incorporated into a profile-defined signature or
commitment input, it MUST be canonicalized using JCS in JWT deployments and
deterministic CBOR in CWT deployments before hashing or signing.¶
A token issued under any profile in this document MUST be sender-constrained to the actor represented by that token.¶
A recipient or Authorization Server validating such a token MUST verify the applicable sender-constrained proof before accepting the token.¶
Failure of sender-constrained validation MUST cause rejection.¶
For committed-chain profiles and for hop_ack, any signature used as a
profile-defined proof MUST be generated with an asymmetric key bound to the
authenticated actor or recipient identity by local trust policy.¶
For a committed-profile step proof, the ActorID represented in the proof, the key used to sign the proof, and the sender-constrained key used to present the corresponding token MUST all be bound to the same actor identity. When the same key is not reused for both functions, the Authorization Server MUST validate an explicit local binding between the proof-signing key and the sender-constrained presentation key before accepting the proof.¶
For hop_ack, the recipient ActorID, the key used to sign the acknowledgment,
and any sender-constrained key used by that recipient for the protected
interaction MUST likewise be bound to the same recipient identity.¶
Shared client secrets MUST NOT be the sole basis for independently verifiable step proofs or receiver acknowledgments.¶
A deployment SHOULD reuse the same asymmetric key material used for sender- constrained token presentation, or another asymmetric key that is cryptographically bound to the same actor identity.¶
When a current actor submits an inbound token as a subject_token in token
exchange, the accepting Authorization Server MUST verify that the authenticated
current actor was an intended recipient of that inbound token according to local
audience, resource, or equivalent validation rules.¶
Possession of an inbound token alone is insufficient.¶
Recipients and Authorization Servers MUST enforce replay and freshness checks on inbound tokens according to local policy.¶
For profiles that use actor-signed step proofs, the accepting Authorization Server:¶
All profile-defined signed or hashed inputs MUST use a canonical serialization defined by this specification.¶
In JWT/JSON deployments, canonical profile-defined proof payloads MUST be serialized using JCS {{!RFC8785}}. In CWT/CBOR deployments, they MUST be serialized using deterministic CBOR encoding as defined in {{!RFC8949}}, Section 4.2.¶
This specification requires a canonical representation for actor identity in profile-defined chain entries and step proofs.¶
Each actor identifier MUST be represented as an ActorID structure containing exactly two members:¶
iss: the issuer identifier naming the namespace in which the actor subject
value is defined; and¶
sub: the subject identifier of the actor within that issuer namespace.¶
For JWT and JSON-based proof payloads, an ActorID is a JSON object with members
iss and sub, serialized using JCS {{!RFC8785}}.¶
For CWT and CBOR-based proof payloads, an ActorID is a deterministic CBOR map
with integer label 1 for iss and integer label 2 for sub.¶
An ActorID:¶
iss, sub); and¶
Readable-chain profiles carry arrays of ActorID values in ach.
Privacy-preserving profiles bind ActorID values only inside step proofs and
related evidence. In examples and formulas, [A,B] denotes a readable chain of
ActorID values for actors A and B.¶
JWT-based artifacts defined by this specification MUST use explicit typ
values.¶
The following values are defined:¶
Verifiers MUST enforce mutually exclusive validation rules based on artifact type and MUST NOT accept one artifact type in place of another.¶
CWT and COSE deployments MUST apply equivalent type discrimination by verifying
the expected artifact class, exact ctx value, and artifact-specific payload
structure defined by the relevant binding section of this specification.¶
Unless another application profile explicitly states otherwise, tokens issued under this specification are access tokens.¶
Token exchange responses MUST use the RFC 8693 token type fields consistently with the underlying representation and deployment.¶
Committed-chain profiles use a named hash algorithm for construction of
achc.¶
Commitment hash algorithm identifiers are values from the IANA Named Information Hash Algorithm Registry {{IANA.Hash.Algorithms}}.¶
Implementations supporting committed-chain profiles MUST implement sha-256.
Implementations SHOULD implement sha-384.¶
Every achc object and every committed-profile bootstrap
context MUST carry an explicit halg value. Verifiers MUST NOT infer or
substitute halg when it is absent.¶
Verifiers MUST enforce a locally configured allow-list of acceptable commitment hash algorithms and MUST NOT accept algorithm substitution based solely on attacker-controlled inputs.¶
Committed profiles use achc to bind each accepted hop to the
prior accepted state. The commitment hash algorithm is selected once for the
workflow by the issuing Authorization Server during bootstrap and remains fixed
for the lifetime of that workflow instance.¶
Each achc value is a signed commitment object whose payload
contains:¶
ctx: the context string actor-chain-commitment-v1;¶
sid: the workflow identifier;¶
achp: the active profile identifier;¶
halg: the hash algorithm identifier;¶
prev: the prior commitment digest, or the bootstrap initial_chain_seed at
workflow start;¶
step_hash: Hash_halg(step_proof_bytes); and¶
curr: Hash_halg(CanonicalEncode({ctx, sid, achp, halg, prev, step_hash})).¶
The halg value MUST be a text string naming a hash algorithm from the IANA
Named Information Hash Algorithm Registry {{IANA.Hash.Algorithms}}. This
specification permits only sha-256 and sha-384 for
achc. Hash algorithms with truncated outputs, including
truncated sha-256 variants, MUST NOT be used. Other registry values MUST NOT
be used with this specification unless a future Standards Track specification
updates this document.¶
When a profile-defined proof input refers to a prior
achc, the value incorporated into the proof input MUST be
that prior commitment's verified curr digest, not the raw serialized
commitment object.¶
The abstract function used throughout this document is therefore:¶
Commit_AS(prev_digest, step_proof_bytes, halg)
= AS-signed commitment object over payload {
ctx,
sid,
achp,
halg,
prev = prev_digest,
step_hash = Hash_halg(step_proof_bytes),
curr = Hash_halg(CanonicalEncode({ctx, sid, achp, halg, prev, step_hash}))
}
¶
The exact wire encoding of the signed commitment object is defined in the JWT and CWT bindings in Appendix A and Appendix B.¶
The committed profiles use a small number of proof-input templates. This section defines them once so that profile sections can state only their profile-specific substitutions.¶
Let:¶
profile be the active achp value;¶
sid be the stable workflow identifier;¶
prev_state be either the bootstrap initial_chain_seed or the verified
prior commitment digest, as required by the profile;¶
full_actor_chain_for_hop be the canonical full readable actor chain for the
hop after appending the authenticated current actor;¶
TC_next be the canonical target_context for the next hop; and¶
ActorID(N) be the authenticated current actor.¶
Symbols such as TC_B, TC_C, and TC_next denote the canonical
target_context for the corresponding next hop.¶
Committed profiles instantiate one of the following proof-input templates:¶
readable committed chain template:¶
Sign_N(ds || sid || prev_state || full_actor_chain_for_hop || target_context=TC_next)¶
private committed chain template:¶
Sign_N(ds || sid || prev_state || actor=ActorID(N) || target_context=TC_next)¶
The domain-separation string ds is profile-specific:¶
actor-chain-readable-committed-step-sig-v1 for Committed Delegation Path;¶
actor-chain-private-committed-step-sig-v1 for Commitment-Only Delegation
Path; and¶
actor-chain-selectively-disclosed-committed-step-sig-v1 for Selectively
Disclosed Committed Delegation Path.¶
In the Selectively Disclosed Committed Delegation Path profile, the readable value disclosed to the next recipient MAY be a subset, but the proof input still uses the full canonical chain for that hop.¶
If the next hop does not trust the current Authorization Server directly, the current actor MUST perform a second token exchange at the next domain's Authorization Server.¶
The cross-domain Authorization Server MUST:¶
achp;¶
sid;¶
ach, if present;¶
achc, if present, exactly as verified;¶
The cross-domain Authorization Server MAY mint a new local jti, apply a new
local expiry, change token format or envelope, and add local trust or policy
claims. It MUST NOT alter the verified preserved chain state.¶
A current actor MAY use token exchange to refresh a short-lived transport token without appending the actor chain or regenerating a step proof.¶
A Refresh-Exchange request MUST include:¶
actor_chain_refresh=true;¶
subject_token; and¶
A Refresh-Exchange request MUST NOT broaden the active profile, represented actor identity, readable chain state, committed chain state, or target context. The requested target context MUST be identical to, or narrower than, the target context already represented by the inbound token according to local policy.¶
When processing Refresh-Exchange, the Authorization Server MUST:¶
jti and refreshed exp.¶
For Refresh-Exchange, the Authorization Server MUST preserve sid,
achp, ach, and achc, if
present. A new step proof MUST NOT be required, and a new commitment object
MUST NOT be created.¶
A Refresh-Exchange MAY rotate the sender-constrained presentation key only if
the actor provides a key-transition proof that binds the new presentation key
to the same sid and ActorID under local policy, and the Authorization Server
verifies and records that proof. Such proof MAY be satisfied by continuity
mechanisms provided by the sender-constrained binding in use or by another
locally trusted proof-of-possession transition method. Otherwise, the sender-
constrained key binding MUST be preserved. Historical step proofs remain bound
to the keys used when those proofs were created and MUST be verified against
those historical bindings, not against a later rotated key.¶
A recipient or coordinating component MUST treat a token obtained by Refresh-Exchange as representing the same accepted chain state as the inbound token from which it was refreshed. If a sender-constrained key transition occurred, recipients still validate historical step proofs against the keys bound when those proofs were produced and rely on Authorization-Server records or other retained evidence for the key-transition event itself.¶
Token exchange errors in this specification build on OAuth 2.0 and OAuth 2.0 Token Exchange.¶
An Authorization Server processing a token exchange request applies the following mapping:¶
| OAuth error code | Triggering condition |
|---|---|
invalid_request
|
Malformed or missing profile-defined parameters, malformed bootstrap context, malformed ActorID values, malformed commitment objects, or unsupported profile bindings |
invalid_target
|
The requested audience, target context, or recipient is not permitted or not supported |
invalid_grant
|
The subject_token fails validation, sender-constrained verification fails, the intended-recipient check fails, continuity fails at token exchange, replay or freshness checks fail, actor_chain_step_proof verification fails, or the submitted prior state is inconsistent with the claimed profile state |
Recipients and Authorization Servers MUST return protocol-appropriate error signals for authentication, authorization, profile-validation, and continuity failures.¶
In HTTP deployments, this typically maps to 400-series status codes and OAuth- appropriate error values. In non-HTTP deployments, functionally equivalent protocol-native error signaling MUST be used.¶
Error responses and logs MUST NOT disclose undisclosed prior actors, full step proofs, request-context digests, or other sensitive proof material unless the deployment explicitly requires such disclosure for diagnostics.¶
Unless a profile states otherwise, a recipient validating an inbound actor-chain token MUST verify:¶
Unless a profile states otherwise, a current actor validating a returned token from token exchange MUST verify the token signature, profile identifier, and any profile-specific append-only or commitment checks before presenting that token to the next hop.¶
The profile selection table appears earlier in "Scope and Model". The sections below define the asserted branch root, the committed branch root, and the derived profiles that inherit from those roots.¶
The profile identifier string for this profile is
asserted-delegation-path. It is used as the actor_chain_profile token
request parameter value and as the achp token claim value.¶
The Asserted Delegation Path profile extends token exchange by carrying a
readable ach and requiring chain-continuity validation by both the
current actor and the issuing Authorization Server at each hop.¶
This profile provides hop-by-hop readable chain integrity based on issuer- asserted chain state and continuity checks.¶
This profile assumes that an actor does not collude with its home Authorization Server.¶
At workflow start, actor A MUST request a token from AS1 with:¶
If AS1 accepts the request, AS1 MUST issue T_A containing at least:¶
When A calls B, A MUST present T_A to B.¶
B MUST perform recipient validation as described in
"Recipient Validation of an Inbound Token".¶
B MUST extract the verified ach and verify that its last actor is
A.¶
If that continuity check fails, B MUST reject the request.¶
To call C, B MUST submit T_A to AS1 as the RFC 8693 subject_token.¶
AS1 MUST perform token-exchange validation as described in
"Authorization Server Validation of Token Exchange".¶
AS1 MUST read the prior chain from T_A, append B, and issue T_B
containing at least:¶
Upon receipt of T_B, B MUST perform current-actor returned-token
validation as described in "Current-Actor Validation of a Returned Token".¶
B MUST verify that T_B.ach is exactly the previously verified chain
from T_A with B appended.¶
If that append-only check fails, B MUST reject T_B.¶
Upon receipt of the final B-token, C MUST perform recipient validation as
described in "Recipient Validation of an Inbound Token".¶
C MUST extract the verified ach and use it for authorization
decisions.¶
Under the non-collusion assumption, prior actors MUST NOT be silently inserted, removed, reordered, or altered during token exchange.¶
The profile identifier string for this profile is
selectively-disclosed-asserted-delegation-path. It is used as the
actor_chain_profile token request parameter value and as the achp token
claim value.¶
This profile inherits the Asserted Delegation Path profile and changes only the visibility of the readable chain: the issuing Authorization Server MAY disclose only a recipient-specific ordered subset of the canonical full chain.¶
Except as modified below, all requirements of the Asserted Delegation Path profile apply.¶
The disclosed ach seen by a recipient MUST be an ordered subsequence
of the canonical full chain for that hop and MUST include the current actor as
its last element.¶
A recipient MUST treat undisclosed prior actors as unavailable and MUST NOT infer adjacency, absence, or exact chain length from the disclosed subset alone.¶
This profile relies on the issuing Authorization Server for hidden prior-chain continuity and disclosure policy. It does not provide the step-proof-based accountability or cumulative commitment state of the committed profiles.¶
At bootstrap and at each later exchange, wherever the Asserted Delegation Path
profile would issue a token containing a readable ach, this profile
MUST instead issue a selectively disclosable ach for the intended
recipient.¶
If the token format requires separate disclosure artifacts, the issuing
Authorization Server MUST return the artifacts needed for that recipient to
recover the disclosed ach.¶
Where the Asserted Delegation Path profile requires presentation or validation
of a readable ach, this profile instead requires presentation and
validation of the selectively disclosed chain and the applicable selective-
disclosure proof.¶
The current recipient and the current actor MUST verify that the last disclosed actor is the presenting actor for the inbound token or, for a returned token, the current actor that requested exchange.¶
Unlike the Asserted Delegation Path profile, the current actor and downstream recipient do not independently validate the hidden undisclosed portion of the prior chain. They validate only the disclosed subset they receive.¶
Under the non-collusion assumption, silent insertion, removal, reordering, or alteration of the disclosed chain seen by a recipient is prevented with respect to what the issuing Authorization Server asserted for that recipient.¶
This profile does not let the current actor or a downstream recipient independently validate hidden prior actors that were not disclosed to them.¶
This profile does not provide step-proof-based accountability or cumulative commitment-based auditability.¶
This profile does not by itself address malicious application payloads.¶
This profile does not by itself prevent confused-deputy behavior.¶
The profile identifier string for this profile is
committed-delegation-path. It is used as the actor_chain_profile token
request parameter value and as the achp token claim value.¶
The Committed Delegation Path profile builds on the Asserted Delegation Path
profile by adding per-hop actor-signed step proofs and cumulative committed
state, while preserving a readable ach for downstream authorization.¶
This profile preserves readable chain-based authorization and provides stronger accountability and non-repudiation than the Asserted Delegation Path profile.¶
This profile does not guarantee inline prevention of every invalid token that could be issued by a colluding actor and its home Authorization Server.¶
The evidentiary value of this profile depends on retention or discoverability of step proofs, exchange records, and associated verification material.¶
At workflow start, actor A MUST request bootstrap context from AS1 with:¶
AS1 selects halg for the workflow according to local policy and the
supported values advertised in Authorization Server metadata.¶
AS1 MUST generate:¶
The halg value in the bootstrap context MUST be either sha-256 or
sha-384 and MUST remain fixed for the lifetime of the workflow instance.¶
initial_chain_seed MUST be derived as:¶
Hash_halg("actor-chain-readable-committed-init" || sid)
¶
AS1 MUST return bootstrap context containing at least:¶
The bootstrap context MUST be integrity protected by AS1 and MUST be single
use.¶
A MUST construct:¶
ach=[A]¶
A MUST compute a step proof:¶
chain_sig_A = Sign_A("actor-chain-readable-committed-step-sig-v1" || sid || initial_chain_seed || [A] || target_context=TC_B)
¶
using canonical encoding.¶
A MUST submit a token request containing:¶
When A calls B, A MUST present T_A to B.¶
B MUST verify:¶
B MUST extract:¶
B MUST verify that the last actor in the readable chain is A.¶
If that continuity check fails, B MUST reject the request.¶
To call C, B MUST:¶
new_actor_chain=[A,B]; and¶
prior_commitment_digest to the verified curr value extracted from T_A.achc.¶
B MUST compute:¶
chain_sig_B = Sign_B("actor-chain-readable-committed-step-sig-v1" || sid || prior_commitment_digest || [A,B] || target_context=TC_C)
¶
using canonical encoding.¶
B MUST submit to AS1:¶
AS1 MUST verify:¶
T_A;¶
B;¶
B was an intended recipient of the inbound subject_token;¶
B is authorized to act for the requested target context; and¶
that chain_sig_B binds:¶
If verification succeeds, AS1 MUST compute:¶
achc = Commit_AS1(prior_commitment_digest, chain_sig_B)¶
AS1 MUST issue T_B containing at least:¶
Upon receipt of T_B, B MUST verify the token signature and profile fields.¶
B MUST verify that:¶
[A,B]; and¶
achc equals
Commit_AS1(prior_commitment_digest, chain_sig_B).¶
If either check fails, B MUST reject T_B.¶
Upon receipt of the final B-token, C MUST verify:¶
C MUST extract:¶
C MUST use the readable ach for authorization decisions.¶
A claim that actor V participated in the chain MUST fail unless a valid step
proof for V can be produced and verified against the corresponding prior
committed state and sid.¶
If an actor is omitted from a later readable chain, that omitted actor MAY prove prior participation by presenting:¶
A denial of participation by actor X MUST fail if a valid step proof for X
is available and verifies.¶
This profile preserves readable chain-based authorization while making tampering materially easier to detect, prove, and audit.¶
The profile identifier string for this profile is
commitment-only-delegation-path. It is used as the actor_chain_profile
token request parameter value and as the achp token claim value.¶
This profile inherits the Committed Delegation Path profile and removes the
readable ach from ordinary tokens, leaving only cumulative committed
state and the verified presenting actor visible at the next hop.¶
Except as modified below, all requirements of the Committed Delegation Path profile apply.¶
This profile preserves sender-constrained current-actor continuity and cumulative committed state, but ordinary recipients see only an opaque commitment object and not a readable prior-actor path.¶
This profile does not preserve readable prior-actor authorization at downstream hops. Prior-actor integrity is ordinarily verifiable only by the issuing Authorization Server or an auditor with access to retained step proofs or exchange records.¶
This profile uses the same committed bootstrap pattern as the Committed Delegation Path profile with these substitutions:¶
commitment-only-delegation-path;¶
initial_chain_seed MUST be derived as shown below; and¶
Hash_halg("actor-chain-private-committed-init" || sid)
¶
The initial actor therefore computes:¶
chain_sig_A = Sign_A("actor-chain-private-committed-step-sig-v1" || sid || initial_chain_seed || actor=ActorID(A) || target_context=TC_B)
¶
At each later hop, the acting actor computes:¶
chain_sig_N = Sign_N("actor-chain-private-committed-step-sig-v1" || sid || prior_commitment_digest || actor=ActorID(N) || target_context=TC_next)
¶
The issuing Authorization Server MUST verify the same committed-state continuity checks as in the Committed Delegation Path profile, using actor identity in place of the readable full chain.¶
Tokens issued under this profile MUST contain achc, sid,
jti, aud, and exp, and MUST NOT contain a readable ach.¶
Where the Committed Delegation Path profile would validate a readable
ach, this profile instead validates only:¶
The current recipient and the next-hop recipient MUST verify that the token is being presented by the current actor.¶
The current actor validating a returned token MUST verify only that the returned
commitment equals the expected Commit_AS(prior_commitment_digest, chain_sig).¶
A downstream recipient MUST use the verified presenting actor, not prior actors, for authorization decisions.¶
A downstream recipient MUST NOT infer the identities or number of prior actors
from achc alone.¶
The committed-profile attack-handling properties still apply, but omission, insertion, or reordering of prior actors will ordinarily be detected only by the issuing Authorization Server or by later audit, not by ordinary downstream recipients inline.¶
This profile reduces ordinary-token disclosure and token size while preserving per-hop continuation proofs at the acting hop and cumulative committed state across hops.¶
This profile does not preserve readable prior-actor authorization at downstream hops.¶
This profile does not by itself allow downstream hops to detect omission, insertion, or reordering of prior actors inline once readable disclosure is removed.¶
This profile does not hide prior actors from the Authorization Server that processes token exchange.¶
This profile does not by itself solve malicious application payloads.¶
This profile does not by itself solve confused-deputy behavior.¶
This profile does not by itself solve workflow branching.¶
The profile identifier string for this profile is
selectively-disclosed-committed-delegation-path. It is used as the
actor_chain_profile token request parameter value and as the achp token
claim value.¶
This profile inherits the Committed Delegation Path profile and changes only what ordinary recipients see: the issuing Authorization Server MAY disclose only a recipient-specific ordered subset of the full readable chain, while step proofs and commitments continue to bind the full canonical chain.¶
Except as modified below, all requirements of the Committed Delegation Path profile apply.¶
The disclosed ach seen by a recipient MUST be an ordered subsequence
of the canonical full chain for that hop and MUST include the current actor as
its last element.¶
Step proofs and achc values MUST be computed over the full
canonical chain for the hop, not over the later disclosed subset.¶
A recipient MUST treat undisclosed prior actors as unavailable and MUST NOT infer adjacency, absence, or exact chain length from the disclosed subset alone.¶
This profile uses the same committed bootstrap pattern as the Committed Delegation Path profile with these substitutions:¶
selectively-disclosed-committed-delegation-path;¶
initial_chain_seed MUST be derived as shown below; and¶
"actor-chain-selectively-disclosed-committed-step-sig-v1" while still
binding the full canonical readable chain for the hop.¶
Hash_halg("actor-chain-selectively-disclosed-committed-init" || sid)
¶
The initial actor therefore computes:¶
chain_sig_A = Sign_A("actor-chain-selectively-disclosed-committed-step-sig-v1" || sid || initial_chain_seed || [A] || target_context=TC_B)
¶
At each later hop, the acting actor computes:¶
chain_sig_N = Sign_N("actor-chain-selectively-disclosed-committed-step-sig-v1" || sid || prior_commitment_digest || full_actor_chain_for_hop || target_context=TC_next)
¶
The issuing Authorization Server MUST verify the same full-chain committed-state continuity checks as in the Committed Delegation Path profile.¶
Where the Committed Delegation Path profile would issue a token containing a
readable full ach, this profile MUST instead issue a selectively
disclosable ach for the intended recipient together with any required
disclosure artifacts.¶
Tokens issued under this profile MUST also contain achc,
sid, jti, aud, and exp.¶
Where the Committed Delegation Path profile would present or validate a readable
full ach, this profile instead presents and validates the disclosed
ach and the applicable selective-disclosure proof.¶
The current recipient and the next-hop recipient MUST verify that the last disclosed actor is the presenting actor.¶
The current actor validating a returned token MUST verify:¶
achc;¶
ach whose
last actor is that current actor; and¶
A recipient MAY use the verified disclosed ach for authorization
decisions, but MUST use only the disclosed subset and MUST treat undisclosed
prior actors as unavailable.¶
The committed-profile attack-handling properties still apply to the full canonical chain.¶
Different recipients MAY receive different valid disclosed subsets derived from the same canonical full chain according to local disclosure policy. That alone does not constitute an integrity failure.¶
An actor omitted from a disclosed chain MAY still prove prior participation by presenting the corresponding step proof or immutable Authorization-Server exchange record for the canonical full chain.¶
This profile preserves current-actor continuity, cumulative committed state, and recipient-specific limited readable authorization while keeping the full workflow progression reconstructable from committed proof state.¶
This profile does not preserve full readable prior-actor authorization at downstream hops.¶
This profile does not hide prior actors from the Authorization Server that processes token exchange.¶
This profile does not by itself solve malicious application payloads.¶
This profile does not by itself solve confused-deputy behavior.¶
This profile does not by itself solve workflow branching.¶
A recipient MAY produce a receiver acknowledgment artifact, called hop_ack,
for an inbound actor-chain token. This OPTIONAL extension does not alter chain
progression semantics.¶
A valid hop_ack proves that the recipient accepted responsibility for the
identified hop, bound to the workflow identifier, prior chain state or prior
commitment state, presenting actor, recipient, target context, and request-
context digest.¶
hop_ack MUST NOT by itself append the recipient to the actor chain.¶
A recipient MUST NOT emit hop_ack with status accepted until it has either:¶
A deployment MAY require hop_ack for selected hops, including terminal hops.
When hop_ack is required by policy, the calling actor and any coordinating
component MUST treat that hop as not accepted unless a valid hop_ack is
received and verified.¶
hop_ack does not by itself prove successful completion or correctness of the
requested operation.¶
Recipients are not required to issue hop_ack for rejected, malformed,
abusive, unauthorized, or rate-limited requests. Absence of hop_ack is
sufficient to prevent proof of acceptance.¶
The acknowledgment payload MUST include at least:¶
ctx = actor-chain-hop-ack-v1;¶
sid;¶
achp;¶
jti;¶
target_context;¶
req_hash; and¶
ack, whose value MUST be accepted.¶
A hop_ack MUST be signed by the recipient using JWS or COSE, according to the
same token-format family used by the deployment. If a deployment cannot
construct a canonical request-context object for req_hash, it MUST use
hop_ack only when the inbound token is single-use for one protected request.¶
This specification defines a multi-hop, multi-actor delegation model across one or more trust domains. The security properties provided depend on the selected profile, the correctness of sender-constrained token enforcement, the trust relationship among participating Authorization Servers, and the availability of step proofs or exchange records where relied upon.¶
The protocol seeks to protect the following assets:¶
Relevant adversaries include:¶
This specification assumes:¶
The protocol aims to provide the following properties:¶
This specification does not by itself provide:¶
Even when all checks succeed, a valid token chain does not imply that the requested downstream action is authorized by local business policy. Recipients MUST evaluate authorization using the verified presenting actor, token subject, intended target, and local policy.¶
Deployments that depend on independently verifiable provenance for high-risk operations SHOULD require synchronous validation of committed proof state or otherwise treat the issuing Authorization Server as the sole trust anchor.¶
The security of these profiles depends strongly on sender-constrained token enforcement. If a token can be replayed by an attacker that is not the bound actor, continuity checks become materially weaker.¶
Any ambiguity in canonical serialization, actor identity representation, target representation, or proof payload encoding can cause false verification failures or inconsistent commitment values across implementations.¶
A valid readable ach does not imply that the application-layer request
content is safe, correct, or policy-conformant. Recipients MUST apply local
payload validation and authorization.¶
The evidentiary benefits of the committed profiles depend on retention or discoverability of step proofs, exchange records, and relevant verification material. Without such retention, the profiles still provide structured committed state, but post hoc provability and non-repudiation are materially weakened.¶
Authorization Servers supporting committed profiles SHOULD retain proof state, exchange records, and the historical verification material needed for later verification for at least the maximum validity period of the longest-lived relevant token plus a deployment-configured audit window. Retention policies SHOULD also account for later verification during or after key rotation.¶
Recipients using the Commitment-Only Delegation Path profile can validate the presenting actor and preserved commitment continuity, but cannot authorize based on readable prior-actor membership or order from the ordinary token alone.¶
Recipients using the Selectively Disclosed Asserted Delegation Path profile or
the Selectively Disclosed Committed Delegation Path profile can authorize based
only on the disclosed ach subset that they verify. They MUST treat
undisclosed prior actors as unavailable and MUST NOT infer adjacency, absence,
or exact chain length from the disclosed subset alone.¶
A malicious or compromised issuing Authorization Server can still attempt to issue a disclosed subset that is inconsistent with the canonical full chain. For the Selectively Disclosed Committed Delegation Path profile, committed proof state and retained exchange records are therefore still important for later verification and audit.¶
A cross-domain Authorization Server that re-issues a local token for the next recipient MUST preserve the relevant chain state unchanged. Any such re-issuance MUST continue to represent the current actor and MUST NOT append the recipient.¶
Accepting Authorization Servers MUST ensure that the authenticated current actor
was an intended recipient of the inbound subject_token. This reduces a class
of deputy and repurposing attacks, though it does not eliminate all
confused-deputy scenarios.¶
Authorization Servers SHOULD enforce a configurable maximum chain depth. A RECOMMENDED default is 10 entries. Relying Parties MAY enforce stricter limits.¶
Actors SHOULD use short-lived keys and/or hardware-protected keys. Deployments that require long-term auditability MUST retain, or make durably discoverable, the historical verification material needed to validate archived step proofs and receiver acknowledgments after key rotation.¶
Readable-chain profiles disclose prior actors to downstream recipients. Deployments that do not require full readable prior-actor authorization SHOULD consider the Commitment-Only Delegation Path profile or the Selective- Disclosure Delegation Path profile.¶
The stable workflow identifier sid correlates all accepted hops within one
workflow instance. Accordingly, sid MUST be opaque and MUST NOT encode actor
identity, profile selection, business semantics, or target meaning.¶
Even in the privacy-preserving profiles, the Authorization Server processing token exchange observes the authenticated current actor and any retained chain-related state. Accordingly, these profiles reduce ordinary-token disclosure but do not hide prior actors from the issuing Authorization Server.¶
Deployments concerned with minimization SHOULD consider:¶
This specification defines the Selectively Disclosed Asserted
Delegation Path profile and the Selectively Disclosed Committed Delegation
Path profile. Both rely on a selective-disclosure encoding for ach.
JWT-based selective disclosure MUST follow SD-JWT {{!RFC9901}}. CWT-based
selective disclosure MUST follow SD-CWT {{!I-D.ietf-spice-sd-cwt}} or its
successor.¶
This specification defines the following actor-chain-specific constraints on such use:¶
ach MUST be an ordered subsequence of the canonical
full chain for that hop;¶
ach MUST include the current actor as its last
element;¶
Authorization Servers supporting these profiles SHOULD retain records keyed by
sid and jti.¶
For committed profiles, the retention period SHOULD be at least the maximum validity period of the longest-lived relevant token plus a deployment- configured audit window, and it SHOULD remain sufficient to validate historical proofs across key rotation.¶
For committed profiles, such records SHOULD include:¶
For selectively disclosed profiles, retained records SHOULD also allow reconstruction of the canonical full chain asserted for the hop and the disclosed subset issued for each recipient.¶
Actors SHOULD also retain local records sufficient to support replay detection, incident investigation, and later proof of participation.¶
This appendix defines the JWT and JWS wire representation for profile-defined ActorID values, step proofs, receiver acknowledgments, and commitment objects.¶
An ActorID is a JSON object with exactly two members:¶
iss: a string containing the issuer identifier; and¶
sub: a string containing the subject identifier.¶
The object MUST be serialized using JCS {{!RFC8785}} whenever it is included in profile-defined proof or commitment inputs.¶
The ach claim, when present in a JWT, is a JSON array of ActorID
objects.¶
The actor_chain_step_proof token request parameter value MUST be a compact JWS
string. The JWS protected header MUST contain typ=ach-step-proof+jwt. The
JWS payload MUST be the UTF-8 encoding of a JCS-serialized JSON object.¶
For the Committed Delegation Path profile, the payload MUST contain:¶
For the Commitment-Only Delegation Path profile, the payload MUST contain:¶
For the Selectively Disclosed Committed Delegation Path profile, the payload MUST contain:¶
The prev member MUST be the base64url encoding of the prior commitment digest
or bootstrap seed bytes. The ach member MUST be a JSON array of
ActorID objects whenever that member is used. The actor member MUST be one
ActorID object whenever that member is used. The target_context member value
MUST be either a JSON string equal to aud or a JSON object that includes
aud and any additional target-selection members used by local policy. Before
any proof input is hashed or signed, target_context MUST be canonicalized
using JCS exactly once as part of the enclosing payload object; verifiers MUST
reproduce the same JCS bytes when validating the proof.¶
The JWS algorithm MUST be an asymmetric algorithm. The none algorithm MUST
NOT be used. The JWS verification key MUST be bound to the same ActorID as the
sender-constrained presentation key for the corresponding actor.¶
A hop_ack, when used in a JWT deployment, MUST be a compact JWS string. The
JWS protected header MUST contain typ=ach-hop-ack+jwt. The JWS payload MUST
be the UTF-8 encoding of a JCS-serialized JSON object with at least these
members:¶
The presenter and recipient members MUST be ActorID objects. The ack
member MUST have the value accepted. The target_context member MUST follow
the same representation rules defined for step proofs. The req_hash member
MUST be the base64url encoding of a digest over the canonical request-context
object. The JWS signer MUST be the recipient, and the verification key MUST be
bound to the same recipient ActorID as any sender-constrained presentation key
used for the protected interaction.¶
The achc claim value MUST be a compact JWS string. The JWS
protected header MUST contain typ=ach-commitment+jwt.¶
The JWS payload MUST be the UTF-8 encoding of a JCS-serialized JSON object with exactly these members:¶
The halg member MUST be either sha-256 or sha-384. The members prev,
step_hash, and curr MUST be the base64url encodings of raw hash bytes.¶
The JWS payload signer MUST be the issuing Authorization Server. A verifier
MUST validate the JWS signature, verify that halg is locally permitted, then
validate that curr equals:¶
Hash_halg(JCS({ctx, sid, achp, halg, prev, step_hash}))
¶
This appendix defines the CWT and COSE wire representation for profile-defined ActorID values, step proofs, receiver acknowledgments, and commitment objects.¶
An ActorID is a deterministic CBOR map with exactly two integer-labeled members:¶
The values for labels 1 and 2 MUST be CBOR text strings.¶
The ach claim, when present in a CWT, is an array of such ActorID
maps.¶
The actor_chain_step_proof token request parameter value MUST be the
base64url encoding of a COSE_Sign1 object {{!RFC9052}}.¶
The COSE_Sign1 payload MUST be a deterministic-CBOR-encoded map. Verifiers MUST
validate the exact ctx value and expected artifact-specific payload shape.¶
For the Committed Delegation Path profile, the payload map MUST contain:¶
For the Commitment-Only Delegation Path profile, the payload map MUST contain:¶
For the Selectively Disclosed Committed Delegation Path profile, the payload map MUST contain:¶
The value of 3 MUST be a byte string containing the prior commitment digest or
bootstrap seed bytes. The value of 5 MUST be an array of ActorID maps
whenever that member is used. The value of 6 MUST be one ActorID map
whenever that member is used. The value of 4 MUST be either a CBOR text
string equal to aud or a CBOR map that includes aud and any additional
target-selection members used by local policy. Before any proof input is
hashed or signed, target_context MUST be canonicalized using deterministic
CBOR exactly once as part of the enclosing payload map; verifiers MUST
reproduce the same bytes when validating the proof.¶
The COSE algorithm MUST be asymmetric. Unprotected unauthenticated payloads MUST NOT be used. The COSE verification key MUST be bound to the same ActorID as the sender-constrained presentation key for the corresponding actor.¶
A hop_ack, when used in a CWT deployment, MUST be the base64url encoding of a
COSE_Sign1 object {{!RFC9052}}. The COSE_Sign1 payload MUST be a
deterministic-CBOR-encoded map containing at least:¶
1: ctx;¶
2: sid;¶
3: achp;¶
4: jti;¶
5: target_context;¶
6: req_hash;¶
7: presenter;¶
8: recipient; and¶
9: ack.¶
The values of 7 and 8 MUST be ActorID maps. The value of 9 MUST be the
text string accepted. The value of 5 MUST follow the same representation
rules defined for step proofs. The value of 6 MUST be a byte string
containing a digest over the canonical request-context object. The COSE signer
MUST be the recipient, and the verification key MUST be bound to the same
recipient ActorID as any sender-constrained presentation key used for the
protected interaction.¶
The achc claim value MUST be a byte string containing a
COSE_Sign1 object.¶
The COSE_Sign1 payload MUST be a deterministic-CBOR-encoded map with exactly these members:¶
The value of 4 MUST be the text string sha-256 or sha-384. The values of
5, 6, and 7 MUST be byte strings containing raw hash bytes.¶
The payload signer MUST be the issuing Authorization Server. A verifier MUST
validate the COSE signature, verify that halg is locally permitted, then
validate that curr equals:¶
Hash_halg(Deterministic-CBOR({1:ctx, 2:sid, 3:achp, 4:halg, 5:prev, 6:step_hash}))
¶
Assume A, B, and C are governed by AS1.¶
A requests a token for B under the Asserted Delegation Path profile.¶
AS1 issues T_A with ach=[A] and aud=B.¶
A calls B and presents T_A.¶
B validates T_A, verifies continuity, and exchanges T_A at AS1 for
a token to C.¶
AS1 authenticates B, verifies that B was an intended recipient of the
inbound token, appends B, and issues T_B with ach=[A,B] and
aud=C.¶
B validates that the returned chain is exactly the prior chain plus B.¶
B presents T_B to C.¶
C validates the token and authorizes based on the readable chain [A,B].¶
Assume A, B, and C use the Selectively Disclosed Asserted Delegation
Path profile and accept the issuing AS as the trust anchor for disclosure
policy.¶
A requests a token for B under the Selectively Disclosed Asserted
Delegation Path profile.¶
AS1 issues T_A with a selectively disclosable ach and the
disclosure artifacts intended for B.¶
A calls B and presents T_A plus the associated disclosure artifacts.¶
B validates the token, verifies the selective-disclosure proof, and uses
only the disclosed chain for authorization.¶
B exchanges T_A at AS1 for a token to C.¶
AS1 reconstructs the canonical full chain for the hop, applies disclosure
policy for C, and issues T_B with a selectively disclosable
ach.¶
B presents T_B and the associated disclosure artifacts to C.¶
C validates the token, verifies the selective-disclosure proof, confirms
that B is the last disclosed actor, and authorizes based only on the
disclosed chain.¶
Assume A and B are governed by AS1, while C is governed by AS2.¶
A obtains bootstrap context from AS1, signs chain_sig_A, and receives
T_A with ach=[A] and achc.¶
A calls B with T_A.¶
B validates T_A, constructs [A,B], signs chain_sig_B, and exchanges
T_A at AS1 for a token to C.¶
AS1 verifies chain_sig_B, updates the commitment, and issues T_B with
ach=[A,B] and aud=C.¶
C does not trust AS1 directly, B performs a second exchange at
AS2.¶
AS2 preserves achp, sid, ach=[A,B], and
achc, and issues a local token trusted by C that still
represents B.¶
C validates the local token, sees the readable chain [A,B], and
authorizes accordingly.¶
Assume A, B, and C use the Commitment-Only Delegation Path profile.¶
A obtains bootstrap context, signs chain_sig_A, and receives T_A with
achc, but no readable ach.¶
A calls B with T_A.¶
B validates T_A, verifies that A is the presenter, signs
chain_sig_B, and exchanges T_A at its home AS to obtain T_B for C.¶
T_B contains the updated achc, but no readable chain.¶
B presents T_B to C.¶
C validates the token and authorizes based on the verified presenting actor
B and local policy. C MUST NOT infer prior-actor identity or count from
the commitment alone.¶
Assume A, B, and C use the Selectively Disclosed Committed Delegation Path profile.¶
A obtains bootstrap context, signs chain_sig_A, and receives T_A with
a selectively disclosable ach, achc, and the
disclosure artifacts intended for B.¶
A calls B and presents T_A plus the associated disclosure artifacts.¶
B validates the token, verifies the selective-disclosure proof, and uses
only the disclosed chain for authorization.¶
B signs chain_sig_B and exchanges T_A at its home AS to obtain T_B
for C.¶
AS1 reconstructs the canonical full chain for the hop, applies disclosure
policy for C, and issues T_B with a selectively disclosable
ach and updated achc.¶
B presents T_B and the associated disclosure artifacts to C.¶
C validates the token, verifies the selective-disclosure proof, confirms
that B is the last disclosed actor, and authorizes based only on the
disclosed chain.¶
This specification defines special handling for the first actor in order to initialize chain state. It does not define corresponding terminal-hop semantics for a final recipient that performs work locally and does not extend the chain further.¶
Future work MAY define:¶
This specification deliberately does not append a recipient merely because that
recipient was contacted. It also defines an OPTIONAL hop_ack extension that
lets a recipient prove accepted responsibility for a hop.¶
However, this specification still does not by itself prevent a malicious actor from sending a validly issued token to an unsolicited victim service. Future work MAY define stronger receiver-driven protections, including:¶
This document now defines baseline Selectively Disclosed Asserted Delegation Path and Selectively Disclosed Committed Delegation Path profiles. Future work MAY define stronger selective-disclosure mechanisms, including recipient-bound disclosure artifacts, zero-knowledge proofs over the canonical full chain, or richer verifier-assisted consistency checks against retained proof state.¶
This specification models a linear workflow. A future branching profile will need to distinguish multiple valid successors from the same prior committed state, rather than treating every additional successor as a replay or replay- like state collision.¶
One possible approach is to introduce explicit branch identifiers and a tree- structured commitment model in which parallel successors become sibling nodes under a common root. Such a profile could support inclusion proofs, partial disclosure, and more efficient branch verification than the linear base model, while preserving a stable workflow root.¶
Those semantics are intentionally out of scope for this base specification.¶
Committed profiles derive much of their value from later verification of step proofs and exchange records. Future work MAY standardize interoperable evidence discovery, retention, and verification-material publication.¶
Any such specification should define, at minimum, evidence object typing,
authorization and privacy controls for cross-domain retrieval, stable lookup
keys such as jti or sid, error handling, and retention expectations.¶
This document complements {{!RFC8693}} by defining chain-aware token-exchange profiles. It also aligns with the broader SPICE architecture and companion provenance work while remaining useful on its own.¶
This specification defines five profiles instead of one deployment mode so that implementations can choose among full readable chain-based authorization, trust-first partial disclosure, stronger committed-state accountability, recipient-specific committed partial disclosure, and reduced ordinary-token disclosure without changing the core progression model.¶
The base specification remains linear. Branching, richer selective disclosure, and evidence-discovery protocols remain future work because they require additional identifiers, validation rules, and interoperability work.¶
An implementation is conformant only if it correctly implements the profile it claims to support and all common requirements on which that profile depends.¶
At a minimum, implementers should verify that they have addressed the following:¶
| Requirement | Draft section reference | Implemented [ ] |
|---|---|---|
Stable generation and preservation of sid, without relying on UUIDv4 unless local generation is augmented to satisfy the entropy requirement |
Workflow Identifier (sid) |
[ ] |
| Sender-constrained validation for every inbound token | Sender Constraint | [ ] |
Exact ActorID equality over (iss, sub) |
Actor Identity Representation | [ ] |
| Canonical serialization for all proof and commitment inputs | Canonicalization; Target Context Requirements; Appendix G | [ ] |
| Intended-recipient validation during token exchange | Intended Recipient Validation | [ ] |
| Replay and freshness handling for tokens and step proofs | Replay and Freshness | [ ] |
| Exact append-only checks for readable-chain profiles | Asserted Delegation Path Profile; Committed Delegation Path Profile | [ ] |
| Exact commitment verification for committed profiles | Commitment Function; Committed Delegation Path Profile | [ ] |
| Proof-key binding between ActorID, proof signer, and sender-constrained presentation key | Actor and Recipient Proof Keys | [ ] |
| Non-broadening Refresh-Exchange processing, if supported | Refresh-Exchange | [ ] |
Policy for when hop_ack is optional or required |
Optional Receiver Acknowledgment Extension | [ ] |
| Privacy-preserving handling of logs and error messages | Error Handling; Privacy Considerations | [ ] |
The following illustrative vectors are intended to reduce interoperability
failures caused by divergent canonicalization. They are not exhaustive, but
they provide concrete byte-for-byte examples for common ActorID and
target_context inputs.¶
Input object:¶
{"iss":"https://as.example","sub":"svc:planner"}
¶
JCS serialization (UTF-8 bytes rendered as hex):¶
7b22697373223a2268747470733a2f2f61732e6578616d706c65222c22737562223a227376633a706c616e6e6572227d¶
SHA-256 over those bytes:¶
7a14a23707a3a723fd6437a4a0037cc974150e2d1b63f4d64c6022196a57b69f¶
target_context Example
Input object:¶
{"aud":"https://api.example","method":"invoke","resource":"calendar.read"}
¶
JCS serialization (UTF-8 bytes rendered as hex):¶
7b22617564223a2268747470733a2f2f6170692e6578616d706c65222c226d6574686f64223a22696e766f6b65222c227265736f75726365223a2263616c656e6461722e72656164227d¶
SHA-256 over those bytes:¶
911427869c76f397e096279057dd1396fe2eda1ac9e313b357d9cecc44aa811e¶
Input map:¶
{1: "https://as.example", 2: "svc:planner"}
¶
Deterministic-CBOR bytes rendered as hex:¶
a2017268747470733a2f2f61732e6578616d706c65026b7376633a706c616e6e6572¶
SHA-256 over those bytes:¶
67b0bc687e402cb579c2d27e45f1b6ad82e4c0ed283e4a05d62cae0fe87d59c1¶
target_context Example
Input map:¶
{"aud": "https://api.example", "method": "invoke", "resource": "calendar.read"}
¶
Deterministic-CBOR bytes rendered as hex:¶
a3636175647368747470733a2f2f6170692e6578616d706c65666d6574686f6466696e766f6b65687265736f757263656d63616c656e6461722e72656164¶
SHA-256 over those bytes:¶
17b5edcf9dac7d4cec6bb0b4da8cb98ede4ebc77c7f2b1f2a1371b7a3730ec4b¶
This appendix shows one abbreviated decoded JWT payload together with one
abbreviated decoded achc JWS payload. The values are
illustrative and signatures are omitted for readability.¶
{
"iss": "https://as.example",
"sub": "svc:planner",
"aud": "https://api.example",
"jti": "2b2b6f0d3f0f4d7a8c4c3c4f9e9b1a10",
"sid": "6cb5f0c14ab84718a69d96d31d95f3c4",
"achp": "committed-delegation-path",
"ach": [
{"iss": "https://as.example", "sub": "svc:orchestrator"},
{"iss": "https://as.example", "sub": "svc:planner"}
],
"achc": "<compact JWS string>"
}
¶
achc JWS Example
Protected header:¶
{"alg":"ES256","typ":"ach-commitment+jwt"}
¶
Payload:¶
{
"ctx": "actor-chain-commitment-v1",
"sid": "6cb5f0c14ab84718a69d96d31d95f3c4",
"achp": "committed-delegation-path",
"halg": "sha-256",
"prev": "SGlnaGx5SWxsdXN0cmF0aXZlUHJldkRpZ2VzdA",
"step_hash": "z7mq8c0u9b2C0X5Q2m4Y1q3r7n6s5t4u3v2w1x0y9z8",
"curr": "Vb8mR6b2vS5h6S8Y6j5X4r3w2q1p0n9m8l7k6j5h4g3"
}
¶
On the wire, the achc claim carries the usual compact-JWS
form:¶
BASE64URL(protected-header) "." BASE64URL(payload) "." BASE64URL(signature)¶
This specification does not create a new hash-algorithm registry.
achc uses hash algorithm names from the IANA Named
Information Hash Algorithm Registry {{IANA.Hash.Algorithms}}, subject to the
algorithm restrictions defined in this document.¶
This document requests registration of the following claims in the "JSON Web Token Claims" registry established by {{!RFC7519}}:¶
| Claim Name | Claim Description | Change Controller | Specification Document(s) |
|---|---|---|---|
ach
|
Ordered array of actor identity entries representing the delegation path. | IETF | [this document] |
achc
|
Committed chain state binding accepted hop progression for the active profile. | IETF | [this document] |
achp
|
Actor-chain profile identifier for the issued token. | IETF | [this document] |
This document requests registration of the following claims in the "CBOR Web Token (CWT) Claims" registry established by {{!RFC8392}}:¶
| Claim Name | Claim Description | CBOR Key | Claim Type | Change Controller | Specification Document(s) |
|---|---|---|---|---|---|
ach
|
Ordered array of actor identity entries representing the delegation path. | TBD | array | IETF | [this document] |
achc
|
Committed chain state binding accepted hop progression for the active profile. | TBD | bstr | IETF | [this document] |
achp
|
Actor-chain profile identifier for the issued token. | TBD | tstr | IETF | [this document] |
This document requests registration of the following media types in the "Media Types" registry established by {{!RFC6838}}:¶
| Media Type Name | Media Subtype Name | Required Parameters | Optional Parameters | Encoding Considerations | Security Considerations | Interoperability Considerations | Published Specification | Applications that use this media type | Fragment Identifier Considerations | Additional Information | Contact | Intended Usage | Restrictions on Usage | Author | Change Controller |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
application
|
ach-step-proof+jwt
|
N/A | N/A | binary | see [this document] | N/A | [this document] | OAuth 2.0 Token Exchange actor-chain step proofs | N/A | Magic Number(s): N/A; File Extension(s): N/A; Macintosh File Type Code(s): N/A | IETF | COMMON | N/A | IETF | IETF |
application
|
ach-commitment+jwt
|
N/A | N/A | binary | see [this document] | N/A | [this document] | OAuth 2.0 Token Exchange actor-chain commitments | N/A | Magic Number(s): N/A; File Extension(s): N/A; Macintosh File Type Code(s): N/A | IETF | COMMON | N/A | IETF | IETF |
application
|
ach-hop-ack+jwt
|
N/A | N/A | binary | see [this document] | N/A | [this document] | OAuth 2.0 Token Exchange actor-chain receiver acknowledgments | N/A | Magic Number(s): N/A; File Extension(s): N/A; Macintosh File Type Code(s): N/A | IETF | COMMON | N/A | IETF | IETF |
This document requests registration of the following parameter names in the relevant OAuth parameter registry:¶
| Parameter Name | Parameter Usage Location | Change Controller | Specification Document(s) |
|---|---|---|---|
actor_chain_profile
|
OAuth token endpoint request | IETF | [this document] |
actor_chain_step_proof
|
OAuth token endpoint request | IETF | [this document] |
actor_chain_refresh
|
OAuth token endpoint request | IETF | [this document] |