SSO (SAML 2.0 + OIDC) y SCIM 2.0 quedan apagados hasta que se activen para su organización. Para activarlos, hable con soporte.
Integre ingestia.io con el proveedor de identidad (IdP) de su empresa: inicio de sesión único (SSO) y provisionamiento/desaprovisionamiento automático de personas (SCIM).
Qué es#
- SSO (SAML 2.0 / OIDC): la persona inicia sesión a través del IdP corporativo (Okta, Microsoft Entra ID, Google Workspace…) sin contraseña local. Con JIT provisioning, el primer inicio de sesión ya crea el miembro en el workspace.
- SCIM 2.0: el IdP empuja la creación, actualización y desactivación de usuarios (y mapea grupos → roles) hacia ingestia.io, manteniendo la base sincronizada.
Para qué sirve#
- Centralizar el acceso en el IdP (una persona sale de la empresa → pierde el acceso).
- Estandarizar roles por grupo del IdP (ej.: grupo "BI-Admins" → rol
admin). - Auditar entradas/salidas de personas sin trabajo manual.
Plan y permisos#
- Plan: a partir de Scale (activado a pedido) — ver Planos.
- Quién configura: owner del workspace /
org_admin, junto al operador de la plataforma (envs del IdP). - Autenticación del SCIM: por service principal (token
sp_live_…) — no es una clave de datos. El alcance del provisionamiento es siempre el workspace/org del propio service principal, nunca tomado de la URL/cuerpo (anti entre clientes).
Pre-requisitos#
- IdP con soporte para SAML 2.0 u OIDC y (para sincronizar) SCIM 2.0.
- SSO activado en el entorno (se debe provisionar el secreto de handshake). Sin
esto, la ruta de SSO responde
503y la de SCIM responde503en producción — nunca finge provisionar. - Para SCIM: la activación de SCIM en el entorno (realizada por nosotros) y, opcionalmente, el mapa de grupos de su IdP a roles del producto.
Paso a paso (visión general)#
Ligar o SSO no ambiente
O operador provisiona o segredo de handshake e as configurações do IdP. Enquanto não ligado, o SSO fica inerte (503) — pode ser implantado sem ativar nada.
Configurar o IdP
No IdP, cadastre o ingestia.io como aplicação SAML/OIDC. Defina o mapeamento de atributos (e-mail, nome) e os grupos que virarão papéis.
Ativar o SCIM (opcional)
Peça a ativação do SCIM e gere um service principal para o IdP usar como token Bearer no endpoint SCIM. Configure o mapa de grupos → papéis.
Testar entrada e saída
Faça um login de teste (JIT cria o membro) e uma desativação no IdP (SCIM desativa o membro no ingestia — nunca apaga dados).
Endpoint SCIM (referencia)#
Base: https://ingestia.io/api/scim/v2 · Content-Type application/scim+json.
| Método · ruta | Efecto |
|---|---|
GET /Users (+?filter=) | lista miembros (filtro userName/externalId eq) |
POST /Users | provisiona miembro (rol resuelto por los grupos) |
PUT /Users/{id} | reemplaza atributos del miembro |
PATCH /Users/{id} | active:false → desactiva (desaprovisionamiento seguro) |
DELETE /Users/{id} | desaprovisionamiento seguro → desactiva (nunca borra datos) |
GET /Groups · PATCH /Groups/{id} | grupos mapeados; add → rol del grupo, remove → viewer |
GET /ServiceProviderConfig | discovery (sin efecto) |
El desaprovisionamiento es siempre no destructivo
DELETE y PATCH active:false desactivan al miembro (pierde el acceso de inmediato),
pero nunca borran datos. La eliminación de datos es un flujo separado y explícito
de exclusión de datos.
Ejemplo (SCIM — sintético)#
curl -X POST https://ingestia.io/api/scim/v2/Users \
-H "Authorization: Bearer sp_live_EXEMPLO" \
-H "Content-Type: application/scim+json" \
-d '{
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
"userName": "ana@example.com",
"displayName": "Ana Souza",
"active": true
}'await fetch("https://ingestia.io/api/scim/v2/Users", {
method: "POST",
headers: {
Authorization: "Bearer sp_live_EXEMPLO",
"Content-Type": "application/scim+json",
},
body: JSON.stringify({
schemas: ["urn:ietf:params:scim:schemas:core:2.0:User"],
userName: "ana@example.com",
displayName: "Ana Souza",
active: true,
}),
});import requests
requests.post(
"https://ingestia.io/api/scim/v2/Users",
headers={
"Authorization": "Bearer sp_live_EXEMPLO",
"Content-Type": "application/scim+json",
},
json={
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
"userName": "ana@example.com",
"displayName": "Ana Souza",
"active": True,
},
)Resultado esperado#
- El inicio de sesión SSO crea/reutiliza al miembro (JIT) y abre la sesión.
POST /Usersresponde201con el recurso SCIM del miembro.- La desactivación en el IdP se refleja en el miembro
disableden ingestia (acceso cortado).
Seguridad#
- Fail-closed: sin service principal válido →
401, sin tocar datos; SCIM no activado en producción →503(nunca finge). - Alcance por el SP: todo efecto usa el
workspaceId/orgIddel propio service principal — un IdP no provisiona en una org ajena. - Owner protegido: el rol del propietario no se degrada por la sincronización de grupos.
- Rol por grupo: grupo desconocido en el mapa →
viewer(menor privilegio).
Límites#
- SCIM cubre Users y Groups (mapa grupo → rol); no existe un esquema personalizado de atributos de negocio por esta vía.
- Los grupos SCIM mapean roles, no atributos de RLS (atributos por fila se definen en el perfil del miembro).
Errores comunes y cómo resolverlos#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
503 en SSO/SCIM | no activado en el entorno | solicite la activación del SCIM en el entorno |
401 en SCIM | token no es un service principal válido | use Authorization: Bearer sp_live_… |
| Persona entra con rol incorrecto | grupo del IdP no mapeado | ajuste el mapa de grupos → roles |
| La desactivé en el IdP y la persona desaparece de la lista | comportamiento esperado (desactivación) | el miembro queda disabled; los datos se preservan |
Relacionados#
Última revisión: 2026-09-08.