Bitwarden Password Manager

This integration collects event logs from Bitwarden Password Manager to Cortex XSIAM.

Analytics & SIEM · Bitwarden Password Manager

Details

IDBitwarden Password Manager
ProviderBitwarden
CategoryAnalytics & SIEM
From Version8.6.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesXSIAM

README

This integration collects event logs from Bitwarden Password Manager to Cortex XSIAM.
This integration was integrated and tested with version 2024.6.2 of Bitwarden Password Manager.

Configure Bitwarden Password Manager in Cortex

Parameter Required
Server URL (e.g., https://example.bitwarden.com) True
Self-hosted Bitwarden Instance False
Client ID True
Client Secret True
Trust any certificate (not secure) False
Use system proxy settings False
Maximum number of events per fetch False

Note: Enable the “Self-hosted Bitwarden Instance” parameter if you are using a self-hosted Bitwarden server. For self-hosted instances, the authentication endpoint will be constructed from your Server URL (e.g., https://your-domain.com/identity/connect/token). For cloud-hosted instances (default), the integration uses Bitwarden’s cloud authentication endpoints.

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

bitwarden-get-events


Gets events from Bitwarden.

Base Command

bitwarden-get-events

Input

Argument Name Description Required
start The start date from which to filter events. (e.g., 2024-07-10T08:08:46.76) Optional
end The end date from which to filter events. (e.g., 2024-07-11T08:09:47.08) Optional
limit The number of events to return. Default is 500. Optional
should_push_events Set this argument to True in order to save events to XSIAM, otherwise the command will only display them. Possible values are: true, false. Default is false. Optional

Context Output

There is no context output for this command.

Configuration parameters

  • url — Server URL (e.g., https://example.bitwarden.com) (required)
  • self_hosted — Self-hosted Bitwarden Instance
  • credentials — Client ID (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • max_fetch_events — Maximum number of events per fetch

Commands (1)

  • bitwarden-get-events

    Gets events from Bitwarden.


## Creating an API Client in Bitwarden Password Manager

The client_id and client_secret can be obtained by an owner from the Admin Console vault by navigating to the **Settings** > **Organization** info screen and scrolling down to the *API key* section.

For more information, see [Bitwarden Public API](https://bitwarden.com/help/public-api/#authentication)