Skip to content
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

Fix description of error code for invalid state #182

Conversation

FragLegs
Copy link
Contributor

@FragLegs FragLegs commented Jun 6, 2024

Fixes the language around an invalid state in the Verification event and requests that we add invalid_state to the IANA registry of SET error codes.

Please let me know if this seems like a reasonable format for the IANA request.

@FragLegs FragLegs requested a review from a team as a code owner June 6, 2024 20:51
Copy link
Member

@timcappalli timcappalli left a comment

Choose a reason for hiding this comment

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

LGTM

@FragLegs FragLegs merged commit 3442477 into main Jun 10, 2024
2 checks passed
@FragLegs FragLegs deleted the 171-clarify-expected-response-when-state-is-incorrect-for-verification-event branch June 10, 2024 16:29
@@ -1761,8 +1761,8 @@ sub_id
Upon receiving a Verification Event, the Event Receiver SHALL parse the SET and
validate its claims. In particular, the Event Receiver SHALL confirm that the
value for "state" is as expected. If the value of "state" does not match, an
error response of "setData" SHOULD be returned (see Section 2.3 of
{{RFC8935}} or {{RFC8936}}).
error response with the "err" field set to "invalid_state" SHOULD be returned (see Section 2.4 of
Copy link
Contributor

Choose a reason for hiding this comment

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

@FragLegs I feel we should link 2.3 from RFC8935 or an example

HTTP/1.1 400 Bad Request
Content-Language: en-US
Content-Type: application/json

{
  "err": "invalid_state",
  "description": "verification event contained "state" claim not expected by the reciever"
}


Description

> Indicates that a Verification event contained a "state" claim that does not
Copy link
Contributor

Choose a reason for hiding this comment

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

To align with other SSF error code description, suggesting following

The SSF verification event contained "state" claim not expected by the receiver

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.

Clarify expected response when "state" is incorrect for Verification event
4 participants