Skip to main content

​
Descripción general

Los eventos webhook de seguridad notifican a su SIEM o herramientas de monitoreo cuando ocurren acciones de IAM en Gu1: ciclo de vida de miembros, cambios de roles, inicio/cierre de sesión, logins fallidos, acciones admin sobre contraseñas y ciertos parámetros de seguridad. Configúrelos como cualquier otro webhook en Configuración → Webhooks y suscríbase solo a los eventos security.* que necesite.

​
Forma del payload (todos los eventos de seguridad)

Cada webhook de seguridad usa el sobre estándar más un 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"
    }
  }
}
CampoDescripción
actionAtFecha/hora de la acción (ISO 8601)
actorUsuario que realizó la acción (id = UUID en DB Gu1 cuando existe)
affectedUserUsuario afectado (cuando aplica)
descriptionResumen legible
changesMapa de campos modificados. Para permisos de rol: { added, removed, current }. Otros campos: { previous, current }.
contextIP, user agent, ámbito de settings, metadata de rol

​
Eventos disponibles

​
Miembros (security.member.*)

EventoCuándo se dispara
security.member.invitedUn admin invita a un nuevo miembro
security.member.createdEl miembro acepta la invitación / se crea en la org
security.member.removedMiembro eliminado de la organización
security.member.activatedMiembro habilitado / reactivado
security.member.deactivatedMiembro deshabilitado
security.member.profile_updatedAdmin actualiza nombre (firstName / lastName)
security.member.password_resetAdmin resetea contraseña del miembro
security.member.password_generatedAdmin genera contraseña temporal
security.member.team_addedMiembro agregado a un equipo
security.member.team_removedMiembro quitado de un equipo
security.member.team_role_changedCambia el rol del miembro dentro del equipo
security.member.channel_grantedSe otorga acceso a un canal (org hija)
security.member.channel_revokedSe revoca acceso a un canal
security.member.environment_grantedSe otorga acceso al ambiente production o sandbox
security.member.environment_revokedSe revoca acceso al ambiente production o sandbox
context.teamType (p. ej. production, sandbox) y context.teamRole aplican en eventos de equipo. Para acceso a entornos, context.environment es "production" o "sandbox", con context.environmentOrganizationId y context.environmentOrganizationName. Para canales, los webhooks se emiten en la org padre; context.channelOrganizationId identifica el canal.

​
Roles y RBAC (security.role.*, security.rbac.*)

EventoCuándo se dispara
security.role.createdRol granular creado
security.role.updatedRol modificado (incluye diff de permisos cuando hay datos)
security.role.deletedRol eliminado
security.role.assignedRol asignado a usuario
security.role.revokedRol revocado de usuario
security.rbac.granular_toggledRBAC granular habilitado o deshabilitado

​
Autenticación (security.auth.*)

EventoCuándo se dispara
security.auth.login_succeededInicio de sesión exitoso (web Gu1)
security.auth.logoutCierre de sesión
security.auth.login_failedIntento fallido (cuando el email resuelve a una org)

​
Configuración de seguridad

EventoCuándo se dispara
security.settings.updatedModo sandbox, settings generales/de riesgo u otros cambios auditados (context.scope indica el ámbito)

​
Limitaciones

No están cubiertos hoy por webhooks de seguridad Gu1:
  • Cambio de contraseña self-service del usuario en Clerk (solo IdP)
  • Cambios MFA / SSO en Clerk
  • Autenticación API key M2M (distinta del login de usuario)
  • Revocaciones de sesión hechas solo en el dashboard Clerk
Las acciones admin de reset/generación de contraseña sí se cubren con security.member.password_*.

​
Relacionado