idp-test-integration

Scaffolds offline conformance test suites that verify Overlens IDP authentication integrations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @overlens/idp-testing, jose, and includes references (resource) components.

What problem does it solve? After wiring Overlens login or token validation into a project, developers lack a deterministic way to prove the integration actually honors the Overlens contract. This Skill drops in a ready-made test suite that turns "I think it works" into a green pnpm test run — fully offline, with no Docker, no network, and no real IDP. ## Core Features & Use Cases - Resource Server conformance: Wrap your JWT validator in a small adapter and the kit asserts valid tokens are accepted while expired, wrong-audience, HS256/alg:none, unknown-kid, and insufficient-scope tokens are rejected. - Client/BFF conformance: An in-process mock IDP drives your client through login, callback, refresh, and logout, asserting PKCE handling, state-mismatch (CSRF) rejection, code-reuse rejection, and refresh rotation. - Raw testing primitives: Mint valid tokens, forge negative tokens, serve a mock JWKS, or script mock-IDP failures for custom assertions, plus an idp-doctor preflight CLI to catch config drift before pointing at a real environment. - Use Case: You just added an Overlens AuthGuard to a NestJS API. Run this Skill to generate a conformance test that proves your guard accepts valid RS256 tokens and rejects every forged variant — all in Jest or Vitest with zero network calls. ## Quick Start Ask the assistant to add integration tests that prove my Overlens authentication integration is correct.

Frequently Asked Questions about idp-test-integration

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

FAQPage Schema
How do I test my Overlens IDP integration without a real server?

Install @overlens/idp-testing and drop in the conformance suite. It uses a deterministic test keypair and an in-process mock IDP, so all tests run offline with no Docker, no network, and no real IDP.

How do I write conformance tests for OAuth token validation?

Wrap your validator in a small adapter exposing verifyBearer, then call runResourceServerConformance. The kit feeds it valid and forged tokens — expired, wrong audience, HS256, unknown kid — and asserts each is accepted or rejected correctly.

Does @overlens/idp-testing work with Vitest and Jest?

Yes, the package works with both Jest and Vitest. For Vitest, enable globals in vitest.config.ts so the kit can register describe and it blocks; no other setup is required.

Can I test a PKCE public client without a client secret?

Yes, run the client conformance with config clientId 'test-public-pkce' and clientSecret null. The adapter omits client_secret from the token exchange, proving the secret-less PKCE flow and refresh rotation.

When should I not use the integration test scaffolding approach?

Use it only to verify an existing integration, not to build one. For building validation or login flows use the idp-validate-token or idp-auth-* skills; for debugging one failing token use idp-debug-jwt; for HTTP errors use idp-troubleshoot-auth-errors.