Skip to content

devforth/adminforth-oauth

Repository files navigation

AdminForth OAuth Plugin

License: MIT Build Status npm downloads npm version

Ask AI

Enables OAuth2-based authentication for an adminforth application.

Features

  • Add OAuth2-based authentication to AdminForth.
  • Support external identity providers for sign-in.
  • Reduce friction in authentication workflows.
  • Integrate provider-based auth into the admin panel.
  • Start OAuth flow directly from an external page via ?start_oauth=<provider> query parameter.

Documentation

Full setup and configuration guide:

AdminForth OAuth Documentation

Starting OAuth flow from an external page

If you have an external website with a "Sign in with Google" button that should open the AdminForth OAuth flow directly — without showing the login form first — use the start_oauth query parameter:

https://your-admin.example.com/login?start_oauth=google
https://your-admin.example.com/login?start_oauth=clerk

The value must match the provider name (case-insensitive). AdminForth will immediately redirect the user to the OAuth provider, skipping the login page entirely.

Supported values depend on the providers configured in your plugin setup. The name is derived from the adapter class name — for example AdminForthAdapterOauth2Googlegoogle, AdminForthAdapterOauth2Clerkclerk.

If the specified provider is not found, an error message is shown on the login page. If start_oauth is provided without a value (?start_oauth), nothing happens and the regular login form is displayed.

About AdminForth

AdminForth is an open-source, agent-first admin framework for building robust admin panels and back-office applications faster.

Related links

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors