1.0.2 • Published 10 months ago

@authguard/react v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

Installation

First, install @authguard/react from npm:

npm install @authguard/react
yarn add @authguard/react

Now create a file authguard.ts in root directory:

import { initializeAuthguard, Provider } from "@authguard/react";

export const authguardConfig = {
  // Props
};

initializeAuthguard(authguardConfig);
export default Provider;

Below are the available props with their datatypes.

PropsType
oidc_urlStringoptional
jwks_urlStringoptional
token_urlStringoptional
redirect_urlStringoptional
authorize_urlStringoptional
user_info_urlStringoptional
refresh_token_urlStringoptional
revoke_token_urlStringoptional
grantStringoptional
scopeStringoptional
credentialsObject (client_id,client_secret)optional

Usage

To be able to use useAuthguard first you'll need to expose the authguard context, , at the top level of your application:

React

<React.StrictMode>
  <AuthguardProvider>
    <App />
  </AuthguardProvider>
</React.StrictMode>

Next JS

<AuthguardProvider>
  <Component {...pageProps} />
</AuthguardProvider>

Hook

The useAuthguard() React Hook in the client is the easiest way to check if someone is signed in.

import { useAuthguard } from "@authguard/react";
const { user, logout } = useAuthguard();

References

Follow links are some reference projects that have already setup authguard.

Authguard with React Application Authguard with Next JS Application

License

This software is released under the MIT license. See LICENSE for more details.