iya-sts
    Preparing search index...

    An application's own WS-Trust decryption key pair: issued from the realm's CA, uploaded, removed, described, and chosen for a request.

    Index
    CN_SUFFIX: "-encrypt" = CN_SUFFIX

    The suffix of an issued certificate's common name.

    DEFAULT_KEY_ALG: "rsa-3072" = DEFAULT_KEY_ALG

    The key type an issue makes by default.

    • The common name an issued certificate carries for an application.

      Parameters

      • identifier: string

        the application

      Returns string

      <identifier>-encrypt

    • Issues an application a decryption key pair from the realm's CA and writes it onto its entry, replacing the one it held.

      Parameters

      • identifier: string

        the application

      • body: any

        keyAlg (rsa-3072 by default, or ec-p256), days

      • ctx: any

        actor, via

      Returns Promise<any>

      a promise of { ok: true, message, wstrustDecryption }, or a refusal with its code marked

    • The decryption key a handle names, among the applications' own: the application holding it and its private key, opened for this request.

      Parameters

      • handles: string[]

        crypto.wssCertificateHandles()'s forms, as the EncryptedKey names its recipient

      Returns any

      { owner, privateKey, certificate }, or null when no application holds a certificate it names (or its key will not open)

    • Takes an application's decryption key pair off its entry. Not revocation: an issued certificate stays valid; nothing here can open a request encrypted to it any longer.

      Parameters

      • identifier: string

        the application

      • ctx: any

        actor, via

      Returns any

      { ok: true, message, wstrustDecryption }, or a refusal with its code marked

    • What an application's page and GET /admin-api/applications say about its decryption key pair: the certificate and its chain, where it came from, whether the private key is held and sealed, and what an issue would make. Never the private key.

      Parameters

      • row: any

        the application's view

      Returns any

      the state

    • Describes a certificate for the page and the API: subject, issuer, serial, validity, key type and both thumbprints.

      Parameters

      • pem: string

        the certificate

      Returns any

      the summary, or { unreadable }

    • Writes an uploaded certificate and private key onto an application, in place of the pair it held, once they are one pair this service can decrypt with.

      Parameters

      • identifier: string

        the application

      • body: any

        certificate and privateKey, PEM

      • ctx: any

        actor, via

      Returns any

      { ok: true, message, wstrustDecryption }, or a refusal with its code marked