Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    oauth callback uri triage

    1

    Diagnose OAuth and OIDC redirect_uri mismatches by comparing request values, registrations, and provider rules.

    Free

    1 useSecurity scanned
    oauth callback uri triage

    oauth callback uri triage

    Example session with this skill installed

    I'm getting a redirect_uri_mismatch in production with Auth0. Request uses https://api.acme.co/auth/callback but the console is set to https://api.acme.co/callback/auth. Which one is right?

    • Read your context and instructions
    • Compiled the oauth callback uri

    I have analyzed the provided URI strings for your Auth0 web application integration. There is a clear path discrepancy between the observed request and the provider registration.

    Status: CONFIRMED URI DIFFERENCE
    Best explanation: The authorization request is targeting a different path than what is whitelisted in the Auth0 dashboard.
    Confidence: High

    URI Comparison Analysis

    ComponentObserved Request (from user)Provider RegistrationMatch
    SchemehttpshttpsYes
    Hostapi.acme.coapi.acme.coYes
    Path/auth/callback/callback/authNo
    Query(none provided)(none provided)N/A

    Evidence and Rules

    String Difference: The path segments are transposed (auth/callback vs callback/auth). OAuth providers require an exact case-sensitive string match for the entire URI.
    2.

    Auth0 Rule: Per Auth0 documentation, the redirect_uri must exactly match one of the URIs listed in the "Allowed Callback URLs" field of your Application settings. Auth0 does not perform partial matching or path wildcards by default for security reasons.

    Next steps
    1.

    Verify App Config: Check your production environment variables (e.g., AUTH0_CALLBACK_URL) to see if /auth/callback is hardcoded there.
    2.

    Update Provider: If /auth/callback is the intended endpoint in your code, update the Auth0 dashboard to include https://api.acme.co/auth/callback.
    3. Check Middleware: Ensure no proxy or middleware is rewriting the path before it reaches your application logic.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    OAuth and OIDC integration failures often stall at the dreaded redirect_uri_mismatch error, where tiny differences in slashes, ports, or encoding break the entire flow. This skill triages these discrepancies by comparing observed request values against provider registrations and framework configurations.

    What it does

    • Divergence analysis identifies exact character-level differences in scheme, host, port, path, and query parameters.
    • Provider rule checking consults documented requirements for specific platforms regarding localhost, native app loopbacks, and trailing slashes.
    • Environment comparison isolates why sign-in works in local development but fails in staging or production.
    • Evidence classification distinguishes between actual URI mismatches and unrelated errors like access_denied or state failures.

    How it works

    1. Input collection starts by requesting the sanitized callback sent in the request, the provider registration, and the app's base-URL setting.
    2. Component parsing breaks down the URIs into segments to detect hidden mismatches like percent-encoding or case sensitivity.
    3. Rule validation matches findings against the specific OAuth provider's official documentation for that application type.
    4. Report generation delivers a table of differences and ranked, read-only next steps to resolve the mismatch.

    Frameworks & tools

    This tool works with any OAuth2 or OpenID Connect provider including Google, GitHub, Auth0, Okta, and Microsoft Entra. It supports triage for web and native apps across frameworks like NextAuth, Passport.js, and Spring Security.

    Why this beats prompting it yourself

    Generic prompts often miss subtle provider-specific rules, such as how different platforms handle dynamic ports on localhost or query strings in callbacks. This skill enforces a strict evidence-based workflow that prevents "hallucinated" fixes and focuses on character-perfect string matching.

    Use cases

    • Debugging why a local callback fails after deployment to a load-balanced environment.
    • Resolving port-binding mismatches for mobile or desktop native app authentication.
    • Verifying if a trailing slash or case-sensitive path is causing a provider-side rejection.
    • Confirming if a proxy or ingress controller is stripping the protocol or host during the redirect.

    Known limitations

    Does not perform token exchange, IAM audits, or live account changes. It requires the user to provide sanitized, non-secret string values for comparison.

    Requires sanitized URI strings from the user. Does not access live provider consoles or modify application code. Scope is limited to redirect URI logic, not consent or token exchange.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    • Free with an Agensi account

    Permissions

    No special permissions declared or detected

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    This skill eliminates the manual trial-and-error often associated with 'redirect_uri_mismatch' errors by performing a character-level comparison between your request, your provider settings, and specific platform rules.

    No, this tool is designed for triage only; it analyzes sanitized strings you provide and does not require access to your secret keys, tokens, or live cloud infrastructure.

    Yes, the skill includes specialized logic for various providers like Google and Okta, including how they uniquely handle localhost port variations and trailing slashes.

    It is highly effective for debugging environment-specific issues, such as when a load balancer or reverse proxy alters the protocol (HTTP vs HTTPS) or host headers before they reach your app.

    You will receive the full diagnostic logic, a structured evidence-based workflow, and documentation on how to input URI components for the most accurate results.

    The skill supports any standard OIDC or OAuth2 implementation, including popular libraries like NextAuth, Passport.js, and Spring Security, by focusing on the URI structure they generate.

    New in APIs & Backend