Include word (“CONDITIONAL”) in the other specs for VC (Verified Credentials)

Issue #2005 resolved
Rajvardhan Deshmukh created an issue

In https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html
”CONDITIONAL” is used for parameters where they exist, given certain conditions.

Would it be a good approach to include this word (“CONDITIONAL”) in the other specs for VC (Verified Credentials) at least?
e.g. in https://bitbucket.org/openid/connect/src/master/openid-4-verifiable-presentations/openid-4-verifiable-presentations-1_0.md

presentation_definition:
CONDITIONAL. A string containing a Presentation Definition JSON object. See (#request_presentation_definition) for more details. This parameter MUST be present when presentation_definition_uri parameter, or a scope value representing a Presentation Definition is not present.
presentation_definition_uri:
CONDITIONAL. A string containing an HTTPS URL pointing to a resource where a Presentation Definition JSON object can be retrieved. This parameter MUST be present when presentation_definition parameter, or a scope value representing a Presentation Definition is not present. See (#request_presentation_definition_uri) for more details.

Comments (10)

  1. Kristina Yasuda

    CONDITIONAL is not an RFC2119 keyword so we are actually trying to avoid using the term CONDITIONAL. I will do a PR replacing CONDITIONAL with OPTIONAL.

  2. Daniel Fett

    We just discussed on the SIOP call that the proposed wording in https://bitbucket.org/openid/connect/pull-requests/604 does not really work, as it described the same element as “OPTIONAL… MUST NOT be present when…”; the MUST NOT contradicts the OPTIONAL. Similar wording is used in other places in the spec, so a more comprehensive PR needs to be prepared after the move to Github.

  3. Kristina Yasuda

    what was the alternative wording suggested, which was also adopted in ekyc-ida? REQUIRED. MUST NOTE be present when.. which is also kind of contradictory - required, but must not….

  4. Daniel Fett

    Anything that does not introduce contradictions works… e.g.:

    REQUIRED if ….; MAY/MUST NOT be present otherwise.

  5. Kristina Yasuda

    ah it is required **IF** that is important. because required. bust must not be present if is contradictory.

  6. Log in to comment