Installation

Last updated 3 months ago

Was this helpful?

Installation

Before starting be aware that oidc-spa does not yet support Next.js projects.

If you are using Next the closer alternative is to use (with if you are using Keycloak). You can refer to .

If you're having issues don't hesitate to !

Let's install in your project:

npm install oidc-spa

yarn add oidc-spa

pnpm add oidc-spa

bun add oidc-spa

Create the silent-sso. file in your public directory:

public/silent-sso.htm

<!doctype html>
<html>
    <body>
        <script>
            parent.postMessage(location.href, location.origin);
        </script>
    </body>
</html>

Doing without the silent-sso.htm file

If for some reasons it's not fesable or practical for you to rely on the silent-sso.htm file it's ok, it will work without it.

Just make sure to

Set publicUrl to undefined when initializing oidc-spa.
Don't use logout({ redirectTo: "home" }) but explicitely tell where you want your users to be redirected after logout using logout({ redirectTo: "specific url", url: "/my-home" }) or use logout({ redirectTo: "current page" }).

NextBasic Usage

Last updated 3 months ago

Was this helpful?