-
Notifications
You must be signed in to change notification settings - Fork 4
Description
This is in regards to the UX for index.html (experienced at the web page https://store.rerum.io). On this page a code or project manager registers to use the API through Auth0 and are given a Refresh Token and an Access Token. These tokens are their key to use the RERUM API through https://store.rerum.io/v1/api/
Registered users can use this page to confirm their registration or get new tokens. This is important because Access Tokens expire regularly and if they are not programmatically refreshed they will need to be manually refreshed at this page.
The desired workflow is as follows.
-
Start by logging in or signing up. This happens when the user clicks a button and they are sent off to Auth0 and come back with a ?code= or an ?error=
-
If the user receives a valid ?code=, the page will inform the user they are authorized to use the RERUM API.
- A valid code can be used to get a new Refresh Token. This is the most important token and users should be informed NOT TO LOSE IT. Refresh Tokens do not expire but are invalided if the user gets a different Refresh Token. Access Tokens that were produced using the old Refresh Token will be invalidated.
- Getting a new Refresh Token automatically triggers getting a fresh Access Token. The Access Token is what the user will use to access the RERUM API. It is important that they do not lose it, but they can always get another one by providing their refresh token. Getting a new Access Token invalidates the old Access Token. Access Tokens expire every 30 days, there is no way for users to change that. If a user has a Refresh Token all they have to do is provide it, they do not have to log in.
Users should not have to scroll around to find their ?code and tokens. Once the users have their tokens they should be able to download them to their machine in a plain text file. No changes to functionality are required and everything on the page is functioning as expected. This is just for an improved User Experience when coming to this page.
This should be done first as the top priority. Ideally it would be completed in one sprint, but two is still good.
- A better result to registration where the user knows what happened, what the ?code= is, and how to get their tokens.
- Update Authorization Status Checker
- Update Access Token Verifier
- Update Access Token Refresher
- Update Refresh Token Getter