openid / oid4vc-haip-sd-jwt-vc

High Assurance Profile of OID4VP and OID4VCI using SD-JWT VC and mdocs that is privacy preserving, secure, and meets regulatory requirements
29 stars 7 forks source link

changed draft name and added revision number #80

Closed tlodderstedt closed 10 months ago

tlodderstedt commented 11 months ago

Please add " - draft 00" to the title line so we can publish to openid.net/specs/ after adoption and add a History section with a history entry for 00. Thanks.

it already has draft in the title

selfissued commented 11 months ago

The title is currently "OpenID4VC High Assurance Interoperability Profile with SD-JWT VC". Please change this to "OpenID4VC High Assurance Interoperability Profile with SD-JWT VC - draft 00".

selfissued commented 11 months ago

Also, please add the "Notices" appendix like the one at https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0-12.html#name-notices and an "Acknowledgements" appendix.

tlodderstedt commented 11 months ago

The title is currently "OpenID4VC High Assurance Interoperability Profile with SD-JWT VC". Please change this to "OpenID4VC High Assurance Interoperability Profile with SD-JWT VC - draft 00".

image
selfissued commented 11 months ago

The checklist of OpenID spec contents is at https://openid.net/wg/resources/naming-and-contents-of-specifications/.

selfissued commented 11 months ago

Finally, before we publish to openid.net/specs/, I propose that we update the pathname to align with other specs in the family. The pathname is currently oid4vc-haip-sd-jwt-vc. To me, the logical pathname would be openid-4-verifiable-credential-haip-sd-jwt-vc-1_0 or (shorter) openid-4-vc-haip-sd-jwt-vc-1_0. Those are more like openid-4-verifiable-credential-issuance-1_0, for instance. Thanks.

(I particularly think that we need to change "oid", as OID means Object Identifier to most people in the identity space, as used in X.509, and doesn't incorporate the usual openid branding.)

tlodderstedt commented 10 months ago

Also, please add the "Notices" appendix like the one at https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0-12.html#name-notices and an "Acknowledgements" appendix.

done

tlodderstedt commented 10 months ago

Finally, before we publish to openid.net/specs/, I propose that we update the pathname to align with other specs in the family. The pathname is currently oid4vc-haip-sd-jwt-vc. To me, the logical pathname would be openid-4-verifiable-credential-haip-sd-jwt-vc-1_0 or (shorter) openid-4-vc-haip-sd-jwt-vc-1_0. Those are more like openid-4-verifiable-credential-issuance-1_0, for instance. Thanks.

(I particularly think that we need to change "oid", as OID means Object Identifier to most people in the identity space, as used in X.509, and doesn't incorporate the usual openid branding.)

We use oid4vc as acronym for the protocol family for quite some time now. If we want to be more verbose, I would rather resolve haip into high-assurance-interoperability-profile -> oid4vc-high-assurance-interoperability-profile-sd-jwt-vc-1_0 @Sakurann WDYT?

selfissued commented 10 months ago

Essentially all of the specs at openid.net/specs/ begin with "openid-". (The exceptions are those that start with "fapi-" and "oauth-".) Given that this is an OpenID spec, we should start the path with "openid-". I'd be fine with openid-high-assurance-interoperability-profile-sd-jwt-vc-1_0, for instance.

Consistency matters.

Sakurann commented 10 months ago

I would be ok with openid4vc-high-assurance-interoperability-profile-sd-jwt-vc-1_0. (Would prefer it over openid4vc-haip-sd-jwt-vc-1_0).

Just openid- is not accurate/sufficient and expanding openid-4-verifiable-credentials does not really make sense in HAIP context.

tlodderstedt commented 10 months ago

@selfissued I changed the file name to openid4vc-high-assurance-interoperability-profile-sd-jwt-vc-1_0. Can you please approve the PR now?