Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add details about HTTPS binding. #108

Open
wants to merge 3 commits into
base: gh-pages
Choose a base branch
from

Conversation

peacekeeper
Copy link
Collaborator

This PR adds some details on how the HTTP(S) binding works, i.e. how the resolve() and dereference() functions can be invoked via an HTTP(S) endpoint, and how resolution options, metadata, status codes, etc. are handled.

index.html Outdated Show resolved Hide resolved
query parameters in the <var>request HTTP(S) URL</var>.</li>
</ol>
<li>Initialize a <var>request HTTP(S) URL</var> with the <var><a>DID resolver</a> HTTP(S) endpoint</var>.</li>
<pre class="example nohighlight">https://dev.uniresolver.io/1.0/identifiers/</pre>
Copy link
Member

@msporny msporny Jan 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll want to use a made-up URL here.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree. I created issue #109 to address this across the whole document.

@w3cbot
Copy link

w3cbot commented Jan 9, 2025

This was discussed during the #did meeting on 09 January 2025.

View the transcript

w3c/did-resolution#108

markus_sabadello: That's about the HTTPS interface. We have sections about the algorithm, how to resolve a DID, how to reference a DID URL.
… Those algorithms as well as the DID resolution algorithm are described not as a classic client-server protocol, you don't necessarily have a resolution endpoint, but rather as an abstract interface.
… That's why there's a separate section on the HTTPS binding.
… How DID resolution can be done over HTTPS interface where you can run HTTP GET on a single endpoint.
… I added some details to improve it.

wip: Markus, do you have some issues you want us to focus on?

markus_sabadello: No specific ones.


peacekeeper and others added 2 commits January 9, 2025 20:25
<a>DID resolution</a> and/or <a>DID URL dereferencing</a> functions (including all
resolution/dereferencing options and metadata) via an HTTP(S) endpoint. See <a href="#resolver-architectures"></a>.</p>

<p>The HTTP(S) binding is a <a>remote binding</a>. It requires a known HTTP(S) URL where a remote

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wondering if we need to say that HTTPS can also be used locally. HTTPS does not mean always connecting to a remote DID resolver

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.

4 participants