Skip to main content

​
Visão geral

Os eventos webhook de segurança notificam seu SIEM ou ferramentas de monitoramento quando ações de IAM ocorrem no Gu1: ciclo de vida de membros, mudanças de perfis, login/logout, logins falhos, ações admin de senha e certas configurações de segurança. Configure-os como qualquer outro webhook em Configurações → Webhooks e inscreva-se apenas nos eventos security.* necessários.

​
Formato do payload (todos os eventos de segurança)

Cada webhook de segurança usa o envelope padrão mais um payload interno normalizado: 
{
  "event": "security.auth.login_succeeded",
  "timestamp": "2026-06-18T12:00:00.000Z",
  "organizationId": "550e8400-e29b-41d4-a716-446655440000",
  "payload": {
    "actionAt": "2026-06-18T12:00:00.000Z",
    "actor": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "email": "admin@example.com",
      "displayName": "Jane Admin"
    },
    "affectedUser": {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "email": "user@example.com",
      "displayName": "John User"
    },
    "description": "User logged in successfully",
    "changes": {
      "permissions": {
        "added": ["entities:write"],
        "removed": [],
        "current": ["entities:read", "entities:write"]
      }
    },
    "context": {
      "ipAddress": "203.0.113.10",
      "userAgent": "Mozilla/5.0 ...",
      "scope": "sandbox",
      "roleId": "uuid",
      "roleName": "Analyst"
    }
  }
}
CampoDescrição
actionAtData/hora da ação (ISO 8601)
actorUsuário que executou a ação (id = UUID na DB Gu1 quando disponível)
affectedUserUsuário afetado (quando aplicável)
descriptionResumo legível
changesMapa de campos alterados. Permissões de papel: { added, removed, current }. Outros campos: { previous, current }.
contextIP, user agent, escopo de settings, metadados de perfil

​
Eventos disponíveis

​
Membros (security.member.*)

EventoQuando dispara
security.member.invitedAdmin convida novo membro
security.member.createdMembro aceita convite / é criado na org
security.member.removedMembro removido da organização
security.member.activatedMembro habilitado / reativado
security.member.deactivatedMembro desabilitado
security.member.profile_updatedAdmin atualiza nome (firstName / lastName)
security.member.password_resetAdmin redefine senha do membro
security.member.password_generatedAdmin gera senha temporária
security.member.team_addedMembro adicionado a uma equipe
security.member.team_removedMembro removido de uma equipe
security.member.team_role_changedPapel do membro dentro da equipe muda
security.member.channel_grantedAcesso concedido a um canal (org filha)
security.member.channel_revokedAcesso revogado a um canal
security.member.environment_grantedAcesso concedido ao ambiente production ou sandbox
security.member.environment_revokedAcesso revogado ao ambiente production ou sandbox
context.teamType (ex.: production, sandbox) e context.teamRole aplicam-se a eventos de equipe. Para acesso a ambientes, context.environment é "production" ou "sandbox", com context.environmentOrganizationId e context.environmentOrganizationName. Webhooks de canal disparam no contexto da org pai; context.channelOrganizationId identifica o canal.

​
Perfis e RBAC (security.role.*, security.rbac.*)

EventoQuando dispara
security.role.createdPerfil granular criado
security.role.updatedPerfil modificado (inclui diff de permissões quando houver)
security.role.deletedPerfil excluído
security.role.assignedPerfil atribuído a usuário
security.role.revokedPerfil revogado de usuário
security.rbac.granular_toggledRBAC granular habilitado ou desabilitado

​
Autenticação (security.auth.*)

EventoQuando dispara
security.auth.login_succeededLogin bem-sucedido (web Gu1)
security.auth.logoutLogout
security.auth.login_failedTentativa falha (quando o e-mail resolve para uma org)

​
Configurações de segurança

EventoQuando dispara
security.settings.updatedModo sandbox, settings gerais/risco ou outras mudanças auditadas (context.scope indica a área)

​
Limitações

Não são cobertos hoje pelos webhooks de segurança Gu1:
  • Alteração de senha self-service do usuário no Clerk (somente IdP)
  • Mudanças MFA / SSO no Clerk
  • Autenticação API key M2M (distinta do login de usuário)
  • Revogações de sessão feitas apenas no dashboard Clerk
Reset/geração de senha por admin são cobertos via security.member.password_*.

​
Relacionado