Skip to content

Editorial changes to multiple/batch credential issuance section #511

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

Merged
merged 8 commits into from
Jun 10, 2025

Conversation

sloops77
Copy link
Contributor

@sloops77 sloops77 commented May 20, 2025

resolves #508

To issue multiple Verifiable Credentials with differing Credential Formats or Credential Datasets, multiple requests MUST be sent to the Credential Endpoint.

In the course of the authorization process, the Credential Issuer MAY also request Credential presentation as a means to authenticate or identify the End-User during the issuance flow, as described in (#use-case-5).
Copy link
Collaborator

Choose a reason for hiding this comment

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

why was this deleted?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@Sakurann I was editing the batch credential section. I didn't understand why a reference to presentation based authentication was here. I think it needs to be moved but maybe it makes more sense for me to restore it and get this merged asap, and then it can be sorted out in #509

Copy link
Contributor

Choose a reason for hiding this comment

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

I agree it seems to be placed in the wrong section. Can we move it somewhere more sensible than deleting it or is it already mentioned elsewhere?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@paulbastian @Sakurann i moved the section to the introduction to authorization code flow.

Copy link
Contributor

Choose a reason for hiding this comment

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

I'm happy with this change.

@Sakurann Sakurann requested review from jogu, cre8, c2bo, paulbastian and awoie May 21, 2025 11:39
moved introduction to credential presentation authentication into the authorization code flow section
@Sakurann Sakurann added this to the Final 1.0 milestone May 28, 2025
@sloops77
Copy link
Contributor Author

sloops77 commented Jun 2, 2025

@jogu I feel that your comments are coming from the perspective that batches means 2 or more, whereas the way i wrote this is that the batches can be 1 or more. I prefer to describe the credential endpoint issuing batches of 1 or more, because the response properties are the same in all cases.

However I see that the existing references to batch are written as if batch is 2 or more, and therefore these inconsistencies should be fixed in this PR.

I would be interested in more opinions before continuing

@jogu
Copy link
Contributor

jogu commented Jun 2, 2025

@sloops77

@jogu I feel that your comments are coming from the perspective that batches means 2 or more, whereas the way i wrote this is that the batches can be 1 or more. I prefer to describe the credential endpoint issuing batches of 1 or more, because the response properties are the same in all cases.

However I see that the existing references to batch are written as if batch is 2 or more, and therefore these inconsistencies should be fixed in this PR.

I would be interested in more opinions before continuing

Good point. I asked some of the other editors and everyone seemed happy if we use a definition of "batch" that means "1 or more" so I'll withdraw one of my suggestions.

* `batch_credential_issuance`: OPTIONAL. Object containing information about the Credential Issuer's supports for batch issuance of Credentials on the Credential Endpoint. The presence of this parameter means that the issuer supports more than one key proof in the `proofs` parameter in the Credential Request so can issue more than one Verifiable Credential for the same Credential Dataset in a single request/response.
* `batch_size`: REQUIRED. Integer value specifying the maximum array size for the `proofs` parameter in a Credential Request.
* `batch_credential_issuance`: OPTIONAL. Object containing information about the Credential Issuer's support for issuance of multiple Credentials in a batch in the Credential Endpoint. The presence of this parameter means that the issuer supports more than one key proof in the `proofs` parameter in the Credential Request so can issue more than one Verifiable Credential for the same Credential Dataset in a single request/response.
* `batch_size`: REQUIRED. Integer value specifying the maximum array size for the `proofs` parameter in a Credential Request. It MUST be 2 or greater.
Copy link
Collaborator

Choose a reason for hiding this comment

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

I asked some of the other editors and everyone seemed happy if we use a definition of "batch" that means "1 or more" so I'll withdraw one of my suggestions.

if this is true, should this not be 1 or greater?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think because of the "The presence of this parameter means that the issuer supports more than one key proof in the proofs parameter" on the parent object, it can only be legal to have batch_size of at least 2.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@Sakurann logically it should be 2 or more, but practically we could drop the statement as it probably doesnt harm interop

Copy link
Collaborator

Choose a reason for hiding this comment

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

ok. let's keep it as-is then

sloops77 and others added 2 commits June 9, 2025 16:08
@Sakurann Sakurann merged commit 1d4b579 into openid:main Jun 10, 2025
2 checks passed
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.

Cleanup references to batch
5 participants