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

# Sessões de acesso de suporte

> Como o suporte ao cliente da Truthlocks acessa seu locatário com sessões de personificação com escopo e tempo limitado.

Quando você entra em contato com o suporte da Truthlocks e a solução de problemas requer acesso ao seu locatário, a equipe de suporte usa **sessões de personificação** — sessões com tempo limitado e escopo restrito que são totalmente registradas em seu log de auditoria.

## Como funciona

**1. O suporte cria uma sessão**

Um membro da equipe de suporte cria uma sessão de personificação especificando seu
locatário, os escopos de permissão necessários, um TTL e um motivo para o acesso.
As sessões podem, opcionalmente, ser restritas a uma organização específica dentro do seu
locatário.

**2. A sessão é limitada no tempo**

Cada sessão tem um tempo de vida (TTL) configurável entre 1 e 60
minutos (o padrão é 15 minutos). Quando o TTL expira, o acesso é revogado
imediatamente — nenhuma ação manual é necessária.

**3. Ações são registradas**

Cada solicitação HTTP que o membro da equipe de suporte faz durante a sessão é
registrado em um log de acesso dedicado com o método, caminho, código de status,
e ID da solicitação. Esses eventos também aparecem no seu locatário
[registro de auditoria](https://docs.truthlocks.com/pt/security/audit.md).

## Propriedades da sessão

| Propriedade | Descrição |
| :- | :- |
| **Inquilino** | O inquilino ao qual a sessão concede acesso. |
| **Organização** | *(opcional)* Uma organização específica dentro do inquilino. Quando definido, o acesso é restrito apenas aos dados dessa organização. |
| **Escopos** | As permissões concedidas para a sessão. O padrão é `read_only` se nenhuma for especificada. |
| **TTL** | Tempo de vida em minutos (1–60, padrão 15). |
| **Razão** | Uma explicação legível por humanos do motivo pelo qual a sessão foi criada (mínimo de 10 caracteres). |
| **Status** | `ACTIVE` (em uso), `EXPIRED` (TTL atingido) ou `REVOKED` (encerrado manualmente). |
| **Endereço IP** | O endereço IP do membro da equipe de suporte que criou a sessão. |
| **User-Agent** | O navegador ou cliente usado pela equipe de suporte. |
| **Emitido em** | Quando a sessão foi criada. |
| **Expira em** | Quando a sessão expira automaticamente, com base no TTL. |

## Ciclo de vida da sessão

* **Ativo** — a sessão está em uso e o membro da equipe de suporte tem acesso aos escopos concedidos.
* **Expirado** — o TTL foi atingido e o acesso é automaticamente revogado.
* **Revogado** — um administrador da plataforma encerrou a sessão mais cedo. A identidade do administrador e um motivo de revogação opcional são registrados.

## Revisando a atividade de suporte

### Registro de auditoria

Toda a atividade da sessão de suporte aparece no [log de auditoria](https://docs.truthlocks.com/pt/security/audit.md) do seu locatário. Filtre pela categoria de evento `support_session` para ver exatamente o que foi acessado e quando.

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

Cada evento de auditoria inclui o ID da sessão, a identidade do membro da equipe, a ação realizada e um carimbo de data/hora.

### Logs de acesso por sessão

Você também pode recuperar um log de acesso detalhado para uma sessão específica. Cada entrada registra o método HTTP, o caminho da solicitação, o código de status da resposta e um ID de solicitação exclusivo.

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

## Controles de segurança

> [card] Acesso restrito
>
> As sessões são restritas a escopos de permissão específicos e, opcionalmente, a um
> organização única. O suporte não pode acessar recursos fora do endereço IP e User-Agent do membro da equipe concedido.
> escopos.

> [card] Tempo limitado
>
> Cada sessão expira automaticamente com base em seu TTL (1 a 60 minutos).
> Não há concessões permanentes de acesso ao suporte.

> [card] Trilha de auditoria completa
>
> Cada solicitação HTTP é registrada no log de acesso da sessão com o
> endereço IP e User-Agent do membro da equipe.

> [card] Revogável
>
> Sessões ativas podem ser revogadas a qualquer momento por um administrador da plataforma,
> com um motivo opcional.

## Relacionado

> [card] [Registros de auditoria](https://docs.truthlocks.com/security/audit.md)
>
> Visualize e exporte os eventos de auditoria do seu locatário.

> [card] [RBAC](https://docs.truthlocks.com/security/rbac.md)
>
> Entenda as funções e os escopos de permissão.


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