| Internet-Draft | OAuth Mission Signals | August 2026 |
| McGuinness | Expires 22 February 2027 | [Page] |
The Mission Status and Lifecycle profile names event-driven propagation (Mission state changes reaching consumers over a Shared Signals stream) as one way to bound revocation latency, but leaves the channel itself unspecified. This document specifies it: a profile of the OpenID Shared Signals Framework in which a Mission Issuer emits a Mission lifecycle-change Security Event Token when it commits a state transition, delivered by push or poll, so a consumer learns of a revocation, expiry, or other transition promptly without polling Mission Status per Mission. It is optional and builds on Mission-Bound Authorization for OAuth 2.0, the issuance profile; a deployment that does not adopt it is unaffected.¶
This note is to be removed before publishing as an RFC.¶
The latest revision of this draft can be found at https://mcguinness.github.io/mission-bound-authorization/draft-mcguinness-oauth-mission-signals.html. Status information for this document may be found at https://datatracker.ietf.org/doc/draft-mcguinness-oauth-mission-signals/.¶
Source for this draft and an issue tracker can be found at https://github.com/mcguinness/mission-bound-authorization.¶
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 22 February 2027.¶
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.¶
This document is a satellite of the Mission Status and Lifecycle profile [I-D.draft-mcguinness-oauth-mission-status], the lifecycle suite's root document, adding the suite's push channel.¶
Mission-Bound Authorization for OAuth 2.0 [I-D.draft-mcguinness-oauth-mission] (the "issuance profile") gates derivation on Mission state and bounds outstanding self-contained tokens by their lifetime. The Mission Status and Lifecycle profile [I-D.draft-mcguinness-oauth-mission-status] adds surfaces for observing and changing state, and points to event-driven propagation for deployments that need Mission state changes to reach consumers promptly, without each consumer polling Mission Status per Mission. It does not define the channel.¶
This document defines the channel. When a Mission Issuer commits a
Mission lifecycle transition (a revocation, expiry, suspension,
completion, or the approval event that activates a Mission), it emits
a Mission lifecycle-change Security Event Token (Section 4)
over a profile of the OpenID Shared Signals Framework [OIDC-SSF]: pushed
to a consumer's receiver [RFC8935] or made available for the consumer
to poll [RFC8936], as a Security Event Token (SET) [RFC8417]. A
consumer that receives a non-active transition stops honoring the
Mission (Section 6). A deployment offers this channel by
publishing the event stream (Section 3); consumers discover it
from mission_event_stream_endpoint (Section 10).¶
This document is optional. Push delivery is a propagation-latency
acceleration over correctly sized pull: a consumer that polls the
Status profile's surfaces within the deployment's published staleness
bound, and fails safe on the Mission's expires_at, already meets
the suite's revocation-propagation model without this channel
([I-D.draft-mcguinness-oauth-mission-status]). This channel is
never the sole state source, and a missed event reads as stale state,
never as still active. Deploy this profile where polling per
Mission does not scale or the staleness bound must shrink below a
practical polling interval. The Mission Issuer is an SSF transmitter
and the consumer an SSF receiver in the framework's own vocabulary
([OIDC-SSF]), so a deployment already operating a Shared Signals /
CAEP stream adds this event type to infrastructure it runs today.¶
This document defines no new Mission semantics: the
Mission, its lifecycle states, and the mission claim are defined in
[I-D.draft-mcguinness-oauth-mission]. The states this event reports
are the issuance profile's lifecycle state space
[I-D.draft-mcguinness-oauth-mission] as extended by whichever
lifecycle profiles the deployment runs
([I-D.draft-mcguinness-oauth-mission-status] and any companion
profile it adopts). A deployment that does not stand up an event stream
uses the polling surfaces of the Status profile instead and is
unaffected by this document.¶
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 uses the terms defined in the issuance profile
[I-D.draft-mcguinness-oauth-mission] and the Status profile
[I-D.draft-mcguinness-oauth-mission-status], in particular Mission,
Mission Issuer (the Mission issuer: in this document's OAuth binding
the Authorization Server; a standalone Mission Issuer, the Mission
Authority Server [I-D.draft-mcguinness-mission-authority-server],
transmits these events with the same semantics; the AAuth Person
Server exposes lifecycle state for its native missions through its
own management surface rather than these events
[I-D.draft-mcguinness-mission-aauth]), mission_id,
and the Mission lifecycle states. It additionally uses Security Event
Token (SET) [RFC8417] and the Shared Signals Framework (SSF)
[OIDC-SSF] transmitter, receiver, and stream terminology.¶
A consumer here is an SSF receiver that relies on Mission state, typically a Resource Server or an Authorization Server acting on a Mission it did not issue.¶
All JSON shown in this document is non-normative and illustrative; the member definitions in the surrounding text are authoritative. JWT and SET examples are shown as decoded JSON; on the wire the JWS Compact Serialization [RFC7515] applies.¶
This section is OPTIONAL. A Mission Issuer that does not emit lifecycle events, and a consumer that does not receive them, are unaffected; they rely on token lifetime and the polling surfaces of [I-D.draft-mcguinness-oauth-mission-status].¶
A Mission Issuer that emits lifecycle events publishes a Shared Signals
Framework [OIDC-SSF] Transmitter Configuration Metadata document and
advertises its URL in Authorization Server metadata (Section 10)
as mission_event_stream_endpoint. From that document a consumer
discovers the SSF stream configuration, stream status, add-subject, and
poll endpoints, and the supported delivery methods, per [OIDC-SSF];
this document profiles only the event carried, its protection, and the
consumer's duty on receipt. The stream MUST be served over TLS 1.2 or
later (TLS 1.3 RECOMMENDED), following the recommendations of
[RFC9325].¶
Delivery uses the Shared Signals Framework delivery methods,
advertised in the SSF Transmitter Configuration Metadata's
delivery_methods_supported [OIDC-SSF]:¶
push-based delivery, SET delivery method urn:ietf:rfc:8935
[RFC8935]: the Mission Issuer pushes SETs [RFC8417] to a
consumer's registered receiver endpoint.¶
poll-based delivery, SET delivery method urn:ietf:rfc:8936
[RFC8936]: the Mission Issuer makes SETs available for the consumer
to poll.¶
A Mission Issuer that emits events MUST support at least one method.
A consumer discovers the supported methods from the SSF Transmitter
Configuration Metadata rather than from a separate Authorization
Server metadata member. The consumer's stream configuration declares,
in its delivery object, the method it uses. The Mission Issuer MUST
respect the declared method. It MUST NOT silently fall back to a
less-timely method.¶
A bulk lifecycle sweep at the management endpoint ([I-D.draft-mcguinness-oauth-mission-management]) emits one SET per member Mission; a transmitter should expect, and pace, the resulting burst.¶
Streams are configured per [OIDC-SSF]. A receiver adds a Mission to its stream with the SSF add-subject operation, using the Mission subject identifier (Section 4).¶
Add-subject authorization: the transmitter MUST accept an add-subject only for a Mission the receiver is authorized for under deployment policy, for example a receiver whose audience is an audience of the Mission's authority.¶
Harness as receiver: the executing side is an intended receiver class. A deployment SHOULD authorize the harness executing a Mission as a receiver for it, since the harness profile's event-driven state cache ([I-D.draft-mcguinness-mission-harness]) is a consumer of this stream.¶
Default stream: absent explicit subjects, a deployment MAY provision an authorization-derived default stream, delivering the events for the Missions a receiver is authorized for. A deployment that provisions such a default stream MUST document its scope.¶
A Mission Issuer emits a mission.lifecycle-change event, carried in
the Security Event Token shape of the Shared Signals Framework
[OIDC-SSF] and informed by the Continuous Access Evaluation Profile
[OIDC-CAEP], when it commits any Mission lifecycle transition or the
approval event that activates a Mission. The event type URI, defined in
this document and described in Section 14, is:¶
https://schemas.karlmcguinness.com/mission/lifecycle-change¶
This URI is the registered event-type identifier; mission.lifecycle-change
is the short name this document uses for it in prose.¶
The SET subject is the Mission, identified by a sub_id Subject
Identifier [RFC9493] of format opaque whose id is the canonical
mission_id ([I-D.draft-mcguinness-oauth-mission]), carried per Shared
Signals Framework [OIDC-SSF] conventions. A receiver adds a Mission to
its stream using this same subject identifier (Section 3).¶
The event is carried as the event-type-keyed value of the events
claim of a SET [RFC8417], alongside the SET's own iss, aud,
iat, jti, and sub_id. Its claims are:¶
mission (object, required):the Mission identity, the same identity members as the mission
object of [I-D.draft-mcguinness-oauth-mission-status], carrying
id (the canonical Mission Identifier) and issuer (the Mission
Issuer's issuer URL).¶
state (string, required):the new lifecycle state. The value space is the Mission lifecycle
state space defined by the issuance profile
[I-D.draft-mcguinness-oauth-mission] (active, revoked,
expired), as extended by whichever lifecycle profiles a deployment
also runs: suspended and completed
([I-D.draft-mcguinness-oauth-mission-status]), superseded
([I-D.draft-mcguinness-oauth-mission-expansion]), and cascaded
([I-D.draft-mcguinness-oauth-mission-child-delegation]). A Mission
Issuer that runs a profile defining an additional state emits that
state here on the corresponding transition (for example,
superseded when a predecessor is superseded by an expansion
successor).¶
prior_state (string, conditional):the state immediately before the transition, drawn from the same
value space. REQUIRED on a transition emission; absent only on the
approval-event emission, where there is no prior state. A supersede
transition emits prior_state of active and state of
superseded.¶
version (integer, required):the Mission's state version at this event's commit, letting a consumer order events and detect gaps. The counter is the Status profile's state version, defined and served there ([I-D.draft-mcguinness-oauth-mission-status]); this member carries its value at the emission.¶
committed_at (string, required):an RFC 3339 [RFC3339] date-time at which the Mission Issuer committed the transition.¶
expires_at (string, required):an RFC 3339 [RFC3339] date-time, the Mission's own expiry, the
same expires_at the Status profile reports
([I-D.draft-mcguinness-oauth-mission-status]), so an event-only
consumer can fail safe on expiry without a Status fetch.¶
suspend_until, on_expiry (conditional):present only on a transition to suspended under a deadline, with
the values and meaning of the Status profile
([I-D.draft-mcguinness-oauth-mission-status]): the RFC 3339
[RFC3339] deadline and the transition (resume or revoke) the
Mission Issuer applies when it passes. A suspend-metadata update, a
change to suspend_until or on_expiry on an already-suspended
Mission, is emitted as a mission.lifecycle-change with state and
prior_state both suspended and the updated values, incrementing
version like any other committed change.¶
tenant (string, optional):the Mission's deployment tenant. This profile defines no tenant model and does not use it; it is present so the event type is shared, unchanged, with multi-tenant and cross-substrate deployments that do.¶
reason (string, optional):a human-readable reason, for audit.¶
successor (string, optional):the successor mission_id. Present only when state is
superseded, giving the successor that replaced the Mission
([I-D.draft-mcguinness-oauth-mission-expansion]).¶
containment_version (integer, conditional):the Mission's containment overlay version at this event's commit.
REQUIRED when the deployment runs the containment profile
([I-D.draft-mcguinness-oauth-mission-containment]), which defines
the overlay and requires this member on every
mission.lifecycle-change event. It composes with authority_changed
below under one rule: every effective-authority narrowing, containment
included, sets authority_changed true. containment_version is
containment's own precise generation counter, tracking containment's
narrowing sequence for a containment-aware consumer; it does not by
itself substitute for authority_changed on a transition where
state is unchanged.¶
authority_hash (string, optional):the authority_hash the issuance profile commits at approval
([I-D.draft-mcguinness-oauth-mission]). Present at the containment
profile's option, as a reference to the Authority Set the current
containment overlay narrows
([I-D.draft-mcguinness-oauth-mission-containment]).¶
authority_changed (boolean, conditional, default false):true when the committed transition changes the Mission's effective
authority without changing state. The discriminator is
deliberately generic: it carries no detail of what changed, and in
particular no entry digest is disclosed on this event. REQUIRED
with value true on any mission.lifecycle-change event whose commit
narrows effective authority without changing state, whichever
overlay narrowed it: an entry discharge
([I-D.draft-mcguinness-oauth-mission-status]) is the current case,
containment ([I-D.draft-mcguinness-oauth-mission-containment]) is
another, and a future issuer-held narrowing overlay is expected to
set it the same way; delivery of such an event is itself subject to
the gate of Section 7. OPTIONAL, and absent or
false, on any other transition, meaning it does not narrow effective
authority beyond state.¶
Following the issuance profile's forward-compatibility rule, an event
consumer MUST treat every state value other than active as
non-deriving, including a value it does not recognize.¶
The expired event MAY be emitted lazily. Because expiry is driven by
the clock reaching the Mission's expires_at rather than an explicit
request, a Mission Issuer emits the expired event at or after the
Mission's expires_at, when it observes the transition. A consumer
does not depend on prompt emission: it already fails safe on the
Mission's expires_at carried with cached Mission status
([I-D.draft-mcguinness-oauth-mission-status]).¶
Example SET (decoded), for a revocation:¶
{
"iss": "https://as.example.com",
"aud": "https://erp.example.com",
"iat": 1793609600,
"jti": "set_9Kp2vN7sR1tY8mZ3qX5b",
"sub_id": {
"format": "opaque",
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-"
},
"events": {
"https://schemas.karlmcguinness.com/mission/lifecycle-change": {
"mission": {
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-",
"issuer": "https://as.example.com"
},
"prior_state": "active",
"state": "revoked",
"version": 2,
"committed_at": "2026-11-02T09:06:40Z",
"expires_at": "2026-12-31T23:59:59Z",
"reason": "Quarterly reconcile completed early"
}
}
}
¶
Example SET (decoded), for the approval event that activates the
Mission (version 1, no prior_state):¶
{
"iss": "https://as.example.com",
"aud": "https://erp.example.com",
"iat": 1793602800,
"jti": "set_3Fw7bJ4nQ9xD2kM6vL1c",
"sub_id": {
"format": "opaque",
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-"
},
"events": {
"https://schemas.karlmcguinness.com/mission/lifecycle-change": {
"mission": {
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-",
"issuer": "https://as.example.com"
},
"state": "active",
"version": 1,
"committed_at": "2026-11-02T07:00:00Z",
"expires_at": "2026-12-31T23:59:59Z"
}
}
}
¶
Example SET (decoded), for a supersession, carrying successor:¶
{
"iss": "https://as.example.com",
"aud": "https://erp.example.com",
"iat": 1793612400,
"jti": "set_6Tn4rW8pB3zK7qC2mV5j",
"sub_id": {
"format": "opaque",
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-"
},
"events": {
"https://schemas.karlmcguinness.com/mission/lifecycle-change": {
"mission": {
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-",
"issuer": "https://as.example.com"
},
"prior_state": "active",
"state": "superseded",
"version": 2,
"committed_at": "2026-11-02T09:40:00Z",
"expires_at": "2026-12-31T23:59:59Z",
"successor": "msn_2Yt7Qv9LqMv4z7sA2bN1k0YpEdHc9RfX"
}
}
}
¶
Each SET [RFC8417] is a JWS Compact Serialization [RFC7515] signed
with a Mission Issuer key resolvable in the issuer's jwks_uri, with a
typ of secevent+jwt and a kid identifying the signing key. The
SET aud MUST be the receiving consumer's registered audience
identifier.¶
On receipt, a consumer applies the following checks to each SET:¶
Signature: the consumer MUST verify the signature against the Mission Issuer's published keys.¶
Issuer: the consumer MUST refuse a SET whose iss does not match
the Mission Issuer it registered with. Because this profile is
single-issuer, the SET iss equals the event's mission.issuer;
a consumer MAY treat a mismatch as a verification failure.
(mission.issuer is carried in the event for cross-substrate
deployments where the two can differ.)¶
Audience: the consumer MUST refuse a SET whose aud is not its
own.¶
Redelivery: the consumer MUST NOT treat redelivery of the same SET
(same jti) as an error, because SSF delivery is at-least-once.¶
At the delivery layer a consumer acknowledges a duplicate jti
normally, per the SSF delivery method in use, without reprocessing it;
at the application layer it applies each event idempotently by
version (Section 6), so a redelivered SET regresses
nothing. Tracking recently seen jti values for a deployment-defined
window measured from the SET's iat lets a consumer recognize a
duplicate; this is duplicate suppression, not a hard reject.¶
Following [RFC8417], this profile does not require an exp on the
SET; a consumer MAY reject a SET whose iat is implausibly old.¶
On receiving and verifying (Section 5) a
mission.lifecycle-change event, a consumer MUST:¶
Stop honoring the affected Mission for any new consequential use when
state is anything other than active: refuse to act on, and refuse
to derive further authority from, tokens bound to that Mission
([I-D.draft-mcguinness-oauth-mission]), to the extent of the
consumer's enforcement role.¶
Resume honoring the Mission on a verified event whose state is
active and whose version is greater than the last applied for
that mission.id, subject to the same gating the issuance profile
applies. This covers a reversible transition (for example a
suspended Mission that is later resumed to active).¶
Apply the transition idempotently: a repeated or out-of-order event
carrying a version not greater than the last applied for that
mission.id MUST NOT regress the consumer's view of the state.¶
Establish initial state through the Mission Status operation
([I-D.draft-mcguinness-oauth-mission-status]) before relying on the
stream for a Mission: on first subscription, and whenever the earliest
event it holds for a mission.id carries a version greater than 1
(so it never received the activating event that anchors the sequence).
The stream carries transitions, not a snapshot; once bootstrapped, a
consumer MAY rely on events alone, each carrying the state members
(Section 4) it needs to act without a further fetch.¶
Re-establish current state through the Mission Status operation
([I-D.draft-mcguinness-oauth-mission-status]) on a detected
version gap (a received version more than one greater than the
last applied for that mission.id), rather than rely on the cached
state that spans the gap. The Status response's version member
re-seats gap detection: the consumer sets its last-applied version
to the returned value and measures the next gap from it.¶
Rematerialize its effective authority view for the Mission through
the Mission Status operation
([I-D.draft-mcguinness-oauth-mission-status]) before further
consequential reliance when it is containment-aware
([I-D.draft-mcguinness-oauth-mission-containment]) and the event
carries a containment_version greater than the containment_version
of the authority view it last materialized for that mission.id,
even when state equals prior_state. Under this document's
discriminator rule such a transition also carries authority_changed
true (Section 4), so a consumer that applies the rule below
already rematerializes on it; a containment-aware consumer tracking
containment_version directly reaches the same result independently.¶
Rematerialize its effective authority view for the Mission through
the Mission Status operation
([I-D.draft-mcguinness-oauth-mission-status]) before further
consequential reliance when an in-order event carries
authority_changed true, even when state equals prior_state and
no version gap exists. This rule binds every consumer, not only one
that is containment-aware: every transition that narrows effective
authority without changing state, containment included, sets
authority_changed (Section 4), so a consumer that reads
only authority_changed rematerializes on any of them. The
version-gap rule stays the fallback for the coarse case, a missed
event.¶
Acknowledge the event per the SSF delivery method in use.¶
A consumer MUST NOT treat the event as authority to change Mission state at the Mission Issuer; the Mission Issuer is authoritative ([I-D.draft-mcguinness-oauth-mission-status]). A consumer that believes the reported state is wrong re-checks through Mission Status rather than inventing a state.¶
A consumer MUST ignore event members it does not understand. It MUST NOT reject an event solely for a missing OPTIONAL member (notably
tenant). A consumer matches the event type by the exact URI the
Mission Issuer's Transmitter Configuration Metadata advertises, so
the event-type namespace can change without a change to this
profile's semantics. After allocation, the URI is expected to
migrate to an IETF- or foundation-controlled namespace (a
urn:ietf:params URN or an OpenID Foundation schema URI) as a
wire-identifier change landing with dual-recognition compatibility;
until such a namespace is allocated and a change controller exists,
the author-controlled URI remains the deployable identifier.¶
A consumer anchors freshness to stream liveness, not to per-Mission age. The Shared Signals Framework [OIDC-SSF] provides a stream verification event. A Mission Issuer MAY additionally emit a periodic stream-status heartbeat. A stream is verified live when the consumer has received a verified verification or heartbeat event within the stream's heartbeat interval; such an event attests that any committed transition for the stream's subjects would have been delivered. On a stream verified live, silence is freshness-preserving: the consumer MAY continue to rely on cached Mission state for those subjects up to the next heartbeat interval, without polling Mission Status per Mission.¶
The staleness fallback applies to a stream that is not verified live.
A consumer MUST treat cached Mission state as stale once the stream
has gone without a verified verification or heartbeat event for longer
than the Mission Issuer's advertised mission_max_stale_seconds
([I-D.draft-mcguinness-oauth-mission-status]). Once its cached state
is stale, the consumer MUST re-establish current state before further
reliance. The Mission Status operation is the RECOMMENDED fallback
surface. A consumer that cannot verify its stream, or that was down
and may have missed events, applies the same rule rather than
continuing on possibly stale state.¶
authority_changed true (Section 4) is a breaking change
for a consumer built before this member existed: such a consumer
ignores the unknown member, accepts an in-order active-to-active
version increment, and keeps a stale Authority Set, exactly the
failure authority_changed exists to prevent. This document
therefore gates delivery of such an event on a declared consumer
capability rather than assuming every receiver understands the
member.¶
A receiver declares support by adding authority_changed to
mission_capabilities_supported, a new receiver-supplied member of
the Shared Signals Framework [OIDC-SSF] Stream Configuration
object, alongside the object's events_requested and delivery
members (Section 3): a JSON array of strings. This document
defines one value, authority_changed, naming support for the
rematerialization rule of Section 6. The mission_
prefix keeps this document's extension collision-safe on an object
it does not own; the member rides an object the Shared Signals
Framework already defines and needs no IANA action.¶
The gate binds exactly the events whose authority change is carried
only by the new member: a Mission Issuer MUST NOT deliver a
mission.lifecycle-change event whose effective-authority change is
represented by authority_changed alone (a discharge commit,
[I-D.draft-mcguinness-oauth-mission-status]) to a stream whose
consumer has not declared authority_changed in
mission_capabilities_supported. An event whose narrowing is also
represented by containment_version follows the containment
profile's existing delivery and consumer rules unchanged
([I-D.draft-mcguinness-oauth-mission-containment]); the member is
still set on it, and a declared consumer applies one rule to both.
Where Signals is used, a Mission Issuer MUST emit
authority_changed true on the mission.lifecycle-change event a
discharge commit produces.¶
This document is the event-driven mechanism the Status profile's
revocation-propagation guidance points to
([I-D.draft-mcguinness-oauth-mission-status]): a Mission Issuer that
offers it emits mission.lifecycle-change events (Section 4)
over the stream (Section 3), and consumers subscribe and apply
Section 6. A deployment that offers event-driven
propagation MUST advertise mission_event_stream_endpoint
(Section 10) and support at least one SSF delivery method
(Section 3), so consumers discover it.¶
This document neither requires nor presumes event-driven propagation; a Mission Issuer MAY emit lifecycle events for audit or operational purposes independent of any consumer's enforcement posture.¶
A partner ERP (erp.partner.example.com) consumes Mission lifecycle
signals so it can stop honoring a Mission promptly rather than wait out
token lifetimes. alice cancels her Q3 reconciliation Mission. The
Mission Issuer commits the revoked transition and pushes a SET to the
consumer's receiver ([RFC8935]). Decoded SET:¶
{
"iss": "https://as.example.com",
"aud": "https://erp.partner.example.com",
"iat": 1793610000,
"jti": "set_5kQ8mP2vR9nT",
"sub_id": {
"format": "opaque",
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-"
},
"events": {
"https://schemas.karlmcguinness.com/mission/lifecycle-change": {
"mission": {
"id": "msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9-",
"issuer": "https://as.example.com"
},
"state": "revoked",
"prior_state": "active",
"version": 7,
"committed_at": "2026-11-02T09:00:00Z",
"expires_at": "2026-12-31T23:59:59Z",
"reason": "user_cancelled"
}
}
}
¶
The consumer verifies the SET signature, iss, aud, and jti, sees
version 7 is newer than any state it holds, and records the Mission as
revoked. Because revoked is non-active, the consumer stops relying
on the Mission: the next attempt to use a token bound to
msn_8RfX2Lqv9TqMv4z7sA2bN1k0YpEdHc9- is refused, seconds after the
cancellation, well inside the token's remaining lifetime. Had a stale
active event for an earlier version arrived afterward, the
version counter would cause the consumer to ignore it rather than
revive the Mission.¶
A Mission Issuer that emits lifecycle events advertises the following in its Authorization Server metadata [RFC8414], in addition to the issuance-profile and Status-profile members it already publishes:¶
mission_event_stream_endpoint:OPTIONAL. A string containing a URL. The URL of the Mission Issuer's
Shared Signals Framework [OIDC-SSF] Transmitter Configuration
Metadata document. From it a consumer discovers the SSF stream
configuration, stream status, add-subject, and poll endpoints, and
the supported delivery methods (delivery_methods_supported), rather
than from a separate metadata member (Section 3). Present when
the Mission Issuer emits events.¶
This document is OPTIONAL. An implementation that claims it:¶
as a Mission Issuer, emits a signed mission.lifecycle-change
SET (Section 4, Section 5) on every committed
Mission lifecycle transition, supports at least one SSF delivery
method (Section 3), advertises
mission_event_stream_endpoint (Section 10), and, where a
committed transition would carry authority_changed true, gates its
delivery per Section 7;¶
as a consumer, verifies and applies received events per Section 5 and Section 6.¶
An implementation that supports neither role is still a conforming issuance profile [I-D.draft-mcguinness-oauth-mission].¶
The security considerations of the issuance profile [I-D.draft-mcguinness-oauth-mission] and the Status profile [I-D.draft-mcguinness-oauth-mission-status] apply. This section covers threats specific to event propagation.¶
A forged event could suppress a Mission (a spurious revoked) or, more
dangerously, mask a revocation (a spurious active). SET signing
(Section 5) binds each event to the Mission Issuer: the
consumer's verification of the signature, the iss, and its own aud
per Section 5 rejects a forged event, and the same section's
duplicate suppression handles a redelivered jti without reprocessing
it. The version ordering rule
(Section 6) prevents an old active event from overriding
a newer revoked one, whether the old event is a forgery, a replay, or
an at-least-once duplicate.¶
Event delivery is best-effort; a consumer that treats "no event" as "still active" indefinitely defeats the purpose. A consumer MUST bound its reliance on event freshness and fall back to polling Mission Status (Section 6) so a dropped revocation event does not leave a Mission honored past the deployment's advertised staleness bound.¶
Event delivery and polling are operational surfaces, with the posture of Mission Status [I-D.draft-mcguinness-oauth-mission-status]. The party serving each surface MUST rate-limit it per authenticated peer: the transmitter its poll endpoint, the receiver its push delivery endpoint. A receiver applies backpressure through its delivery method's acknowledgment and error signaling rather than buffering without bound, and a transmitter MUST bound its retry schedule so an unavailable receiver cannot amplify delivery traffic.¶
This document inherits OAuth 2.0 Best Current Practice [RFC9700] for the OAuth surfaces it composes with; implementers MUST follow current OAuth security guidance.¶
A mission.lifecycle-change event discloses a Mission's identifier,
state transitions, and timing to its receivers. A Mission Issuer MUST
deliver events only to consumers authorized for the Mission and MUST
scope each SET to a single consumer audience (Section 5), so a
consumer never learns of Missions it is not party to. Event streams and
their delivery logs record mission_id and consumer identity over
time; deployments MUST treat them as Mission information-disclosure
surfaces with the privacy posture of
[I-D.draft-mcguinness-oauth-mission-status]. An event can also
outlive what it references: the Mission records and evidence an event
points to may later be erased under the audit profile's erasure
record ([I-D.draft-mcguinness-mission-audit]), so a retained event
is no guarantee the referenced record remains retrievable.¶
The OPTIONAL reason (Section 4) is useful operational
context, but the reason for a transition can be more sensitive than the
fact of it. Because each SET is audience-scoped to a single authorized
consumer (Section 5), reason is disclosed only to a party
already authorized for the Mission, not broadcast. Even so, a Mission
Issuer SHOULD include in reason only what that consumer needs, keep
sensitive specifics in its own audit log rather than in the event, and
MAY omit reason entirely when even a minimal reason would disclose
more than the consumer requires.¶
IANA is not requested to create a registry. This document defines the
following Security Event Token (SET) [RFC8417] event type URI under
the author-controlled schemas.karlmcguinness.com namespace:¶
https://schemas.karlmcguinness.com/mission/lifecycle-change:
emitted on any Mission lifecycle transition or the approval-event
emission from a Mission Issuer. The SET subject is a sub_id Subject
Identifier [RFC9493] of format opaque whose id is the
mission_id, per [OIDC-SSF] conventions. Required event-body
claims: mission (carrying id and issuer), state, version,
committed_at, expires_at. Conditional event-body claims:
prior_state (required on transition emissions, absent on the
approval-event emission), suspend_until with on_expiry (present
only on a transition to suspended under a deadline), and
authority_changed (required true on any event whose commit
narrows effective authority without changing state, the discharge
commit being the current case, delivery subject to the gate of
Section 7; optional and defaulting to false
otherwise). Optional event-body claims: tenant, reason, and
successor (present only on a superseded transition). See
Section 4 for the schema.¶
This event type uses the OpenID Shared Signals Framework [OIDC-SSF]
SET shape. The standalone Mission Issuer binding
[I-D.draft-mcguinness-mission-authority-server] emits this event
type unchanged and imposes no tenant requirement; tenant remains
OPTIONAL.¶
The event-type URI is under the author-controlled
schemas.karlmcguinness.com namespace so this profile can be
deployed without a registry dependency.¶
The author thanks the implementers and reviewers of the Mission-Bound Authorization work, and the OpenID Shared Signals and CAEP communities, for the foundations this profile builds on.¶