JS коннектор

5min
API Пассворка позволяет получать, создавать и обновлять пароли, папки и хранилища. Это простой способ интегрировать Пассворк в инфраструктуру. 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 ключа. Его нужно хранить в секрете и не передавать третьим лицам.
Чтобы получить временный 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();
})();
﻿
﻿Больше примеров﻿
Обновлено 04 Oct 2024
Помогла ли вам эта страница?
Работа с API
Python коннектор