sso-guide

Guide SSO integration with OIDC, header injection, and basic authentication modes.

Updated Jul 10, 2025
One-click install
npx skills add https://github.com/gisikw/fort-nix --skill sso-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sso-guide
Source: https://github.com/gisikw/fort-nix/tree/main/.claude/skills/sso-guide
Command: npx skills add https://github.com/gisikw/fort-nix --skill sso-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive guidance and configuration options for integrating Single Sign-On (SSO) with your services, simplifying authentication management and enhancing security.

Core Features & Use Cases

  • SSO Mode Selection: Guides users through choosing the appropriate SSO mode (none, oidc, headers, basicauth, gatekeeper) based on application capabilities.
  • Configuration Assistance: Offers detailed documentation and examples for each SSO mode, including OIDC, header injection, and basic authentication translation.
  • Use Case: When deploying a new internal application, use this Skill to determine the best SSO strategy, configure oauth2-proxy for header-based authentication, and ensure only authenticated users can access the service.

Quick Start

Use the sso-guide skill to select an SSO mode for a new service.

Frequently Asked Questions about sso-guide

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

FAQPage Schema
How do I choose the right SSO mode for my web application?

Choosing the right SSO mode depends on your application capabilities, selecting from none, oidc, headers, basicauth, or gatekeeper modes. This guidance evaluates your service's authentication support to determine the most secure and compatible access control strategy.

How do I configure oauth2-proxy for header-based authentication?

Configuring oauth2-proxy for header-based authentication involves setting the SSO mode to headers. The Skill provides configuration details and examples for injecting authentication headers, ensuring your service receives validated identity information securely.

What is the difference between OIDC and header injection for access control?

OIDC requires the application to handle the OpenID Connect flow directly, while header injection relies on a proxy to authenticate users and pass identity details via HTTP headers. The best approach depends on whether your app supports native OIDC or needs proxy-level authentication.

Can I use basic authentication translation with my existing APIs?

Yes, basic authentication translation can be used with existing APIs by setting the SSO mode to basicauth. This mode facilitates secure access control by translating authentication tokens into basic auth credentials that your API can process.

Why is my OIDC authentication flow not working during service deployment?

OIDC authentication flow failures often stem from misconfigured modes or app responsibility mismatches. The Skill details common troubleshooting steps for authentication flows, helping identify configuration errors in your access control setup.