Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

SSO empresarial y SCIM

Inicio de sesión federado por SAML 2.0/OIDC con JIT provisioning y sincronización de usuarios/grupos por SCIM 2.0 — activados bajo pedido.

En esta página (12)

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 503 y la de SCIM responde 503 en 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)#

  1. 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.

  2. 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.

  3. 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.

  4. 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 · rutaEfecto
GET /Users (+?filter=)lista miembros (filtro userName/externalId eq)
POST /Usersprovisiona 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 /ServiceProviderConfigdiscovery (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
  }'

Resultado esperado#

  • El inicio de sesión SSO crea/reutiliza al miembro (JIT) y abre la sesión.
  • POST /Users responde 201 con el recurso SCIM del miembro.
  • La desactivación en el IdP se refleja en el miembro disabled en 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/orgId del 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íntomaCausa probableQué hacer
503 en SSO/SCIMno activado en el entornosolicite la activación del SCIM en el entorno
401 en SCIMtoken no es un service principal válidouse Authorization: Bearer sp_live_…
Persona entra con rol incorrectogrupo del IdP no mapeadoajuste el mapa de grupos → roles
La desactivé en el IdP y la persona desaparece de la listacomportamiento esperado (desactivación)el miembro queda disabled; los datos se preservan

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados