idp-onboarding

Guides non-developers through integrating Overlens SSO login into web, mobile, and service systems.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Connecting a website, app, or service to Overlens login requires OAuth expertise that founders, product owners, and non-technical users do not have. This Skill acts as the entry point: it interviews the user in plain language, detects the tech stack from the repository, and routes the integration to the correct specialist guide without requiring any jargon knowledge. ## Core Features & Use Cases - Guided interview and stack detection: Asks one plain-language question at a time and inspects repository files (next.config, vite.config, app.json, nest-cli.json) to identify the system type before routing. - Routing to specialist guides: Directs the integration to the right path for Next.js, Vite SPA with backend, generic web frameworks, mobile apps, token-validating APIs, machine-to-machine services, or generic OIDC libraries. - OAuth client registration request generation: Produces a validated POST /admin/clients JSON payload plus a ready-to-send pt-BR message for the Overlens team to register the production client. - Sandbox-first verification loop: Integrates against the hosted test environment with fixture credentials, runs a conformance test suite and a doctor check, and ends with a production-readiness checklist. - Use Case: A site owner says "quero adicionar login da Overlens no meu sistema"; the wizard detects a Next.js app, collects the production and localhost URLs, generates the registration request, and drives the integration until tests pass. ## Quick Start Tell the assistant you want to add Overlens login to your system and answer its questions one at a time.

Frequently Asked Questions about idp-onboarding

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

FAQPage Schema
How do I add Overlens login to my website or app?

Start with the onboarding wizard: describe your system in plain language and it detects your stack from the repository files. It then routes you to the correct integration guide for Next.js, Vite, mobile, or other frameworks and generates the client registration request.

How do I register an OAuth client with the Overlens team?

The wizard collects your system name, production and localhost URLs, and signup policy, then produces a validated POST /admin/clients JSON payload plus a ready-to-send pt-BR message. The Overlens team replies with the client_id and client_secret.

Can I develop and test before the production client is registered?

Yes. Development targets the hosted sandbox at https://idp-test.overlens.com.br, which provides fixture clients for confidential, public, and M2M integrations plus a test user. You swap in real credentials only at the production flip with no code changes.

Which integration path applies to my tech stack?

Next.js App Router apps use the Next.js guide, Vite SPAs with a separate backend use the BFF guide, mobile apps and backend-less SPAs use the public PKCE guide, APIs that only validate tokens use the token validation guide, and userless services use the M2M guide.

How do I prove my Overlens integration is correct before going live?

Run the drop-in conformance test suite against your integration until it passes, then run the doctor check against the sandbox issuer. After receiving production credentials, re-run the doctor check against the production issuer and complete the readiness checklist.