Documentação

Segurança e Conformidade

Ameaças, controles e conformidade específicos das extensões HTTP e emotes

Kill Switch - Segurança e Conformidade

1. Novas Ameaças (HTTP/WiFi)

A adição do protocolo HTTP/WiFi introduz novas ameaças que precisam ser mitigadas:

Ameaças Identificadas

AmeaçaCategoriaImpactoProbabilidadeMitigação
Spoofing de Sinal HTTPSpoofingAcionamento falsoMédiaRede interna, sem auth
Replay Attack HTTPTamperingAcionamento repetidoMédiaMáquina de estados
Perda de Conexão WiFiDoSFalha de comunicaçãoMédiaFallback para Serial
Injection em HTTPInjectionComando maliciosoBaixaValidação de estado
Eavesdropping HTTPInformation DisclosureExposição de dadosMédiaRede interna

Matriz de Risco

AmeaçaSeveridadeDetectabilidadeScorePrioridade
Perda de Conexão WiFiALTAFácil7/10ALTA
Spoofing HTTPALTAMédia6/10ALTA
Replay Attack HTTPMÉDIAFácil4/10MÉDIA

2. Controles de Segurança

Controles Implementados

ControleTipoImplementaçãoStatus
Máquina de Estados HTTPPreventivoValidação de transições
Rate Limiting EmotesPreventivo20s entre requisições
Rede InternaPreventivoWiFi Unitree isolada
Detecção de AnomaliasDetectivoMonitoramento de taxa
Logging EstruturadoDetectivoEventos com trace_id

3. Monitoramento

Novos Eventos

EventoSeveridadeDescriçãoAção
KILL_SWITCH_ACTIVATED_HTTPCRITICALKill Switch acionado via HTTPAlerta imediato
KILL_SWITCH_RELEASED_HTTPHIGHKill Switch liberado via HTTPLog
EMOTE_TRIGGEREDMEDIUMEmote acionadoLog
RATE_LIMIT_EXCEEDEDLOWLimite de taxa de emote excedidoLog
HTTP_SERVER_ERRORHIGHErro no servidor HTTPInvestigação
WIFI_DISCONNECTEDCRITICALPerda de conexão WiFiAlerta

Esquema de Logs

{
  "timestamp": "2025-12-18T10:30:45.123Z",
  "trace_id": "550e8400-e29b-41d4-a716-446655440000",
  "event.category": "kill-switch",
  "event.source": "http",
  "event.type": "activation",
  "severity": "CRITICAL",
  "message": "Emergency stop button activated via HTTP",
  "http.method": "POST",
  "http.path": "/emergency/press",
  "http.status": 200,
  "client.ip": "192.168.1.100",
  "operator_id": "op-001"
}

4. Conformidade

Alinhamento com NIST CSF

O desinvolvimento dessa sprint se mantém alinhado com NIST CSF:

FunçãoAtividadeImplementação
IdentifyAsset InventoryServiços HTTP registrados
ProtectAccess ControlRede WiFi interna
DetectAnomaly DetectionSIEM monitora eventos HTTP
RespondIncident ResponsePlaybooks KS-002 e KS-003
RecoverRecovery ProceduresFailover automático para Serial

Conformidade com Padrões

PadrãoSeçãoConformidade
ISO 13849-1Safety-related control systemsMantém PLd
IEC 61508Functional safetyMantém SIL 2
OWASP Top 10Web Application SecurityCompleto
CIS ControlsCritical Security ControlsCompleto (v8)

5. Testes

Testes de Segurança

  • Validação de máquina de estados HTTP
  • Teste de rate limiting para emotes
  • Teste de failover WiFi → Serial
  • Validação de replay attack
  • Teste de injection em endpoints

Testes de Integração

  • Dual-channel simultâneo (Serial + HTTP)
  • Sincronização de estado entre canais
  • Prioridade de canais
  • Recuperação de falhas