If you're using JSON Web Tokens (JWTs) for authentication with HelpDocs, we've got a neat little tool called JWT Studio that can make your life a whole lot easier.
With JWT Studio, you can create and validate JWTs right from our dashboard: no more mucking around with complicated code or third-party tools.
Let's dive in and see how it works!
Creating a JWT
You'll need to enable JWT first. If it isn't on, you won't see this option.
- Head to Settings > Sign-in & access
- Scroll down to JWT, then click the β― menu > Create/validate JWTs
- Optional: Under Groups, assign your new JWT a Permission Group. You'll see the groups you have access to
- Under JWT expiration, set an expiry date for the token. It starts at 14 days from now
- Click Generate JWT
- Voila! Your new token is ready to go π Click Copy JWT for the token, or Copy prefilled URL for a link to your docs with the token in it
Making a JWT for one group? Head to Settings > Groups, click Edit on the group, then click Generate a JWT for this group.
Remember the expiry date you set is crucial: you don't want your tokens hanging around forever and potentially getting into the wrong hands π΅οΈ
Validating a JWT
Maybe you've got an existing JWT that you need to check. No problem! JWT Studio's got your back there too. Here's how to find it:
- Head to Settings > Sign-in & access
- Scroll down to JWT, then click the β― menu > Create/validate JWTs
- Click Go to validator
- Paste your JWT into the JWT field and hit Validate JWT
- JWT Studio will tell you whether the token is valid and, if it isn't, show you the error π