Passer au contenu principal
L’intégration Bitwarden vous permet d’ingérer les événements pertinents pour la sécurité de votre organisation Bitwarden, notamment :
  • Authentification des utilisateurs : suivez les tentatives de connexion réussies et échouées, les changements de mot de passe et les événements d’authentification à deux facteurs
  • Activité du coffre : supervisez la création, la consultation et la modification des éléments
  • Gestion de l’organisation : consultez les invitations d’utilisateurs, les changements de rôle et les mises à jour de stratégies
  • Événements Secrets Manager : suivez les accès aux secrets, aux projets et aux comptes machine

Prérequis

Avant de configurer cette intégration, assurez-vous de disposer des éléments suivants :
  1. Une organisation Bitwarden Teams ou Enterprise
  2. Des privilèges de propriétaire (Owner) dans votre organisation Bitwarden
  3. Un accès à la Bitwarden Admin Console
La Bitwarden Public API est disponible uniquement pour les organisations Teams et Enterprise.

Étape 1 : obtenir la clé API de votre organisation

  1. Connectez-vous à votre Bitwarden Web Vault
  2. Ouvrez l’Admin Console à l’aide du sélecteur de produits
  3. Accédez à Settings → Organization info
  4. Faites défiler jusqu’à la section API key
  5. Cliquez sur View API Key (une nouvelle authentification peut être nécessaire)
  6. Copiez le client_id et le client_secret
La clé API de votre organisation donne un accès complet à votre organisation. Gardez-la confidentielle et stockez-la de manière sécurisée. Si vous pensez qu’elle a été compromise, utilisez le bouton Rotate API key pour en générer une nouvelle.

Étape 2 : identifier les URL de vos serveurs

Bitwarden utilise des URL de serveur différentes selon votre mode d’hébergement et votre région :

Hébergement cloud (États-Unis)

Hébergement cloud (UE)

Auto-hébergé

Si vous ne savez pas dans quelle région vous vous trouvez, vérifiez l’URL de connexion à Bitwarden. Les utilisateurs américains se connectent généralement sur vault.bitwarden.com, et les utilisateurs européens sur vault.bitwarden.eu.

Étape 3 : ajouter l’intégration dans Wirespeed

  1. Connectez-vous à Wirespeed et accédez à Intégrations > Ajouter une intégration
  2. Recherchez et sélectionnez Bitwarden
  3. Saisissez les informations suivantes :
    • URL du serveur API : l’URL du serveur API de l’étape 2
    • URL du serveur d’identité : l’URL du serveur d’identité de l’étape 2
    • ID client : le client_id de l’étape 1
    • Secret client : le client_secret de l’étape 1
  4. Cliquez sur Intégrer pour terminer la configuration

Quels événements sont collectés ?

Événements utilisateur

Événements liés à l’authentification et aux comptes :
  • Tentatives de connexion réussies et échouées
  • Changements de mot de passe
  • Activation/désactivation de la connexion en deux étapes
  • Événements de récupération de compte
  • Demandes d’approbation d’appareil

Événements d’éléments

Activité des éléments du coffre :
  • Création, modification et suppression d’éléments
  • Consultation des mots de passe, des champs masqués et des codes de sécurité
  • Copie d’identifiants
  • Utilisation du remplissage automatique
  • Gestion des pièces jointes

Événements de collections et de groupes

Modifications de la structure organisationnelle :
  • Création, modification et suppression de collections
  • Gestion des groupes

Événements d’organisation

Actions administratives :
  • Invitations, confirmations et suppressions d’utilisateurs
  • Attributions de rôles et de groupes
  • Modifications de la configuration SSO
  • Modifications de stratégies
  • Mises à jour des paramètres de l’organisation
  • Exports et purges du coffre

Événements Secrets Manager

Pour les organisations qui utilisent Bitwarden Secrets Manager :
  • Accès, création, modification et suppression de secrets
  • Gestion des projets
  • Modifications des comptes machine

Dépannage

Erreurs d’authentification

Si vous rencontrez des erreurs d’authentification :
  1. Vérifiez que votre client_id et votre client_secret sont corrects
  2. Assurez-vous d’utiliser les bonnes URL de serveur API et d’identité pour votre région ou votre mode d’hébergement
  3. Vérifiez que votre clé API n’a pas fait l’objet d’une rotation depuis la configuration

Aucun événement n’apparaît

Si les événements n’apparaissent pas :
  1. Les événements peuvent mettre quelques minutes à apparaître après la configuration initiale
  2. Vérifiez qu’il y a bien de l’activité dans votre organisation Bitwarden
  3. Assurez-vous que votre organisation dispose d’un abonnement Teams ou Enterprise actif

Limitation du débit

La Bitwarden Public API applique des limites de débit. Si vous atteignez ces limites :
  1. Wirespeed réessaie automatiquement avec un backoff exponentiel
  2. Les événements seront collectés lors du prochain cycle de synchronisation

Ressources supplémentaires