Skip to main content
skill CX Codex

infisical-sso — Claude Code skill: SSO and user provisioning

infisical-sso — a skill that walks you through connecting Infisical to an identity provider (Google, GitHub, Okta, Azure AD, SAML, OIDC, or LDAP) for human login and automatic account creation.

MIT 237 installs ★ 41 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Infisical/ai-skills --skill infisical-sso -a claude-code
Open on GitHub

What infisical-sso does

The skill guides you through the entire sequence: email domain verification (required), protocol selection (Google and GitHub are free, SAML and OIDC are paid), configuration on both sides, testing login, and only then enabling enforcement. It also covers SCIM for automatic account and group provisioning, syncing IdP groups into Infisical, and mapping groups to roles.

A critical piece: before you enable enforcement, create an administrator account with a password and know about the recovery portal at /login/admin. Otherwise you risk locking yourself out of your own secrets manager. The skill surfaces this upfront to prevent the situation where enforcement is already on but no break-glass path exists.

Group membership only syncs at login time, not continuously. This is the main constraint: if you remove someone from a group in your IdP, Infisical won't know until their next SSO login. The skill explains how to design around this.

What it helps with

  • set up login via SAML or OIDC instead of passwords
  • sync groups from Okta, Azure AD, or another provider into Infisical
  • automatically provision and deprovision user accounts through SCIM
  • map IdP groups to roles in Infisical
  • enable LDAP login for corporate networks

Example prompts for the agent

  • How do I set up SSO in Infisical with Azure Entra ID?
  • We use Okta; how do I sync groups to Infisical via SCIM?
  • I enabled SSO enforcement and now can't log in. How do I get back in?

How to install infisical-sso

1Skills CLI (Vercel)

npx skills add Infisical/ai-skills --skill infisical-sso -a claude-code

2Manually: put the files in place

~/.claude/skills/infisical-sso/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/infisical-sso/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about infisical-sso

How do I install infisical-sso?

Run npx skills add Infisical/ai-skills --skill infisical-sso -a claude-code, then open ~/.claude/skills/infisical-sso/SKILL.md. For other platforms, use the appropriate flag: -a codex for Codex, -a cursor for Cursor, -a gemini-cli for Gemini CLI. On GitHub Copilot, use gh skill install Infisical/ai-skills infisical-sso.

What does infisical-sso do?

It guides you through connecting Infisical to an identity provider (Google, GitHub, Okta, Azure AD, SAML, OIDC, or LDAP) so your team logs in through it and accounts are created automatically. It also covers SCIM provisioning for syncing groups and deprovisioning users on departure.

When should I use Google/GitHub SSO instead of SAML or OIDC?

Google and GitHub SSO are free on all Infisical plans. Use them for lightweight team setups. Choose SAML or OIDC if you need integration with an enterprise provider like Okta, Azure AD, Keycloak, or Auth0 — but these require a paid plan (Cloud Pro or higher).

Source text

SKILL.md · MIT
---
name: infisical-sso
description: "Guide for connecting Infisical to an identity provider for human login and user provisioning. Covers Google and GitHub SSO (free), SAML 2.0 and OIDC (paid) with Okta, Azure/Entra ID, JumpCloud, Google, Auth0, Keycloak, PingOne, GitLab, LDAP login, SCIM user and group provisioning with Okta/Azure/JumpCloud/PingOne/PingFederate, SAML and OIDC group membership mapping, SCIM group to organization role mappings, the mandatory email domain verification prerequisite, SSO enforcement and its effect on password signup, and the /login/admin break-glass portal. Use this skill when someone asks about: Infisical SSO, SAML login, OIDC login, Okta or Azure AD integration, SCIM provisioning, syncing identity provider groups into Infisical, enforcing SSO, or being locked out after enabling SSO. For HUMAN login and user provisioning. Not for machine identity auth methods, including OIDC and LDAP for workloads (infisical-setup), nor for roles and permissions (infisical-access-control)."
---
# Infisical SSO and User Provisioning Guide

You are a setup assistant helping users connect Infisical to their identity provider so humans log
in through it, and so accounts and groups are provisioned automatically.

## Not this skill

The direction and the subject both matter here:

| If the user wants... | Use |
|----------------------|-----|
| **Humans** to log in via an IdP | **this skill** |
| A **workload** to authenticate to Infisical | `infisical-setup` — machine identities |
| Infisical to authenticate **out** to a third party | `infisical-app-connections` |
| To decide **what** a logged-in user can do | `infisical-access-control` |
| LDAP as a **machine identity** auth method | `infisical-setup` |
| An LDAP **App Connection** for rotations | `infisical-app-connections` |
| Dynamic LDAP credentials | `infisical-dynamic-secrets` |

LDAP appears in four different places in Infisical and they are unrelated. Here it means **users
logging in with LDAP credentials**. If the user is talking about a workload or a rotation, route
elsewhere.

Similarly, OIDC here means **human login**. OIDC as a machine identity auth method (for GitHub
Actions, GitLab CI) is `infisical-setup`.

## The prerequisite chain

Get this order right or setup fails partway:

```
1. Email Domain Verification        <- REQUIRED for both SSO and SCIM
        |
        v
2. SAML or OIDC configured          <- REQUIRED before SCIM can be enabled
        |
        v
3. SCIM provisioning
        |
        v
4. Group mappings -> roles
```

- **Email domain verification is required** before users can log in via SSO, and before SCIM provisioning.
- **SCIM can only be enabled once SAML or OIDC is set up** for the organization.

If a user reports that SCIM cannot be enabled, check these two first — it is almost always one of
them rather than a provider misconfiguration.

## What costs what

| Feature | Availability |
|---------|-------------|
| Google SSO | **Free**, cloud and self-hosted |
| GitHub SSO | **Free**, cloud and self-hosted |
| SAML 2.0 | Paid — Cloud **Pro** tier, or enterprise license self-hosted |
| OIDC | Paid — Cloud **Pro** tier, or enterprise license self-hosted |
| SCIM provisioning | Paid — Cloud **Enterprise** tier, or enterprise license self-hosted |

Google and GitHub SSO being free is worth mentioning: a small team that just wants to stop managing
passwords does not need a paid tier.

## Before you enforce SSO: read this

Enforcing SSO **blocks email/password signup for your verified domains**. That is deliberate — a
competing password account would reopen an account-takeover path — but it means:

**Set up a break-glass organization admin with a password and SSO bypass access *before* enabling
enforcement.** After enforcement, you cannot create a new password account on the verified domain to
recover with.

The recovery route if it does happen: the **Admin Login Portal at `/login/admin`** (e.g.
`https://app.infisical.com/login/admin`). Only an **Organization Admin** for that specific
organization can use it. Server Admin status alone does **not** grant this.

Raise this proactively whenever a user mentions enforcing SSO. Being locked out of your own secret
manager is the worst possible outcome of a security improvement.

## How to use this skill

1. **Verify the email domain** — nothing works without it
2. **Choose the protocol** — SAML, OIDC, LDAP, or free Google/GitHub
3. **Configure both sides**, Infisical and the IdP
4. **Test login before enforcing**
5. **Create a break-glass admin with a password**
6. **Then enforce**
7. **Add SCIM** for automatic provisioning and deprovisioning
8. **Map groups to roles** so access follows group membership

## Reference files

| File | When to read |
|------|-------------|
| `references/sso-setup.md` | Protocol choice, supported providers, enforcement, break-glass, PKCE, LDAP login |
| `references/scim-and-groups.md` | SCIM provisioning, group membership mapping for SAML and OIDC, SCIM group to role mappings |

## Guiding principles

- **Verify the email domain first.** It gates everything else.
- **Never enforce SSO without a tested break-glass path.** A password-holding org admin, and knowledge of `/login/admin`.
- **Provision groups, then assign roles to groups.** That is what makes joiners and leavers automatic. See `infisical-access-control`.
- **Group membership only syncs at login.** Removing someone from a group in the IdP does not take effect in Infisical until their next SSO login. This is the most consequential limitation of group mapping — state it explicitly.
- **Enabling group mapping disables manual group management.** Do not enable it while people still rely on manually managed groups.
- **SCIM deprovisioning is the point.** SSO alone stops someone logging in; SCIM removes the account. For offboarding you want both.
- **Never ask for or handle a user's IdP credentials.** Configuration uses metadata, certificates, and client credentials.

© Infisical · MIT · Infisical/ai-skills

Similar skills

All skills for Security →

From the same set17

The whole set →
infisical-secret-rotation infisical-secret-rotation guides the setup of periodic credential replacement across 28 providers, writing updated values directly back to Infisical. CX Codex +1 255installs infisical-secret-scanning Sets an agent up with Infisical Secret Scanning: repo data sources, the infisical scan CLI, pre-commit hooks and tuning to cut noise. CX Codex +1 254installs infisical-kms A guide that walks the agent through Infisical KMS: encrypt, decrypt, sign, verify and HMAC with keys that never leave the platform. CX Codex +1 238installs infisical-pam Guides setup for brokering human and AI agent infrastructure access via Infisical PAM without revealing credentials. CX Codex +1 238installs infisical-gateway A setup skill for Infisical Gateway and Relay: it gets the platform to databases, directories and APIs that sit behind a firewall. Useful when Infisical reports it cannot reach an internal resource. CX Codex +1 238installs infisical-pki infisical-pki guides the setup of Infisical Certificate Management, from issuing X.509 leaf certificates to configuring CAs and syncing with cloud vaults. CX Codex +1 235installs infisical-kubernetes-operator Walks you through the Infisical Kubernetes Operator: secrets synced into Secrets and ConfigMaps, pushed back out, dynamic leases kept in-cluster. CX Codex +1 223installs infisical-setup This Claude Code and Codex skill guides Infisical setup for delivering secrets to apps, containers, and CI/CD. It selects steps for CLI, SDK, Docker, Kubernetes, or machine authentication tasks. CX Codex +1 163installs

Project sponsors

Companies that keep this analytics open