JS-коннектор

6min
API Пассворка позволяет получать, создавать и обновлять пароли, папки и сейфы. Это простой способ интегрировать Пассворк в инфраструктуру. Совершаемые операции с использованием ключа API, будут выполняться от имени пользователя, которому принадлежит.
Пример установки
Создать директорию для клонирования репозитория:
shell
mkdir js-connector
mkdir js-connector
﻿
С помощью git склонировать репозиторий коннектора:
shell
git clone https://github.com/passwork-me/js-connector.git .
git clone https://github.com/passwork-me/js-connector.git .
﻿
Установить зависимости проекта перечисленные в файле package.json:
shell
npm install
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();
})();
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();
})();
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();
})();
﻿
﻿Больше примеров﻿
Обновлено 20 Jan 2025
Помогла ли вам эта страница?
Работа с API
Python-коннектор