> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aprovisionamiento SCIM

> Automatice la gestión del ciclo de vida de usuarios y grupos con SCIM 2.0.

Truthlocks es compatible con SCIM 2.0 para el aprovisionamiento automatizado de usuarios y la gestión de grupos. Conecte su proveedor de identidad (Okta, Azure AD, OneLogin, etc.) para crear, actualizar y desactivar usuarios automáticamente en su inquilino de Truthlocks.

> [!NOTE]
>
> El aprovisionamiento SCIM está disponible en el plan **Business** y superiores.

## Cómo funciona

**1. Generar un token SCIM**

En la consola, ve a **Configuración > SCIM** y genera un token de portador.
Este token autentica las solicitudes SCIM de su IdP.

**2. Configure su IdP**

En tu proveedor de identidad, establece la URL base de SCIM en
`https://api.truthlocks.com/scim/v2` y pegue el token de portador.

**3. Sincronizar usuarios y grupos**

Su IdP envía las creaciones, actualizaciones y desactivaciones de usuarios a Truthlocks
automáticamente. Los cambios en la membresía del grupo actualizan las asignaciones de roles.

## URL base de SCIM

```text theme={null}
https://api.truthlocks.com/scim/v2
```

Todas las solicitudes SCIM deben incluir el token de portador en el encabezado `Authorization`:

```bash theme={null}
curl -X GET https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here"
```

## Operaciones soportadas

### Usuarios

| Operación | Método | Ruta | Descripción |
| - | - | - | - |
| Lista | GET | `/scim/v2/Users` | Listar usuarios con filtro opcional |
| Crear | POST | `/scim/v2/Users` | Aprovisionar un nuevo usuario |
| Obtener | GET | `/scim/v2/Users/{id}` | Recuperar un usuario por ID SCIM |
| Reemplazar | PUT | `/scim/v2/Users/{id}` | Reemplazo completo de usuario |
| Patch | PATCH | `/scim/v2/Users/{id}` | Actualización parcial (por ejemplo, desactivar) |
| Eliminar | DELETE | `/scim/v2/Users/{id}` | Suspender al usuario |

### Grupos

| Operación | Método | Ruta | Descripción |
| - | - | - | - |
| Lista | GET | `/scim/v2/Groups` | Listar grupos |
| Crear | POST | `/scim/v2/Groups` | Crear una asignación de grupo |
| Obtener | GET | `/scim/v2/Groups/{id}` | Recuperar un grupo por ID SCIM |
| Reemplazar | PUT | `/scim/v2/Groups/{id}` | Reemplazar grupo (re-mapea las asignaciones de roles) |
| Patch | PATCH | `/scim/v2/Groups/{id}` | Añadir o eliminar miembros |
| Eliminar | DELETE | `/scim/v2/Groups/{id}` | Eliminar asignación de grupo |

### Descubrimiento

| Método | Ruta | Descripción |
| - | - | - |
| GET | `/scim/v2/ServiceProviderConfig` | Capacidades admitidas |
| GET | `/scim/v2/Schemas` | Esquemas de recursos |
| GET | `/scim/v2/ResourceTypes` | Tipos de recursos disponibles |

## Creación de un usuario

```bash theme={null}
curl -X POST https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "jane@example.com",
    "name": { "givenName": "Jane", "familyName": "Smith" },
    "emails": [{ "value": "jane@example.com", "primary": true }],
    "active": true
  }'
```

## Desactivación de un usuario

Los IdP como Okta y Azure AD envían una solicitud PATCH para desactivar usuarios:

```bash theme={null}
curl -X PATCH https://api.truthlocks.com/scim/v2/Users/{id} \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [{ "op": "replace", "path": "active", "value": false }]
  }'
```

Los usuarios desactivados pierden el acceso inmediatamente, pero sus datos se conservan.

## Gestión de tokens SCIM

Generar y administrar tokens a través de la API de administración:

```bash theme={null}
# Generate a new token
curl -X POST https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Okta SCIM" }'

# List tokens
curl -X GET https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>"

# Revoke a token
curl -X DELETE https://api.truthlocks.com/v1/scim/tokens/<token_id> \
  -H "Authorization: Bearer <admin_token>"
```

## Registro de actividad

Todas las operaciones SCIM se registran en un registro de actividad. Ver eventos de aprovisionamiento recientes:

```bash theme={null}
curl -X GET https://api.truthlocks.com/v1/scim/activity \
  -H "Authorization: Bearer <admin_token>"
```

Los tipos de actividad incluyen `USER_CREATED`, `USER_DEACTIVATED`, `USER_PATCHED`, `GROUP_CREATED`, `GROUP_UPDATED` y `GROUP_DELETED`.

## Aplicación de asientos

La creación de usuarios respeta el límite de asientos de su plan. Si se excediera el límite, el endpoint SCIM devuelve HTTP `402` y el usuario no se crea. Actualice su plan o elimine usuarios inactivos para liberar asientos.

## Filtrado

El parámetro de consulta SCIM `filter` permite que su proveedor de identidad restrinja las respuestas de la lista a usuarios o grupos específicos. Truthlocks admite el filtrado de atributos SCIM específicos utilizando los operadores a continuación.

### Atributos de filtro admitidos

| Atributo | Recurso | Descripción |
| - | - | - |
| `userName` | Usuarios | El identificador de inicio de sesión del usuario (normalmente una dirección de correo electrónico) |
| `displayName` | Usuarios, Grupos | El nombre de visualización del usuario o grupo |
| `externalId` | Usuarios, Grupos | El identificador único asignado por su proveedor de identidad |
| `active` | Usuarios | Si la cuenta de usuario está activa (`true` / `false`) |

### Operadores admitidos

| Operador | Significado | Ejemplo |
| - | - | - |
| `eq` | Es igual a | `userName eq "jane@example.com"` |
| `ne` | No es igual a | `active ne false` |
| `co` | Contiene | `userName co "example.com"` |
| `sw` | Comienza con | `userName sw "jane"` |
| `ew` | Termina con | `userName ew "@example.com"` |

Combine operadores usando `and` / `or` para consultas complejas:

```bash theme={null}
# Find active users whose username contains "example.com"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=active eq true and userName co "example.com"'

# Find users starting with "jane" or "john"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=userName sw "jane" or userName sw "john"'

# Look up a user by their IdP-assigned external ID
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=externalId eq "00u1a2b3c4d5e6f7g8h9"'

# Find a user by display name
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=displayName eq "Jane Smith"'
```

> [!NOTE]
>
> Los resultados filtrados están limitados a 200 elementos por respuesta. Si su IdP sincroniza más de 200 usuarios o grupos, debe paginar usando los parámetros `startIndex` y `count` junto con el filtro.

### Patrones de filtro de IdP comunes

La mayoría de los proveedores de identidad envían filtros automáticamente durante la sincronización. Aquí están los patrones que Truthlocks maneja:

| IdP | Filtro típico enviado |
| - | - |
| Okta | `userName eq "user@example.com"` |
| Azure AD | `userName eq "user@example.com"`, `displayName co "Smith"`, o `externalId eq "id"` |
| OneLogin | `userName sw "user"` o `externalId eq "id"` |

Si su IdP envía un filtro utilizando cualquiera de los atributos y operadores admitidos enumerados anteriormente, Truthlocks lo procesa correctamente. No necesita configurar nada en el lado de Truthlocks.

## Capacidades soportadas

| Capacidad | Compatible |
| - | - |
| Patch | Sí |
| Masivo | No |
| Filtro | Sí — `eq`, `ne`, `co`, `sw`, `ew` en `userName`, `displayName`, `externalId`, `active` con `and` / `or` (máx. 200 resultados) |
| Ordenar | No |
| Cambiar contraseña | No |
| ETag | No |

## Relacionado

* [SAML SSO](https://docs.truthlocks.com/es/security/saml-sso.md) — Autentique usuarios a través de su IdP.
* [RBAC y permisos](https://docs.truthlocks.com/es/security/rbac.md) — Roles asignados a usuarios aprovisionados.
* [Registros de auditoría](https://docs.truthlocks.com/es/security/audit.md) — Rastree todos los eventos de acceso y aprovisionamiento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.