oneauth-oauth2

Authenticate users via OneAuth OAuth2/OIDC with PKCE and token management.

1|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill oneauth-oauth2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oneauth-oauth2
Source: https://github.com/H2OSLabs/SynnovatorZero/tree/main/.claude/skills/oneauth-oauth2
Command: npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill oneauth-oauth2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies implementing OAuth2/OIDC-based user authentication by integrating OneAuth as a gateway between clients and Hydra/Kratos, handling login, token management, and UI customization.

Core Features & Use Cases

  • Unified OAuth2/OIDC authentication with OneAuth proxy for secure identity and access management.
  • PKCE-enabled Web OAuth2 Authorization Code flow with secure token handling.
  • UI customization and multi-platform support (Web, mini-program, CLI).
  • Token management (login, logout, refresh, verify, revoke) across platforms.

Quick Start

Deploy OneAuth components, register a client with Hydra/Kratos, and initiate login by redirecting to the OneAuth proxy OAuth2 authorization endpoint. Then exchange the authorization code for tokens via the OneAuth API and securely store tokens.

Frequently Asked Questions about oneauth-oauth2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement OAuth2 login with PKCE for web and mobile apps?

OAuth2 login with PKCE is implemented by redirecting users to the OneAuth authorization endpoint, then exchanging the returned code for tokens via the API. This enforces secure PKCE flows for web, mobile, and CLI clients.

What is OneAuth OAuth2 and how does it handle session management?

OneAuth OAuth2 is a proxy gateway integrating Hydra and Kratos to authenticate users via OIDC. It handles session management by providing token exchange, refresh, verify, and revoke operations across multiple platforms.

Does this OneAuth OAuth2 integration support CLI clients and mini-programs?

Yes, OneAuth OAuth2 integration supports CLI clients and mini-programs alongside web and mobile platforms. It provides unified authentication, token management, and UI customization across all these environments.

How do I manage token refresh and revocation with Hydra and Kratos?

Manage token refresh and revocation through the OneAuth API, which proxies Hydra and Kratos. It enables secure token handling, allowing applications to programmatically refresh, verify, and revoke user sessions.

What is the best way to customize the login UI for an OIDC authentication flow?

The best way to customize the login UI for OIDC flows is using OneAuth's multi-platform UI customization features. This allows you to tailor the authentication interface while maintaining secure PKCE token handling.

Do I need to deploy Hydra and Kratos before using OneAuth for authentication?

Yes, you must deploy OneAuth components and register a client with Hydra and Kratos before initiating login. This setup allows OneAuth to act as the proxy gateway for OAuth2 and OIDC identity verification.