BearPass

Appearance

BearPass Command Line Interface (CLI) ​

Интерфейс командной строки BearPass (CLI) - это инструмент, который позволяет вам взаимодействовать с данными паролей напрямую из терминала. Данная CLI-утилита упрощает получение данных в автоматизациях и скриптах, и особенно полезна для DevOps-инженеров.

Узнать о всех возможностях CLI-клиента можно с помощью аргумента --help

shell
Bearpass CLI client

Usage: bearpass <command> [args]

Available commands:
   config    Configure main settings
   get       Get password data

Скачивание и установка ​

Для amd64:

shell
wget https://services.bearpass.ru/downloads/bearpass-amd64.zip
unzip bearpass-amd64.zip
chmod +x bearpass

Для arm64:

shell
wget https://services.bearpass.ru/downloads/bearpass-arm64.zip
unzip bearpass-arm64.zip
chmod +x bearpass

Начало работы ​

Перед началом работы с cli клиентом, его необходимо сконфигурировать.

Это можно сделать с помощью:

  1. Переменных окружения
  2. Запуска команды config

Переменные окружения ​

Установите переменные окружения

  • BEARPASS_API_URL - URL сервера BearPass в формате https://bearpass.company.com/
  • BEARPASS_API_KEY - Ключ API пользователя, через которого будет производиться работа с CLI клиентом

Запуск команды config ​

Для этого запустите команду ./bearpass config Укажите 2 параметра:

  1. URL сервера BearPass в формате https://bearpass.company.com/
  2. Ключ API пользователя, через которого будет производиться работа с CLI клиентом

Данные будут сохранены в файл ~/.bearpass/config

Доступные команды ​

get ​

Получение данных пароля по id

shell
./bearpass get --help

Usage: bearpass get <id> [args]

<id> - Password id as number

Available arguments:
        --field="<string>"      Specify the field to get from BearPass password. Available fields: name, parent_id, type, comment, quality_percent, actual_percent, compromised_count, archived, personal, created_at, version, url, login. For additional fields use syntax: additional_field[field name]. Example: --field="additional_field[port]"

Для получения всех данных пароля необходимо запустить команду в формате bearpass get <id>, например: bearpass get 1.

Стандартный формат ответа - json.

Для получения данных отдельного поля необходимо указать флаг --field=<fieldName>
Все доступные поля: name, parent_id, type, comment, quality_percent, actual_percent, compromised_count, archived, personal, created_at, version, url, login
Для получения данных дополнительного поля необходимо указать additional_field и название поля в кавычках, например --field="additional_field[ip address]"

Примеры:

shell
./bearpass get 2 --field=password
9!2%P0jw^Ns38gW
shell
./bearpass get 2 --field="additional_field[ip address]"
8.8.8.8

config ​

Конфигурация CLI клиента