local-oidc-https-proxy

Configure HTTPS reverse proxies for local OIDC providers with TLS termination.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill local-oidc-https-proxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-oidc-https-proxy
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/local-oidc-https-proxy
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill local-oidc-https-proxy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves authentication failures in local development environments where modern browsers reject OIDC session cookies due to the absence of real TLS on localhost, preventing infinite login loops.

Core Features & Use Cases

  • TLS Termination: Configures local reverse proxies to provide valid HTTPS endpoints for OIDC providers.
  • Cookie Policy Compliance: Ensures IdP cookies are correctly marked as Secure and SameSite=None by aligning the browser-facing origin with the application's transport layer.
  • Use Case: When developing with Keycloak or other OIDC providers in a containerized environment, use this skill to configure a YARP proxy that terminates TLS using the .NET development certificate, ensuring seamless authentication flows.

Quick Start

Use the local-oidc-https-proxy skill to configure a secure HTTPS reverse proxy for your local OIDC identity provider.

Frequently Asked Questions about local-oidc-https-proxy

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

FAQPage Schema
Why does OIDC authentication fail in a local development environment?

OIDC authentication fails locally because modern browsers reject session cookies without real TLS on localhost, causing infinite login loops. Configuring a secure HTTPS reverse proxy resolves this by providing valid HTTPS endpoints for browser-compatible cookie handling.

How do I configure an HTTPS reverse proxy for local OIDC development?

Configure an HTTPS reverse proxy for local OIDC by terminating TLS using the .NET development certificate and aligning the browser-facing origin with the application's transport layer. This setup validates transport protocols and ensures seamless authentication flows.

Does Keycloak require TLS for local OIDC session cookies?

Keycloak requires TLS for local OIDC session cookies to ensure browser policy compliance. Without valid HTTPS endpoints, browsers reject cookies lacking Secure and SameSite=None attributes, breaking the local authentication process.

Can I use a YARP proxy with the .NET development certificate for local authentication?

Yes, you can use a YARP proxy with the .NET development certificate to terminate TLS for local OIDC providers. This aligns external authority metadata with internal containerized services, ensuring seamless authentication flows.

What is the best way to fix infinite login loops with local OIDC providers?

The best way to fix infinite OIDC login loops is to configure a local reverse proxy that terminates TLS using a valid development certificate. This ensures IdP cookies are correctly marked as Secure and SameSite=None by aligning the transport layer.

Why are my OIDC session cookies rejected on localhost?

OIDC session cookies are rejected on localhost due to the absence of real TLS. Modern browsers require HTTPS to properly set Secure and SameSite=None cookie attributes, which a local HTTPS reverse proxy provides.