devauth v0.0.3
The repository includes the zuauth package along with a documented example demonstrating how to create an authentication system using NextJS and IronSession. Use the demo and refer to the tutorial section below to understand how to integrate zuauth into your app. |
|---|
🛠 Install
Install the zuauth package with npm:
npm i zuauthor yarn:
yarn add zuauth📜 Tutorial
!NOTE
The example in the repository usesiron-sessionto manage sessions, but you are of course free to integrate your preferred solution.
Server
First, you need to create the server-side logic to generate a session nonce and perform the authentication. The example in this repository includes four functions: login, logout, nonce, and user. Remember to add all necessary checks in your login function, particularly ensuring that the ticket has been issued by Zupass and that it is among the supported tickets.
Client
Next, you can proceed with the client side.
- Create a page for the Zupass popup:
- Create another page and define the default set of ticket fields to reveal.
- Check if the user is logged-in.
- Create a function to login, which generates a nonce and user's PCD:
- Check when the PCD is generated and returned by the Zupass popup to call the login API:
!IMPORTANT
When the user interacts with the Zupass popup, the output, which is the generated PCD, is not returned by any function but can be found in thepcdstate variable within theuseZuAuthhook. It's important to check if the value is defined.
- Create a function to allow users to log out:
- Create your UI:
6 months ago