Skip to content

Define registry inclusion rules#157

Merged
timcappalli merged 27 commits into
mainfrom
registry_rules
Apr 24, 2025
Merged

Define registry inclusion rules#157
timcappalli merged 27 commits into
mainfrom
registry_rules

Conversation

@marcoscaceres

@marcoscaceres marcoscaceres commented Aug 7, 2024

Copy link
Copy Markdown
Collaborator

Closes #58
Closes #191
Closes #124


Preview | Diff

Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated

@OR13 OR13 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This looks good.

If it's possible to use openid as the first example I think a working example will do a better job of explaining than a fake example.

The requirements seem good.

The privacy and security evaluation criteria need to be more explicit though, and there should be a documented appeal process, for rejections.

@marcoscaceres

Copy link
Copy Markdown
Collaborator Author

Agree with @OR13. I'm still hopeful that privacy folks will jump into this and help us define the criteria. I've pinged in #58 and let's see about getting this on the agenda for the next call.

@npdoty

npdoty commented Aug 19, 2024

Copy link
Copy Markdown

This is a novel use of privacy and security reviews for Registry updates, so I don't know that we have settled guidance yet. Please bear with us / let's do our best to figure out the best way to do this.

We did discuss briefly in the issue giving more specifics on privacy-related requirements for the protocol level, but I think we're unlikely to include all of those details within this registry section. Would it still be useful to summarize the high-level needs for the protocol, even if the reviews will inevitably be more detailed?

One consideration is that we expect not only to have reviewed the protocol specs for privacy, but also to have addressed any issues raised in those reviews, if the implications are significant for our privacy expectations for the system as a whole. So I suggest we:

  • change the language to require a privacy review and issues addressed,
  • add a citation to the user considerations/threat model document in whatever state we can (so that we can give some set of expectations to those trying to determine whether a protocol is well-suited), and
  • indicate that the group should evaluate the results of those reviews when making a consensus call.

(I'm recovering from COVID; please forgive belated replies or awkward wording.)

Comment thread index.html
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated

@hlozi hlozi left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Please remove the word “freely” and retain “publicly available”. It’s important for specifications to be publicly available, yet we know that some key formats and protocols for digital credentials are not always freely available. Discussing that in the context of the registry inclusion criteria seems neither suitable nor an effective use of our time.

Comment thread index.html Outdated
Comment thread index.html Outdated
@bc-pi

bc-pi commented Apr 1, 2025

Copy link
Copy Markdown
Contributor

Please remove the word “freely” and retain “publicly available”. It’s important for specifications to be publicly available, yet we know that some key formats and protocols for digital credentials are not always freely available. Discussing that in the context of the registry inclusion criteria seems neither suitable nor an effective use of our time.

Discussing criteria for inclusion in the registry, as part of a PR literally titled "Define registry inclusion rules", seems not only suitable but essential for this group, which is tasked with defining both the API and its associated registry.

To my admittedly naive eye, pushback against requiring specifications to be both freely and publicly available feels antithetical to the W3C’s ethos of openness and accessibility. The W3C's core principles emphasize that Web standards should be available to everyone, to support interoperability, global participation, and the continued growth of the Web.

What would be an ineffective use of our time, in my view, is a prolonged debate over whether free and open access to specifications should be a baseline expectation.

@jogu

jogu commented Apr 2, 2025

Copy link
Copy Markdown

To my admittedly naive eye, pushback against requiring specifications to be both freely and publicly available feels antithetical to the W3C’s ethos of openness and accessibility. The W3C's core principles emphasize that Web standards should be available to everyone, to support interoperability, global participation, and the continued growth of the Web.

I think @bc-pi does raise an interesting point here. Is there precedent for W3C working groups effectively endorsing non-freely available specifications?

Per the 2025-04-11 hybrid meeting.
@wseltzer

Copy link
Copy Markdown
Contributor

Discussed at 21 April meeting notes

@timcappalli timcappalli added the FPWD Blockers Should be addressed before FPWD label Apr 21, 2025
@timcappalli timcappalli requested a review from a team as a code owner April 21, 2025 18:09

@RByers RByers left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This looks great to me now, thanks Marcos and Tim!

@samuelgoto samuelgoto left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Inclusion rules LGTM++

Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html
Comment thread index.html
@marcoscaceres

Copy link
Copy Markdown
Collaborator Author

I made some changes. @timcappalli, please take a look. If all looks good, please merge.

@samuelgoto samuelgoto left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Changes LGTM++

@timcappalli timcappalli merged commit fb76ddf into main Apr 24, 2025
@timcappalli timcappalli deleted the registry_rules branch April 24, 2025 02:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

FPWD Blockers Should be addressed before FPWD privacy-tracker Group bringing to attention of Privacy, or tracked by the Privacy Group but not needing response. security-tracker Group bringing to attention of security, or tracked by the security Group but not needing response.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

What are the protocol identifier naming rules? [spec] add statement about responses with PII MUST be encrypted Registry inclusion criteria