JS-коннектор

API Пассворка позволяет получать, создавать и обновлять пароли, папки и сейфы. Это простой способ интегрировать Пассворк в инфраструктуру. Совершаемые операции с использованием ключа API, будут выполняться от имени пользователя, которому принадлежит.

Пример установки

Создать директорию для клонирования репозитория:

shell

mkdir js-connector

С помощью git склонировать репозиторий коннектора:

shell

git clone https://github.com/passwork-me/js-connector.git .

Установить зависимости проекта перечисленные в файле package.json:

shell

npm install

API-ключ

Выполнить следующие действия:

• Авторизоваться в веб-интерфейсе Пассворка;
• Перейти в Настройки и пользователи → Настройки API;
• Ввести пароль пользователя и получить API-ключ.

осторожно

Безопасность API-ключа крайне важна — храните его в секрете и не передавайте третьим лицам

Чтобы получить временный API-токен, используйте метод login(...). Этот токен действует в рамках сессии — пока совершаются запросы к API. После истечения токена потребуется снова войти в систему, чтобы сгенерировать новый. Время жизни токена можно настроить в Пассворке.

После получения токен сохраняется и автоматически передаётся в заголовках HTTP-запросов, что упрощает работу с API.

Ознакомьтесь с доступными методами API Пассворка

Примеры

Открыть сессию:

js

const Passwork = require('./src/passwork-api');
/** @type PassworkAPI */
const passwork = new Passwork("https://passwork/api/v4");
(async () => {
    await passwork.login("api-key");
    // или ожидается passwork.login("api-key", "master password"); если вы используете клиентское шифрование 

    // Указать запросы к Пассворку

    await passwork.logout();
})();

Сессия действует 10 минут (в зависимости от настроек). Таким образом, можно выполнять несколько действий в рамках одной сессии, не выполняя вход в систему.

Получить пароль с помощью ID:

js

const Passwork = require('./src/passwork-api');
const passwork = new Passwork("https://passwork/api/v4");
(async () => {
    await passwork.login("api-key");
    let password = await passwork.getPassword("password-id");
    await passwork.logout();
})();

Больше примеров