Saltar al contenido principal
La integración de Bitwarden le permite ingestar eventos relevantes para la seguridad de su organización de Bitwarden, incluidos:
  • Autenticación de usuarios: realice un seguimiento de los intentos de inicio de sesión correctos y fallidos, los cambios de contraseña y los eventos de autenticación de dos factores
  • Actividad del vault: supervise la creación, el acceso y las modificaciones de elementos
  • Gestión de la organización: vea invitaciones de usuarios, cambios de rol y actualizaciones de directivas
  • Eventos de Secrets Manager: realice un seguimiento del acceso a secretos, proyectos y cuentas de máquina

Requisitos previos

Antes de configurar esta integración, asegúrese de disponer de:
  1. Una organización Bitwarden Teams o Enterprise
  2. Privilegios de Owner en su organización de Bitwarden
  3. Acceso a la Bitwarden Admin Console
La Bitwarden Public API solo está disponible para organizaciones Teams y Enterprise.

Paso 1: Obtener la clave API de su organización

  1. Inicie sesión en su Bitwarden Web Vault
  2. Abra la Admin Console con el selector de productos
  3. Vaya a Settings → Organization info
  4. Desplácese hasta la sección API key
  5. Haga clic en View API Key (puede que deba volver a autenticarse)
  6. Copie tanto el client_id como el client_secret
La clave API de su organización proporciona acceso completo a la organización. Manténgala en privado y almacénela de forma segura. Si cree que se ha visto comprometida, use el botón Rotate API key para generar una nueva.

Paso 2: Identificar las URL de sus servidores

Bitwarden usa distintas URL de servidor según su opción de alojamiento y región:

Alojado en la nube (US)

Alojado en la nube (EU)

Autohospedado

Si no está seguro de en qué región se encuentra, compruebe la URL de inicio de sesión de Bitwarden. Los usuarios de US suelen iniciar sesión en vault.bitwarden.com, mientras que los de EU lo hacen en vault.bitwarden.eu.

Paso 3: Añadir la integración en Wirespeed

  1. Inicie sesión en Wirespeed y vaya a Integraciones > Añadir integración
  2. Busque y seleccione Bitwarden
  3. Introduzca la siguiente información:
    • API Server URL: la URL del servidor de API del paso 2
    • Identity Server URL: la URL del servidor de identidad del paso 2
    • Client ID: el client_id del paso 1
    • Client Secret: el client_secret del paso 1
  4. Haga clic en Integrar para completar la configuración

¿Qué eventos se recopilan?

Eventos de usuario

Eventos de autenticación y relacionados con la cuenta:
  • Intentos de inicio de sesión correctos y fallidos
  • Cambios de contraseña
  • Activación/desactivación del inicio de sesión en dos pasos
  • Eventos de recuperación de cuenta
  • Solicitudes de aprobación de dispositivos

Eventos de elementos

Actividad de elementos del vault:
  • Creación, edición y eliminación de elementos
  • Visualización de contraseñas, campos ocultos y códigos de seguridad
  • Copia de credenciales
  • Uso de Autofill
  • Gestión de adjuntos

Eventos de Collection y Group

Cambios en la estructura organizativa:
  • Creación, edición y eliminación de Collection
  • Gestión de Group

Eventos de la organización

Acciones administrativas:
  • Invitaciones, confirmaciones y eliminaciones de usuarios
  • Asignaciones de roles y grupos
  • Cambios de configuración de SSO
  • Modificaciones de directivas
  • Actualizaciones de la configuración de la organización
  • Exportaciones y purgas del vault

Eventos de Secrets Manager

Para organizaciones que usan Bitwarden Secrets Manager:
  • Acceso, creación, edición y eliminación de secretos
  • Gestión de proyectos
  • Cambios en cuentas de máquina

Solución de problemas

Errores de autenticación

Si ve errores de autenticación:
  1. Compruebe que su client_id y client_secret son correctos
  2. Asegúrese de usar las URL correctas de los servidores de API e Identity para su región/alojamiento
  3. Compruebe que su clave API no se ha rotado desde la configuración

No aparecen eventos

Si no aparecen eventos:
  1. Los eventos pueden tardar unos minutos en aparecer tras la configuración inicial
  2. Compruebe que hay actividad en su organización de Bitwarden
  3. Asegúrese de que su organización tiene una suscripción Teams o Enterprise activa

Limitación de velocidad

La Bitwarden Public API tiene límites de velocidad. Si encuentra limitación de velocidad:
  1. Wirespeed reintentará automáticamente con retroceso exponencial
  2. Los eventos se recopilarán en el siguiente ciclo de sincronización

Recursos adicionales