You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f2c4ce7
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/nips/NIP-PL.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -258,15 +258,15 @@ A pubkey-only client cannot create, replace, or revoke a lease. If a platform en
258
258
259
259
Implementations MUST NOT interpret this section as NIP-26 delegation. A future specification may define a narrowly scoped installation authorization for unattended endpoint rotation, but such a capability is neither required nor implied here.
260
260
261
-
## APNs Gateway Profile (Buzz, normative)
261
+
## Public APNs Gateway Profile (Buzz, normative)
262
262
263
-
This section registers a last-hop profile served at a deployment-configured HTTPS origin. It is an optional profile of NIP-PL, but every requirement in this section is normative for implementations that use it. The configured origin has no credentials, port, path, query, or fragment. The gateway is stateful: it retains installation authority, encrypted APNs-token custody, relay delegations, replay reservations, and endpoint quotas. The relay remains the executor and retains lease acceptance, matching, tenant authorization, endpoint uniqueness, coalescing, durable jobs/retries, and lease-generation invalidation.
263
+
This section registers the public last-hop profile served at `https://push.buzz.xyz`. It is an optional profile of NIP-PL, but every requirement in this section is normative for implementations that use it. The gateway is stateful: it retains installation authority, encrypted APNs-token custody, relay delegations, replay reservations, and endpoint quotas. The relay remains the executor and retains lease acceptance, matching, tenant authorization, endpoint uniqueness, coalescing, durable jobs/retries, and lease-generation invalidation.
264
264
265
265
### Registered values and lease mapping
266
266
267
267
The registered `app_profile` value is `buzz-ios-dogfood`. It identifies the
268
268
closed Buzz dogfood application identity, not an APNs transport environment.
269
-
The configured gateway owns its exact App Attest application identifier, APNs
269
+
The canonical gateway owns its exact App Attest application identifier, APNs
270
270
topic, certificate-backed connection pool, and APNs environment. Enrollment
271
271
succeeds only when App Attest cryptographically verifies the configured
272
272
application identifier. The gateway MUST NOT accept an APNs topic from a client. The APNs token
@@ -289,7 +289,7 @@ Every App Attest operation signs a **transcript**, not the received request byte
289
289
<domain> + "\\n" + <compact ordered JSON object>
290
290
```
291
291
292
-
The JSON object has no insignificant whitespace and members appear in the exact order shown below. Strings use JSON escaping for quotation mark, reverse solidus, and U+0000..U+001F; all authority-bearing strings admitted by this profile are ASCII. UUID strings are canonical lowercase-hyphenated. Integers use shortest decimal notation. The `audience` value is the configured gateway origin plus the fixed route shown below. It is part of the signed object and prevents cross-origin and cross-route use. For enrollment, these exact transcript bytes are the App Attest `clientData` supplied to attestation verification. For every assertion route, `clientDataHash = SHA-256(transcript bytes)` is verified by App Attest. The separately stored challenge must equal the request `challenge`, is single-use, expires after 300 seconds, and is consumed only after successful cryptographic verification. Assertion `signCount` MUST strictly increase atomically for the installation.
292
+
The JSON object has no insignificant whitespace and members appear in the exact order shown below. Strings use JSON escaping for quotation mark, reverse solidus, and U+0000..U+001F; all authority-bearing strings admitted by this profile are ASCII. UUID strings are canonical lowercase-hyphenated. Integers use shortest decimal notation. The fixed `audience` value is part of the signed object and prevents cross-route use. For enrollment, these exact transcript bytes are the App Attest `clientData` supplied to attestation verification. For every assertion route, `clientDataHash = SHA-256(transcript bytes)` is verified by App Attest. The separately stored challenge must equal the request `challenge`, is single-use, expires after 300 seconds, and is consumed only after successful cryptographic verification. Assertion `signCount` MUST strictly increase atomically for the installation.
293
293
294
294
### Challenge
295
295
@@ -318,7 +318,7 @@ Request members, in any request order:
318
318
`expires_at` MUST satisfy `now < expires_at <= now + configured_max_installation_lifetime`; the selected profile MUST be enabled. The exact transcript is domain `buzz.push.enroll.v1` followed by this ordered object:
The gateway verifies Apple's attestation chain, configured application identifier, production AAGUID, key identifier, and transcript. Apple documents no APNs-token-to-App-Attest-key binding; token provenance at enrollment is an explicit bootstrap assumption. It then stores only encrypted token custody plus its fingerprint. Success `201`:
@@ -342,7 +342,7 @@ Invalid attestation is `401 invalid_attestation`; a consumed/expired challenge o
342
342
`not_before <= now + 300`, `not_before < expires_at`, and `expires_at <= now + configured_max_grant_lifetime`. The endpoint epoch MUST equal the current installation epoch. For each `(installation_handle, relay_pubkey)`, generation MUST strictly increase. A successful delegation atomically extends the authenticated installation lifetime through at least the delegation's `expires_at`, allowing renewal without duplicate token enrollment. Transcript domain `buzz.push.delegate.v1`; ordered object:
Success `201`: `{"endpoint_grant":"<opaque-capability>"}`. The sealed grant contains no APNs token. Grant-key rotation MUST retain decrypt-only predecessor keys through the maximum lifetime of grants they issued.
@@ -358,7 +358,7 @@ Success `201`: `{"endpoint_grant":"<opaque-capability>"}`. The sealed grant cont
358
358
`new_endpoint_epoch` MUST equal `endpoint_epoch + 1` without overflow. Transcript domain `buzz.push.rotate-endpoint.v1`; ordered object:
Success is `200 {"status":"revoked"}`. The revocation atomically invalidates the installation and every delegation.
395
395
396
396
### Relay delivery
397
397
398
-
`POST /v1/deliveries/apns` has the exact externally configured URL `<gateway-origin>/v1/deliveries/apns`. Request:
398
+
`POST /v1/deliveries/apns` has the exact externally configured URL `https://push.buzz.xyz/v1/deliveries/apns`. Request:
0 commit comments