Guión de migración
La API pública de Bitwarden permite a los administradores automatizar tareas administrativas mediante scripts. El script documentado en este artículo está escrito para ayudar a los clientes de Bitwarden a migrar su configuración existente desde un entorno anterior de Bitwarden Password Manager a una nueva organización, proporcionando una forma de migrar los datos del almacén de la organización, los grupos y los permisos de los grupos y miembros asociados a una nueva instalación.
El script está escrito en Python y puede ejecutarse en cualquier sistema operativo con Python v3 instalado. Descargue el script y un archivo de configuración de ejemplo de tipo: asset-hyperlink id: 76zQs7igKMkSy7W2lpgbGv.
Aparte de las bibliotecas por defecto incluidas en la mayoría de las distribuciones de Python (incluidas por defecto en Linux y macOS, y disponibles para Windows), este script requiere que se instale un módulo adicional llamado requests antes de que el script pueda ejecutarse correctamente.
Una herramienta común para instalar módulos de Python se llama pip. Para instalar el módulo usando pip:
Bashpip3 install requests
nota
pip3 - Algunas máquinas tendrán múltiples versiones de Python instaladas. Usando pip3, en lugar de sólo pip, especifica que instala peticiones con Python v3. Si su máquina sólo tiene instalada una versión de Python, utilice pip en su lugar.
La descarga anterior contiene dos archivos:
bwAdminTools.py: Este es el script que necesitarás para ejecutar la migración. Requiere un archivo de configuración totalmente configurado.config-example.cfg: es el archivo de configuración necesario para la migración, que deberá crear y configurar antes de ejecutar el script.
Descomprima el .zip y guarde estos archivos en el mismo directorio. Una vez lo hayas hecho, añade los siguientes archivos al mismo directorio:
Bitwarden Password Manager CLI ejecutable nativo.
Antes de continuar, debe crear la organización de destino a la que migrará. Aprende a crear una organización.
nota
Recomendamos invitar a los usuarios antes de ejecutar el script de migración. Los usuarios deben estar al menos en estado invitado para poder migrar la configuración de grupos y permisos.
Antes de ejecutar cualquier función del script bwAdminTools. py, necesitará crear un fichero de configuración. Copie el contenido de config-example.cfg en un nuevo archivo config.cfg en el mismo directorio, y rellene las siguientes variables. Tenga en cuenta que, como se trata de un script de migración, las variables se dividen en agrupaciones de origen y destino en esta documentación:
Variable de organización de origen | Descripción de la variable |
|---|---|
bw_vault_uri= | FQDN de su bóveda web de origen, por ejemplo https://company.bitwarden.com si está autoalojado o https://vault.bitwarden.com si está utilizando los servicios en la nube de Bitwarden con sede en EE.UU. |
bw_org_client_id= | ID del cliente de la clave API de la organización de origen. Sepa dónde encontrarlo. |
bw_org_client_secret= | Secreto del cliente de la clave API de la organización de origen. Sepa dónde encontrarlo. |
bw_org_id= | GUID de la organización de origen. Copie el valor |
bw_acc_client_id | ID de cliente de clave API personal del administrador o propietario de la organización de origen. Sepa dónde encontrarlo. |
bw_acc_client_secret= | Secreto de cliente de clave API personal del administrador o propietario de la organización de origen. Sepa dónde encontrarlo. |
Variable de organización de destino | Descripción de la variable |
|---|---|
dest_bw_vault_uri= | FQDN de su almacén web de origen, por ejemplo https://company.bitwarden.com si desea autoalojarse o https://vault.bitwarden.eu si desea utilizar los servicios en la nube de Bitwarden basados en la UE. |
dest_bw_org_client_id= | ID de cliente de la clave API de la organización de destino. Sepa dónde encontrarlo. |
dest_bw_org_client_secret= | Secreto del cliente de la clave API de la organización de destino. Sepa dónde encontrarlo. |
dest_bw_org_id= | GUID de la organización de destino. Copie el valor |
dest_bw_acc_client_id= | ID de cliente de clave API personal del administrador o propietario de la organización de destino. Sepa dónde encontrarlo. |
dest_bw_ac_client_secret= | Secreto de cliente de clave API personal del administrador o propietario de la organización de destino. Sepa dónde encontrarlo. |
Una vez que haya configurado estas variables, estará listo para comenzar la migración utilizando las funciones del script bwAdminTools.py.
Desde el directorio donde ha almacenado su archivo bwAdminTools.py, archivo config.cfg, y Password Manager CLI ejecutable, puede ejecutar los siguientes comandos:
nota
python3 - Algunas máquinas tendrán varias versiones de Python instaladas. El uso de python3, en lugar de sólo python, especifica que los comandos se ejecutan con Python v3. Si su máquina sólo tiene instalada una versión de Python, utilice python en su lugar. Algunas distribuciones también tendrán un binario python en lugar de python3 para v3.
Para imprimir el texto de ayuda del script:
Bashpython3 bwAdminTools.py -hComparar las organizaciones de origen y destino:
Bashpython3 bwAdminTools.py -c diffbwPara migrar los datos del almacén de la organización, los grupos y los permisos de los grupos de una organización de origen a una organización de destino:
Bashpython3 bwAdminTools.py -c migratebwLos usuarios deben estar al menos en estado invitado en la organización de destino para que
migratebwtenga éxito.Para migrar los permisos de los miembros (fuera de los grupos) de una organización de origen a una organización de destino:
Bashpython3 bwAdminTools.py -c migratebwusersLos usuarios deben estar al menos en estado invitado en la organización de destino para que
migratebwuserstenga éxito.Para eliminar todas las colecciones de la organización de origen:
Bashpython3 bwAdminTools.py -c purgecolPara eliminar todas las colecciones de la organización de destino:
Bashpython3 bwAdminTools.py -c purgecoldestPara eliminar todos los grupos de la organización de origen:
Bashpython3 bwAdminTools.py -c purgegroupPara eliminar todos los grupos de la organización de destino:
Bashpython3 bwAdminTools.py -c purgegroupdest