Skip to content

Commit

Permalink
Merge pull request #26 from IamfromSpace/tighter-datetime-claim-spec
Browse files Browse the repository at this point in the history
Further specify the DateTime claim type.
  • Loading branch information
paragonie-security authored Apr 23, 2022
2 parents 77ca84e + 0ab3bf8 commit 3e80a12
Showing 1 changed file with 7 additions and 1 deletion.
8 changes: 7 additions & 1 deletion docs/02-Implementation-Guide/04-Claims.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,13 @@ arbitrary/invalid data to any keys in a top-level PASETO in the list below:
| `iat` | Issued At | DateTime | `{"iat":"2038-03-17T00:00:00+00:00"}` |
| `jti` | Token Identifier | string | `{"jti":"87IFSGFgPNtQNNuw0AtuLttPYFfYwOkjhqdWcLoYQHvL"}` |

In the table above, DateTime means an ISO 8601 compliant DateTime string.
In the table above, DateTime means a string in [RFC 3339 Section 5.6 Internet Date/Time
Format](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) (a profile of ISO 8601).
Further, date and time MUST be separated with an uppercase "T", and "Z" MUST be capitalized when
used as a time offset. While arbitrary fractional seconds SHOULD be supported in parsers, is
RECOMMENDED to omit them on creation. Time offsets confer no special meaning, so they MUST NOT be
used for validation (beyond determining the correct moment in time). It is RECOMMENDED that all
DateTime claims use "Z" as a time offset.

Any other claims can be freely used. These keys are only reserved in the top-level
JSON object.
Expand Down

0 comments on commit 3e80a12

Please sign in to comment.