Interfaces GBC Client

did:web Interface

getDIDdocumentGBC

Inhoud en formaat van een didDocumentRequest

De URL waarnaar een didDocumentRequest dient te worden verzonden wordt bepaald o.b.v. de inhoud van de <did:web>.

Een <did:web> kan conform https://w3c-ccg.github.io/did-method-web/#read-resolve worden getransformeerd naar een URL. Dit leidt dan tot een <did:web:url>.

Een <did:web:url> bestaat uit een <did:web:base-url> en optioneel een <did:web:path>.

Indien een <did:web:url> géén path component bevat, dan wordt een didDocumentRequest op de volgende wijze verzonden:

GET <did:web:url>/.well-known/did.json

Indien een <did:web:url> een path component bevat, dan wordt een didDocumentRequest op de volgende wijze verzonden:

GET <did:web:base-url>/<did:web:path>/did.json

Voorbeelden:

• did:web:huisarts-delinden.nl wordt vertaald naar GET huisarts-delinden.nl/.well-known/did.json

• did:web:huisarts-delinden.nl:ura:12345678 wordt vertaald naar GET huisarts-delinden.nl/ura/12345678/did.json

Inhoud en formaat van een didDocumentResponse

Een didDocumentResponse bevat de volgende headers:

Content-Type: application/did+ld+json; charset=utf-8
Cache-Control: must-revalidate, max-age=<max-age-metadata>
Pragma: no-cache

Een client mag verkregen responses conform de Cache-Control header directives, zoals beschreven in RFC 7234, cachen.

Zie ook Key Material and Document Handling voor een beschrijving van hoe een client dient om te gaan met een didDocumentResponse.

De body van de didDocumentResponse bevat een DID document. De inhoud van een DID-document voldoet aan DID Document properties, waarbij de volgende properties van belang zijn:

• id: de did:web identifier

• verificationMethod (optioneel): een lijst van publieke sleutels die eigendom zijn van deze DID, uitgedrukt als JWK (JSON Web Key), conform RFC 7517. Elke sleutel MOET een unieke id hebben (opgebouwd als did:web:example.nl#key-1) en een type van JsonWebKey2020.

• assertionMethod (verplicht voor issuers van Verifiable Credentials)

• authentication (verplicht voor issuers van Verifiable Presentations)

Eventuele references in assertionMethod en authentication moeten verwijzen naar verificationMethods in hetzelfde DID-document.

De sleutels die worden gehanteerd voor assertionMethod en voor authentication moeten verschillend zijn.

Een voorbeeld van de HTTP body van een didDocumentResponse is hieronder opgenomen.

{ 
  "@context": [ 
    "https://www.w3.org/ns/did/v1", 
    "https://w3id.org/security/suites/jws-2020/v1" 
  ], 
  "id": "did:web:huisarts-delinden.nl", 
  "verificationMethod": [ 
    { 
      "id": "did:web:huisarts-delinden.nl#assertion-key-1", 
      "type": "JsonWebKey2020", 
      "controller": "did:web:huisarts-delinden.nl", 
      "publicKeyJwk": { 
        "kty": "EC", 
        "crv": "P-256", 
        "x": "f83OJ3D2xF1Bg8vub9tLe1gHMzV76e8Tus9uPHvRVEU", 
        "y": "x_FEzRu9m36HLN_tue659LNpXW6pCyStikYjKIWI5a0" 
      } 
    }, 
    { 
      "id": "did:web:huisarts-delinden.nl#auth-key-1", 
      "type": "JsonWebKey2020", 
      "controller": "did:web:huisarts-delinden.nl", 
      "publicKeyJwk": { 
        "kty": "EC", 
        "crv": "P-256", 
        "x": "iGRzTt4S5MWRMj9AHYxMj3NY2gczR30YS1YSwNivfbk", 
        "y": "L2n3xtAiIfikTAKztVOjvnykGqNPcEWCDAcEMJn3cNo" 
      } 
    } 
  ], 
  "assertionMethod": [ 
    "did:web:huisarts-delinden.nl#assertion-key-1" 
  ], 
  "authentication": [ 
    "did:web:huisarts-delinden.nl#auth-key-1" 
  ] 
}

Aanvullende eisen