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

# Sesiones de acceso de soporte

> Cómo el soporte al cliente de Truthlocks accede a su inquilino con sesiones de suplantación de identidad con tiempo limitado y alcance definido.

Cuando se comunica con el soporte de Truthlocks y la resolución de problemas requiere acceso a su inquilino, el personal de soporte utiliza **sesiones de suplantación** —sesiones con tiempo limitado y alcance restringido que se registran completamente en su registro de auditoría.

## Cómo funciona

**1. El soporte crea una sesión**

Un miembro del personal de soporte crea una sesión de suplantación especificando su
inquilino, los ámbitos de permiso requeridos, un TTL y un motivo para el acceso.
Las sesiones pueden, opcionalmente, estar limitadas a una organización específica dentro de su
inquilino.

**2. La sesión tiene un tiempo limitado**

Cada sesión tiene un tiempo de vida (TTL) configurable entre 1 y 60
minutos (por defecto 15 minutos). Cuando el TTL expira, el acceso es revocado
inmediatamente, sin necesidad de acción manual.

**3. Las acciones son registradas**

Cada solicitud HTTP que el miembro del personal de soporte realiza durante la sesión es
registrado en un registro de acceso dedicado con el método, ruta, código de estado,
y la ID de solicitud. Estos eventos también aparecen en su inquilino
[registro de auditoría](https://docs.truthlocks.com/es/security/audit.md).

## Propiedades de la sesión

| Propiedad | Descripción |
| :- | :- |
| **Inquilino** | El inquilino al que la sesión concede acceso. |
| **Organización** | *(opcional)* Una organización específica dentro del inquilino. Cuando se establece, el acceso se restringe solo a los datos de esa organización. |
| **Ámbitos** | Los permisos concedidos para la sesión. Por defecto es `read_only` si no se especifica ninguno. |
| **TTL** | Tiempo de vida en minutos (1–60, por defecto 15). |
| **Razón** | Una explicación legible por humanos de por qué se creó la sesión (mínimo 10 caracteres). |
| **Estado** | `ACTIVE` (en uso), `EXPIRED` (TTL alcanzado) o `REVOKED` (finalizado manualmente). |
| **Dirección IP** | La dirección IP del miembro del personal de soporte que creó la sesión. |
| **User-Agent** | El navegador o cliente utilizado por el personal de soporte. |
| **Emitido en** | Cuando se creó la sesión. |
| **Expira en** | Cuando la sesión expira automáticamente, según el TTL. |

## Ciclo de vida de la sesión

* **Activo** — la sesión está en uso y el miembro del personal de soporte tiene acceso a los alcances otorgados.
* **Expirado** — se ha alcanzado el TTL y el acceso se revoca automáticamente.
* **Revocada** — un administrador de la plataforma finalizó la sesión antes de tiempo. Se registra la identidad del administrador y una razón de revocación opcional.

## Revisión de la actividad de soporte

### Registro de auditoría

Toda la actividad de la sesión de soporte aparece en el [registro de auditoría](https://docs.truthlocks.com/es/security/audit.md) de su inquilino. Filtre por la categoría de evento `support_session` para ver exactamente qué se accedió y cuándo.

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit?category=support_session" \
  -H "X-API-Key: tl_live_..."
```

Cada evento de auditoría incluye el ID de sesión, la identidad del miembro del personal, la acción realizada y una marca de tiempo.

### Registros de acceso por sesión

También puede recuperar un registro de acceso detallado para una sesión específica. Cada entrada registra el método HTTP, la ruta de la solicitud, el código de estado de la respuesta y un ID de solicitud único.

```json theme={null}
[
  {
    "method": "GET",
    "path": "/v1/attestations",
    "status_code": 200,
    "request_id": "req_abc123",
    "timestamp": "2026-03-26T14:30:00Z"
  }
]
```

## Controles de seguridad

> [card] Acceso con ámbito
>
> Las sesiones están restringidas a alcances de permisos específicos y, opcionalmente, a un
> organización única. El soporte no puede acceder a recursos fuera de los límites concedidos.
> ámbitos.

> [card] Tiempo limitado
>
> Cada sesión expira automáticamente según su TTL (1–60 minutos).
> No hay concesiones permanentes de acceso al soporte.

> [card] Auditoría completa
>
> Cada solicitud HTTP se registra en el registro de acceso de la sesión con el
> dirección IP y User-Agent del miembro del personal.

> [card] Revocable
>
> Las sesiones activas pueden ser revocadas en cualquier momento por un administrador de la plataforma,
> con un motivo opcional.

## Relacionado

> [card] [Registros de auditoría](https://docs.truthlocks.com/security/audit.md)
>
> Vea y exporte los eventos de auditoría de su inquilino.

> [card] [RBAC](https://docs.truthlocks.com/security/rbac.md)
>
> Comprenda los roles y los alcances de los permisos.


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