|
216 | 216 | ] |
217 | 217 | }, |
218 | 218 | { |
219 | | - "html": "Resolving a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-8\">service endpoint</a> — particularly one that is a DID — might\n\t\t\t\t\t\t\t\t\t\t\tresult in a <dfn id=\"dfn-resolution-cycle\" tabindex=\"0\" aria-haspopup=\"dialog\" data-dfn-type=\"dfn\">resolution cycle</dfn>, which is a set of steps that result in\n\t\t\t\t\t\t\t\t\t\t\tan infinite loop. For example, a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-9\">service endpoint</a> might indirectly point\n\t\t\t\t\t\t\t\t\t\t\tback through a sequence of resolutions to a previously dereferenced identifier.\n\t\t\t\t\t\t\t\t\t\t\tA <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-33\">DID resolver</a> recursively resolving a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-10\">service endpoint</a> is advised\n\t\t\t\t\t\t\t\t\t\t\tto detect and handle such a cycle to prevent an infinite loop or resolution failure.\n\t\t\t\t\t\t\t\t\t\t\tFor further guidance, see Section <a href=\"https://w3c.github.io/did-resolution/#security-cycles-resolution\">Resolution Cycles</a>.", |
| 219 | + "html": "Resolving a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-8\">service endpoint</a> — particularly one that is a DID — might\n\t\t\t\t\t\t\t\t\t\t\tresult in a <dfn id=\"dfn-resolution-cycle\" tabindex=\"0\" aria-haspopup=\"dialog\" data-dfn-type=\"dfn\">resolution cycle</dfn>, which is a set of steps that result in\n\t\t\t\t\t\t\t\t\t\t\tan infinite loop. For example, a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-9\">service endpoint</a> might indirectly point\n\t\t\t\t\t\t\t\t\t\t\tback through a sequence of resolutions to a previously dereferenced identifier.\n\t\t\t\t\t\t\t\t\t\t\tA <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-32\">DID resolver</a> recursively resolving a <a href=\"https://w3c.github.io/did-resolution/#dfn-service-endpoints\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-service-endpoints-10\">service endpoint</a> is advised\n\t\t\t\t\t\t\t\t\t\t\tto detect and handle such a cycle to prevent an infinite loop or resolution failure.\n\t\t\t\t\t\t\t\t\t\t\tFor further guidance, see Section <a href=\"https://w3c.github.io/did-resolution/#security-cycles-resolution\">Resolution Cycles</a>.", |
220 | 220 | "rationale": ".algorithm", |
221 | 221 | "steps": [ |
222 | 222 | { |
|
299 | 299 | "rationale": ".algorithm", |
300 | 300 | "steps": [ |
301 | 301 | { |
302 | | - "html": "The applicable <a href=\"https://w3c.github.io/did-resolution/#dfn-did-method-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-method-s-36\">DID method</a> <em class=\"rfc2119\">MAY</em> specify how to dereference\n\t\t\t\t\t\tthe <a href=\"https://w3c.github.io/did-resolution/#dfn-did-paths\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-paths-4\">DID path</a> and/or <a href=\"https://w3c.github.io/did-resolution/#dfn-did-queries\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-queries-4\">DID query</a> of the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-37\">DID URL</a></var>." |
| 302 | + "html": "The applicable <a href=\"https://w3c.github.io/did-resolution/#dfn-did-method-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-method-s-35\">DID method</a> <em class=\"rfc2119\">MAY</em> specify how to dereference\n\t\t\t\t\t\tthe <a href=\"https://w3c.github.io/did-resolution/#dfn-did-paths\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-paths-4\">DID path</a> and/or <a href=\"https://w3c.github.io/did-resolution/#dfn-did-queries\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-queries-4\">DID query</a> of the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-37\">DID URL</a></var>." |
303 | 303 | }, |
304 | 304 | { |
305 | 305 | "html": "An extension specification <em class=\"rfc2119\">MAY</em> specify how to dereference\n\t\t\t\t\t\tthe <a href=\"https://w3c.github.io/did-resolution/#dfn-did-paths\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-paths-5\">DID path</a> of the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-38\">DID URL</a></var>." |
|
313 | 313 | ] |
314 | 314 | }, |
315 | 315 | { |
316 | | - "html": "If neither this algorithm, nor the applicable <a href=\"https://w3c.github.io/did-resolution/#dfn-did-method-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-method-s-37\">DID method</a>, nor an extension, nor the client\n\t\t\t\tis able to dereference the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-41\">DID URL</a></var>, return the following result:", |
| 316 | + "html": "If neither this algorithm, nor the applicable <a href=\"https://w3c.github.io/did-resolution/#dfn-did-method-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-method-s-36\">DID method</a>, nor an extension, nor the client\n\t\t\t\tis able to dereference the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-41\">DID URL</a></var>, return the following result:", |
317 | 317 | "rationale": ".algorithm", |
318 | 318 | "steps": [ |
319 | 319 | { |
|
379 | 379 | "rationale": ".algorithm", |
380 | 380 | "steps": [ |
381 | 381 | { |
382 | | - "html": "Initialize a <var>request HTTP(S) URL</var> with the <var><a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-80\">DID resolver</a> HTTP(S) endpoint</var>." |
| 382 | + "html": "Initialize a <var>request HTTP(S) URL</var> with the <var><a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-78\">DID resolver</a> HTTP(S) endpoint</var>." |
383 | 383 | }, |
384 | 384 | { |
385 | 385 | "html": "For the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolution\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolution-46\">DID resolution</a> function:", |
|
404 | 404 | "html": "Append the <var>input <a href=\"https://w3c.github.io/did-resolution/#dfn-did-urls\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-urls-55\">DID URL</a></var> to the <var>request HTTP(S) URL</var>." |
405 | 405 | }, |
406 | 406 | { |
407 | | - "html": "Set the <code>Accept</code> <var>HTTP request header</var> to <code>application/did-url-dereferencing</code>\n\t\t\t\t\t\tto request a complete <a href=\"https://w3c.github.io/did-resolution/#did-url-dereferencing-result\" class=\"sec-ref\"><bdi class=\"secno\">9. </bdi>DID URL Dereferencing Result</a>, OR" |
| 407 | + "html": "Set the <code>Accept</code> <var>HTTP request header</var> to <code>application/did-url-dereferencing</code>\n\t\t\t\t\t\tto request a complete <a href=\"https://w3c.github.io/did-resolution/#did-url-dereferencing-result\" class=\"sec-ref\"><bdi class=\"secno\">8.2 </bdi>DID URL Dereferencing Result</a>, OR" |
408 | 408 | }, |
409 | 409 | { |
410 | 410 | "html": "set the <code>Accept</code> <var>HTTP request header</var> to the value of the <b>accept</b> <var>dereferencing option</var>\n to request only the <b>contentStream</b> value of the result." |
|
428 | 428 | ] |
429 | 429 | }, |
430 | 430 | { |
431 | | - "html": "Execute an HTTP <code>GET</code> request on the <var>request HTTP(S) URL</var>. This invokes the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolution\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolution-47\">DID resolution</a> or\n <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-39\">DID URL dereferencing</a> function at the remote <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-81\">DID resolver</a>." |
| 431 | + "html": "Execute an HTTP <code>GET</code> request on the <var>request HTTP(S) URL</var>. This invokes the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolution\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolution-47\">DID resolution</a> or\n <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-39\">DID URL dereferencing</a> function at the remote <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-79\">DID resolver</a>." |
432 | 432 | } |
433 | 433 | ] |
434 | 434 | }, |
|
446 | 446 | ] |
447 | 447 | }, |
448 | 448 | { |
449 | | - "html": "Execute an HTTP <code>POST</code> request on the <var>request HTTP(S) URL</var>. This invokes the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolution\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolution-48\">DID resolution</a> or\n <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-40\">DID URL dereferencing</a> function at the remote <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-82\">DID resolver</a>." |
| 449 | + "html": "Execute an HTTP <code>POST</code> request on the <var>request HTTP(S) URL</var>. This invokes the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolution\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolution-48\">DID resolution</a> or\n <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-40\">DID URL dereferencing</a> function at the remote <a href=\"https://w3c.github.io/did-resolution/#dfn-did-resolver-s\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-resolver-s-80\">DID resolver</a>." |
450 | 450 | } |
451 | 451 | ] |
452 | 452 | }, |
|
501 | 501 | "rationale": ".algorithm", |
502 | 502 | "steps": [ |
503 | 503 | { |
504 | | - "html": "The <var>HTTP body</var> <em class=\"rfc2119\">MUST</em> contain a <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing-result\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-result-2\">DID URL dereferencing result</a> (see <a href=\"https://w3c.github.io/did-resolution/#did-url-dereferencing-result\" class=\"sec-ref\"><bdi class=\"secno\">9. </bdi>DID URL Dereferencing Result</a>) that\n\t\t\t\t\t\t\t\tis the result of the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-44\">DID URL dereferencing</a> function." |
| 504 | + "html": "The <var>HTTP body</var> <em class=\"rfc2119\">MUST</em> contain a <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing-result\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-result-2\">DID URL dereferencing result</a> (see <a href=\"https://w3c.github.io/did-resolution/#did-url-dereferencing-result\" class=\"sec-ref\"><bdi class=\"secno\">8.2 </bdi>DID URL Dereferencing Result</a>) that\n\t\t\t\t\t\t\t\tis the result of the <a href=\"https://w3c.github.io/did-resolution/#dfn-did-url-dereferencing\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-did-url-dereferencing-44\">DID URL dereferencing</a> function." |
505 | 505 | } |
506 | 506 | ] |
507 | 507 | }, |
|
0 commit comments