Documentação do ClearScreen

Integrações

O ClearScreen liga-se ao seu fornecedor de identidade, ao Intune para a implementação e ao seu circuito de registos.

Início de sessão com Microsoft Entra ID

No plano Business, os utilizadores da consola podem iniciar sessão com o início de sessão único do Microsoft Entra ID através da Spot Suite. Os agentes dos dispositivos nunca usam palavras-passe de utilizadores.

Microsoft Intune

No plano Business, o separador Intune guarda um registo de aplicação do Microsoft Entra para o seu inquilino. O registo de aplicação precisa das permissões de aplicação DeviceManagementConfiguration.ReadWrite.All e Group.Read.All, com consentimento do administrador. O segredo é guardado cifrado e não volta a ser mostrado. Escolha Verificar ligação para o testar.

Para implementar o agente, execute os comandos de instalação do separador Enrollment como script do Intune ou como aplicação Win32. Para uma aplicação Win32, use uma regra de deteção que encontre o serviço:

Get-Service -Name ClearScreen -ErrorAction SilentlyContinue

Fontes de ameaças

O agente filtra com pacotes assinados criados a partir das fontes URLhaus e OpenPhish e das listas de categorias UT1 e StevenBlack. Os pacotes são atualizados a cada 15 minutos. O agente verifica a assinatura Ed25519 antes de usar um pacote e continua a filtrar com o último pacote verificado quando está offline. As consultas permitidas seguem a montante por DoH para o Cloudflare 1.1.1.1.

Exportação de eventos para reencaminhamento de registos

Os eventos de bloqueio podem ser obtidos com um token de exportação. Um administrador cria o token através da API da consola, e este começa por csat_. É mostrado uma só vez e apenas o seu hash é guardado.

curl -H "Authorization: Bearer <export token>" \
  "https://<workspace>.clear-screen.ai/v1/agent/export/events?since=2026-01-01T00:00:00Z"

Uma resposta contém até 500 eventos e os valores a enviar de volta como since e after para ler a página seguinte. Use GET /v1/agent/export/reviews da mesma forma para os relatórios de revisão.