SCIM Provisioning
The operator supports configuring SCIM v2 provisioning endpoints on LiteLLM instances. SCIM enables your Identity Provider (Okta, Azure AD, etc.) to automatically provision and deprovision users and groups.
How It Works
- The operator enables SCIM on the LiteLLM Deployment
- A bearer token is generated (or provided) for authenticating SCIM requests
- LiteLLM exposes SCIM endpoints:
POST /scim/v2/Users— create userGET /scim/v2/Users— list usersPATCH /scim/v2/Users/:id— update userDELETE /scim/v2/Users/:id— deactivate userPOST /scim/v2/Groups— create group/teamGET /scim/v2/Groups— list groupsPATCH /scim/v2/Groups/:id— update group membership
- Your IdP calls these endpoints to sync users and groups
Configuration
Auto-Generated Token
The simplest setup — the operator generates a SCIM token and stores it in a Secret:
yaml
apiVersion: litellm.palena.ai/v1alpha1
kind: LiteLLMInstance
metadata:
name: my-gateway
spec:
scim:
enabled: true
generatedTokenSecretName: litellm-scim-tokenRetrieve the generated token to configure your IdP:
bash
kubectl get secret litellm-scim-token -o jsonpath='{.data.scim-token}' | base64 -dExisting Token
If you prefer to manage the token yourself:
bash
kubectl create secret generic my-scim-token \
--from-literal=token='your-scim-bearer-token'yaml
spec:
scim:
enabled: true
tokenSecretRef:
name: my-scim-token
key: tokenIdP Setup
Azure Entra ID
- In Azure portal, go to your Enterprise Application
- Navigate to Provisioning > Automatic
- Set the Tenant URL to
https://your-litellm-domain/scim/v2 - Set the Secret Token to the SCIM token from the Secret
- Click Test Connection, then Save
- Set the provisioning scope and start provisioning
Okta
- In Okta admin, go to your Application
- Navigate to the Provisioning tab
- Enable SCIM connector
- Set the SCIM connector base URL to
https://your-litellm-domain/scim/v2 - Set Authentication Mode to HTTP Header with the SCIM token
- Enable the desired provisioning features (Create, Update, Deactivate)
SCIM + Team Management
SCIM-provisioned users and groups appear in LiteLLM's database. When using LiteLLMTeam CRDs alongside SCIM:
- Set
memberManagement: ssoto let SCIM handle all memberships - Set
memberManagement: mixedto add CRD-managed members alongside SCIM-provisioned ones
Status
yaml
status:
scim:
configured: true
tokenSecretName: litellm-scim-token