Newer
Older
gnexus-creds / extensions / extension / README.md
@Eugene Sukhodolskiy Eugene Sukhodolskiy 5 hours ago 3 KB Render the autofill card in a closed Shadow DOM

gnexus-creds-extension

Кросс-браузерное расширение для интеграции с gnexus-creds.

Возможности

  • Автозаполнение — обнаруживает формы логина и предлагает заполнить сохранённые креды.
  • Сохранение кредов — перехватывает введённые данные и предлагает сохранить их как секрет.
  • Popup — быстрый доступ к списку секретов, поиск, reveal и копирование полей.

Карточка автозаполнения рендерится в закрытом Shadow DOM на пустом host-элементе: страница не может стилизовать её своим CSS, прочитать её содержимое (названия секретов) через DOM или добраться до её кнопок через querySelector. Стили карточки (src/content.css) отдаются как web_accessible_resource и инжектируются текстом внутрь shadow root, а не в стилевые листы страницы; вид повторяет gnexus-ui-kit 1.0.

Установка

Chrome

  1. Откройте chrome://extensions/.
  2. Включите "Developer mode".
  3. Нажмите "Load unpacked" и выберите папку проекта.
  4. (Или установите .zip из dist/).

Firefox

Firefox MV3 не поддерживает background.service_worker, поэтому грузить нужно собранную версию из build/firefox/ (или .zip из dist/), а не корневой manifest.json.

  1. Соберите: make firefox.
  2. Откройте about:debugging#/runtime/this-firefox.
  3. Нажмите "Load Temporary Add-on" и выберите build/firefox/manifest.json (или установите dist/gnexus-creds-extension-firefox-0.1.0.zip).

Настройка

  1. Откройте popup (иконка в тулбаре).
  2. Введите URL сервера (по умолчанию https://creds.gnexus.space).
  3. Введите API-токен с правами read, reveal, write.
  4. Нажмите "Сохранить".

API-токен создаётся на сайте gnexus-creds в разделе "Токены".

Сборка

Сборка живёт внутри основного репозитория gnexus-creds в extensions/extension/. Нужны системные node и zip; npm-пакеты не требуются. Перед первой сборкой (и у свежего клона) материализуйте библиотеку из кита основного репо:

cd extensions/extension
make lib
make

make lib копирует gnexus-ui-kit из frontend/node_modules — у свежего клона это может быть более новый кит, чем в релизных zip.

Создаст архивы в dist/:

  • gnexus-creds-extension-chrome-0.1.1.zip
  • gnexus-creds-extension-firefox-0.1.1.zip

Лицензия

MIT