iya-sts
    Preparing search index...

    What happened to each subordinate, kept for good (OpenID Federation Subordinate Events Endpoint, draft 01): an append-only history per subordinate in the realm's ou=oidfed register. A library of static methods.

    Index
    EVENTS: Readonly<
        {
            CONSTRAINTS_UPDATE: "constraints_update";
            JWKS_UPDATE: "jwks_update";
            METADATA_POLICY_UPDATE: "metadata_policy_update";
            METADATA_UPDATE: "metadata_update";
            REGISTRATION: "registration";
            REINSTATEMENT: "reinstatement";
            REVOCATION: "revocation";
            SUSPENSION: "suspension";
            TRUST_MARK_ISSUANCE: "trust_mark_issuance";
            TRUST_MARK_REVOCATION: "trust_mark_revocation";
        },
    > = EVENTS

    The events recorded: the draft's six and this service's four (reinstatement, constraints_update, trust_mark_issuance, trust_mark_revocation).

    REALM_PREFIX: "realm:" = REALM_PREFIX

    The prefix of the key a realm of this service is recorded under.

    • Writes a value as canonical JSON, members sorted at every level, so two records that say the same thing compare equal.

      Parameters

      • value: any

        the value

      Returns string

      the JSON text

    • Reads a subordinate's history, oldest first, each event once (the earliest copy of an id a cluster recorded twice).

      Parameters

      • key: string

        the subordinate's key

      Returns SubordinateEvent[]

      the events

    • Checks a value as the draft's information_uri: an http or https URL with no user information, at most 2048 characters.

      Parameters

      • value: any

        the value

      Returns string

      the URL, '' when the value is empty, or null when it is something else

    • Answers whether anything was ever recorded about a subordinate.

      Parameters

      • key: string

        the subordinate's key

      Returns boolean

      true when it has a history

    • Records a realm's creation as its registration, in the default realm's register, while the default topology makes every realm a subordinate.

      Parameters

      • realmId: string

        the realm id

      • createdAt: any

        when it was created, which fixes the event's id on every node

      Returns void

    • Answers the key a realm of this service is recorded under.

      Parameters

      • realmId: string

        the realm id

      Returns string

      realm: and the id

    • Lists the keys of every realm of this service recorded in the ambient realm's register, live or deleted.

      Returns string[]

      the keys

    • Records a change to a realm's Federation Entity Keys as a jwks_update, in the default realm's register.

      Parameters

      • realmId: string

        the realm id

      • what: string

        the event's description

      Returns void

    • Answers the realm id a key names.

      Parameters

      • key: string

        a subordinate's key

      Returns string

      the realm id, or '' for a registered subordinate's key

    • Records a realm's deletion as its revocation, in the default realm's register, while the default topology makes every realm a subordinate.

      Parameters

      • realmId: string

        the realm id

      • createdAt: any

        when it was created, which fixes the event's id on every node

      Returns void

    • Records one event about a subordinate.

      A failure to write is logged under STS-OIDFED-0065 and never fails the act that caused it.

      Parameters

      • key: string

        the subordinate's key

      • entityId: string

        its Entity Identifier, where known

      • event: string

        one of EVENTS

      • Optionaloptions: any

        description, informationUri, atMs (default now) and id (default random)

      Returns SubordinateEvent

      the event as written, or null when the register could not be written

      Error when event is not a subordinate event

    • Lists the update events between two records of one registered subordinate, one per part that changed, in the draft's order.

      Parameters

      • before: any

        the record before

      • after: any

        the record after

      Returns string[]

      the events: metadata_policy_update, metadata_update, jwks_update and constraints_update, as they apply