Skip to content

Add record identifiers page - #112

Draft
stevenvegt wants to merge 5 commits into
mainfrom
record-identifiers
Draft

Add record identifiers page#112
stevenvegt wants to merge 5 commits into
mainfrom
record-identifiers

Conversation

@stevenvegt

Copy link
Copy Markdown
Member

Summary

Adds a page on record identifiers: what they can disclose, and how receivers recognize the same record across systems.

  • Problem statement: identifiers travel further than the records they name; failures are disclosure and recognition errors (undetected duplicates, false merges).
  • Risks: who sees identifiers without content access (unauthorized recipient, observer, coalition) and which schemes fail (ordered, time-encoding, concatenated, derived, low-entropy, volatile).
  • Passing schemes with worked examples: random (UUIDv4), keyed transformation (HMAC or deterministic encryption), per-recipient; business identifier uniqueness mechanisms and identity claim verification steps.
  • Requirements REQ-01 to REQ-12, allocated to the level that owns each decision: trust framework (baseline), information standard (when to require business identifiers, reference and notification styles, human use), vendor (scheme, key custody).
  • Related work: Nictiz deduplication guideline, NHS England identifier policy, US Core, IHE mCSD, FHIR core.

Status

Draft for working-group review. Open issues are listed at the end of the page: key custody and rotation, audience-scoped notification design, a trust-framework-designated system URI versus urn:ietf:rfc:3986, and alignment with Nictiz Objectidentificatie.

Notes

  • Only the page itself is included; the sushi-config page registration and menu entry are intentionally left out until the content settles.

Describes what record identifiers can disclose and how receivers
recognize the same record across systems. Defines which identifier
schemes are acceptable, with examples, and allocates the requirements
to the level that owns each decision: trust framework, information
standard, or vendor.

Assisted-by: AI
Gives notification-spec authors a citable precondition: with REQ-02
and REQ-03 met, an id-only payload discloses exactly one opaque
reference, while an empty payload forces a search that can return
more records than the notification concerned. Also drops the
reference to the earlier draft from the intro.

Assisted-by: AI
Move the requirements before the examples that illustrate them and
split the examples: scheme examples stay under the schemes, the
requirement examples follow the rules. Rewrite the prose for plain
English throughout.

Two changes go beyond wording. REQ-03 now forbids deriving a record
identifier from a real-world entity identifier at all, keyed or not,
because a keyed derivation from a BSN turns every record identifier
into a pseudonym of the person. REQ-06 is renamed from identity claim
verification to identifier authenticity, and no longer refers to the
mechanisms of REQ-05 by letter.

Assisted-by: AI
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant