Skip to content

Conversation

@jogu
Copy link
Contributor

@jogu jogu commented Sep 9, 2025

closes #136


## Prerequisites

This specification assumes certain prerequisites, including browser/OS support of certain features (for example the `haip://` custom URL scheme). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.
Copy link
Member

Choose a reason for hiding this comment

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

Should we mention both, custom URL scheme and DC API?

Suggested change
This specification assumes certain prerequisites, including browser/OS support of certain features (for example the `haip://` custom URL scheme). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.
This specification assumes certain prerequisites, including browser/OS support of certain features (for example support for the `haip://` custom URL scheme or the Digital Credentials API within the browser). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.

Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This specification assumes certain prerequisites, including browser/OS support of certain features (for example the `haip://` custom URL scheme). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.
The following mandatory clauses in this specification depend on browser and/or operating system support:
- `haip://` custom URL scheme
- Digital Credentials API
This means there might be environments beyond the implementer's control where these clauses cannot be implemented.

Copy link
Contributor Author

@jogu jogu Sep 16, 2025

Choose a reason for hiding this comment

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

I think there are two separate cases - if you can't do the DC API, you really can't do that whole flow at all - whereas you can support everything else in the redirect-based OID4VP flow without supporting haip://.

Copy link
Contributor

Choose a reason for hiding this comment

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

then would it make sense not to mention custom url schemes entirely?

Suggested change
This specification assumes certain prerequisites, including browser/OS support of certain features (for example the `haip://` custom URL scheme). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.
Digital Credentials API related mandatory clauses in this specification depend on browser and/or operating system support. This means there might be environments beyond the implementer's control where these clauses cannot be implemented.


## Prerequisites

This specification assumes certain prerequisites, including browser/OS support of certain features (for example the `haip://` custom URL scheme). This means some of the mandatory clauses might not be implementable for reasons outside the implementer's control.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Discussed on this morning's WG call: The text here ends up generically applying to all 'MUST' in the spec, meaning that (e.g.) you could be compliant with a HAIP flow whilst (say) not implementing a mandatory encryption requirement. I may have misunderstood the working group intent here as that leads to a situation where interoperability would suffer.

We could instead make clear that some flows may not be implementable for reasons out of your control, and in that case the implementer can't implement that flow in a compliant way - meaning we may need some kind of "conditionality" or "optionality" for things like custom schemes that may not work in all situations. The text suggested in #240 (comment) seems like it works for custom schemes.

Copy link
Contributor

Choose a reason for hiding this comment

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

i made a suggestion above to go one step further and be clear that the prerequisites described apply for specific two situations: custom schemes and DC API

@jogu
Copy link
Contributor Author

jogu commented Sep 22, 2025

I'm wondering if this is actually covered now that #266 is in (making the haip custom url scheme optional in the redirect flow) and we have #278 in progress (that makes clear that you can pick & choose whether to do DC API or not, and same for redirect based). I'm struggling to find anything else to say.

@Sakurann
Copy link
Contributor

WG discussion:

  • this PR is still needed to cover both custom url schemes and DC API, even tho custom scheme haip:// is not optional
  • some features (custom url schemes and DC API) rely on OS/browser features that might not be available
  • potentially move this to implementation considerations

@jogu
Copy link
Contributor Author

jogu commented Sep 24, 2025

I've updated based on WG discussion, please re-review @c2bo @Sakurann

@jogu jogu added the editorial label Sep 24, 2025
Co-authored-by: Kristina <52878547+Sakurann@users.noreply.github.com>
@Sakurann Sakurann merged commit c4f3794 into main Oct 2, 2025
2 checks passed
@Sakurann Sakurann added this to the 1.0 Final milestone Oct 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Do we need to say requirements in Browser API sections apply to OS/browser/platform/... too?

4 participants