idp-register-oauth-client

Registers OAuth clients in the Overlens IDP via the POST /admin/clients admin API.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/overlens/claude-marketplace --skill idp-register-oauth-client-overlens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idp-register-oauth-client
Source: https://github.com/overlens/claude-marketplace/tree/main/plugins/idp-integration/skills/idp-register-oauth-client
Command: npx skills add https://github.com/overlens/claude-marketplace --skill idp-register-oauth-client-overlens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Every system that authenticates through the Overlens IDP needs a registered OAuth client, but registration only happens through an admin-only API with strict validation rules, and the client secret is shown exactly once. This Skill guides you through registering the client correctly on the first try — or, if you are not an Overlens admin, generates a ready-to-send registration request the Overlens team can apply without edits. ## Core Features & Use Cases - Three client types covered: confidential web (BFF with authorization_code + refresh_token), public PKCE (mobile/SPA with deep links, no secret), and M2M (client_credentials with empty redirectUris), each with the exact POST /admin/clients JSON payload. - Full validation rules: clientId regex, HTTPS/localhost/deep-link redirect URI rules with exact byte matching, allowed grant-type combinations, and the invalid combinations rejected with HTTP 400. - Registration-request mode for non-admins: interviews the user in plain language, validates everything locally, and emits the exact JSON payload plus a short covering message to send to the Overlens team. - Use Case: A developer says "I need a client_id and client_secret for my Next.js app". The Skill collects the callback URLs for production and localhost, builds the confidential-web payload, and either calls the admin API or produces the request for the Overlens team — warning that the secret must be copied immediately into a secret manager. ## Quick Start Ask the assistant to register an OAuth client for your system in the Overlens IDP, describing your app type and callback URLs.

Frequently Asked Questions about idp-register-oauth-client

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

FAQPage Schema
How do I register an OAuth client in the Overlens IDP?

Register an OAuth client by calling POST /admin/clients with a user JWT that has role=ADMIN, sending a JSON payload with clientId, redirectUris, allowedGrantTypes, and allowedScopes. There is no self-service or Dynamic Client Registration, and M2M tokens are rejected by the admin guard.

What is the difference between confidential, public PKCE, and M2M OAuth clients?

Confidential web clients hold a secret on a server and use authorization_code plus refresh_token grants. Public PKCE clients run on user devices with no secret and rely on PKCE S256. M2M clients use client_credentials with empty redirectUris for service-to-service calls.

Can I register an OAuth client without being an Overlens admin?

No, only users with role=ADMIN can call POST /admin/clients. If you are not an admin, the Skill generates a validated JSON payload plus a short covering message to send to the Overlens team, who apply it and return the credentials.

Why does my OAuth client get invalid_redirect_uri errors?

The IDP matches redirect URIs byte-for-byte with no wildcards or trailing-slash normalization, so a registered URI must exactly equal the one your app sends. Register every environment's callback, including http://localhost for development, and PATCH the full redirectUris array to add missing ones.

What happens if I lose the client_secret after registration?

The client_secret is shown exactly once in the creation response and there is no endpoint to read it again. The only recovery path today is deleting and recreating the client, so copy it immediately into a secret manager.

Can an M2M client have redirect URIs or be public?

No, M2M clients using client_credentials must have an empty redirectUris array and must be confidential. Both combinations are rejected with HTTP 400 at registration, and allowSignup must be false since no user flow exists.