Skip to content

Commit acfba48

Browse files
authored
Add links to claims references, minor grammar fix
This provides an easy-to-access link to get to the spec on what "others" relates to and what public claims exist in the IANA registry.
1 parent f3f0530 commit acfba48

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

views/md/introduction.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,15 +49,15 @@ Then, this JSON is **Base64Url** encoded to form the first part of the JWT.
4949
The second part of the token is the payload, which contains the claims. Claims are statements about an entity (typically, the user) and additional metadata.
5050
There are three types of claims: *reserved*, *public*, and *private* claims.
5151

52-
- **Reserved claims**: These are a set of predefined claims which are not mandatory but recommended, to provide a set of useful, interoperable claims. Some of them are: **iss** (issuer), **exp** (expiration time), **sub** (subject), **aud** (audience), and others.
52+
- [**Reserved claims**](https://tools.ietf.org/html/rfc7519#section-4.1): These are a set of predefined claims which are not mandatory but recommended, to provide a set of useful, interoperable claims. Some of them are: **iss** (issuer), **exp** (expiration time), **sub** (subject), **aud** (audience), and [others](https://tools.ietf.org/html/rfc7519#section-4.1).
5353

5454
> Notice that the claim names are only three characters long as JWT is meant to be compact.
5555

56-
- **Public claims**: These can be defined at will by those using JWTs. But to avoid collisions they should be defined in the IANA JSON Web Token Registry or be defined as a URI that contains a collision resistant namespace.
56+
- [**Public claims**](https://tools.ietf.org/html/rfc7519#section-4.2): These can be defined at will by those using JWTs. But to avoid collisions they should be defined in the [IANA JSON Web Token Registry](https://www.iana.org/assignments/jwt/jwt.xhtml) or be defined as a URI that contains a collision resistant namespace.
5757

58-
- **Private claims**: These are the custom claims created to share information between parties that agree on using them.
58+
- [**Private claims**](https://tools.ietf.org/html/rfc7519#section-4.3): These are the custom claims created to share information between parties that agree on using them and are neither *reserved* or *public* claims.
5959

60-
An example of payload could be:
60+
An example payload could be:
6161

6262
```
6363
{

0 commit comments

Comments
 (0)