https://github.com/dcfapixels/keytea

A small application with the functionality of a password manager, but it does not store these passwords either on the user's computer or on a server.
https://github.com/dcfapixels/keytea

password-generator password-manager

Last synced: 10 months ago
JSON representation

A small application with the functionality of a password manager, but it does not store these passwords either on the user's computer or on a server.

• Host: GitHub
• URL: https://github.com/dcfapixels/keytea
• Owner: DCFApixels
• License: mit
• Created: 2023-08-04T15:37:35.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-02T09:25:00.000Z (10 months ago)
• Last Synced: 2025-03-02T10:24:46.349Z (10 months ago)
• Topics: password-generator, password-manager
• Language: JavaScript
• Homepage: https://dcfapixels.github.io/KeyTea/
• Size: 389 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README-RU.md
  • License: LICENSE

Awesome Lists containing this project

README

          














# 🍵 Key Tea

  

  

    Readme Languages:

  

  

  

    

      

        

        Русский

        

    

    

      

        

        English

        

    

    

  

Ссылка - [https://dcfapixels.github.io/KeyTea/](https://dcfapixels.github.io/KeyTea/) 

Семантика версионирования - [Открыть](https://gist.github.com/DCFApixels/e53281d4628b19fe5278f3e77a7da9e8#file-dcfapixels_versioning_ru-md)






Небольшое приложение имеющее функционал хранилища паролей, но не хранящее эти пароли ни на компьютере пользователя ни на сервере. Работает на любом устройстве и если сохранить страницу, то KeyTea можно запустить и без подключения к интернету.



## 📖 Оглавление

- [Как это работает?](#-Как-это-работает?)

- [Безопасность](#-Безопасность)

- [Особенности](#-Особенности)

- [Руководство](#-Руководство)

    - [Ввод мастер-пароля](#Экран-ввода-мастер-пароля)

    - [Выбор пароля](#Экран-выбора-пароля)

    - [Редактирование информации для пароля](#Экран-редактирования-информации-для-пароля)

    - [Редактирование набора символов](#Экран-редактирования-набора-символов)

- [Лицензия](#-лицензия)

## ❓ Как это работает?



Если коротко то пароли вычисляются. В основе лежит мастер-пароль который необходимо придумать и запомнить. Из комбинации мастер-пароля и названия сайта генерируется уникальный пароль для этого сайта. Так как одинаковая пара мастер-пароля и названия сайта при каждой повторной генерации дает одинаковый результат, генерируемые пароли нет необходимости сохранять. При генерации используя криптостойкая хеш функция, в следствии чего конечный пароль нельзя обратно конвертировать в мастер-пароль.



## 🔒 Безопасность

**Данное приложение гарантирует отсутствие хранения или передачи паролей третьим лицам следующим:**


+ Приложение может работать без подключения к интернету; 

+ Не использует фреймворки или библиотеки сторонних разработчиков, за исключением браузера и скрипта [js-sha3](https://github.com/emn178/js-sha3) для вычислений; 

+ Является open-source проектом и доступно для изучения исходного кода. Можно самостоятельно убедиться что все чисто.

**Преимущества:**


+ Достаточно помнить всего лишь один мастер-пароль, но для каждого сайта генерируется уникальный;

+ Генерируемые пароли имеют случайный набор символов, что делает их надежными;

+ Так как приложение не хранит пароли, эти пароли не подвержены утечки при взломах;

+ Быстрая смена генерируемого пароля, добавление всего одного символа создает новый уникальный пароль.

**Недостатки:**


+ Утечка мастер-пароля открывает доступ ко всем паролям;

+ Один мастер-пароль проще поддается разного вида атакам.

## ⭐ Особенности

+ **Кроссплатформенность:**



Использование веб языков позволяет запускать приложение на любом устройстве при наличии браузера. А так же оно может быть встроенно в другие приложения. 



+ **Настройка наборов символов:**



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



+ **Перегенерация пароля с помощью версии:**



На случай необходимости смены пароля в настройках пароля можно изменить его версию, повышение версии полностью меняет пароль на уникальный новый.



+ **Детерминированные вычисления:**



Пароли генерируются одинаковые вне зависимости от того на каком устройстве запущено приложение.



## 📜 Руководство

### Экран ввода мастер-пароля

На начальном экране пользователю предлагается ввести мастер-пароль, который используется для генерации паролей.

![image](https://github.com/user-attachments/assets/396df36d-1381-433c-9b66-44ca7cec2ce5)

После ввода мастер-пароля нажмите кнопку Continue, чтобы перейти к списку паролей.

![image](https://github.com/user-attachments/assets/5360397a-ba85-4855-9fc0-9f009c318080)

### Экран выбора пароля

В верхней части экрана отображается список ресурсов. Для получения пароля выберите нужный ресурс из списка.

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

![image](https://github.com/user-attachments/assets/58f01be4-b28a-4f08-9099-e9327588093f)

Выбрав ресурс снизу в поле password появится сгенерированный пароль для этого ресурса. Справа от поля кнопка копирования пароля в буфер обмена. Еще правее кнопка показа пароля, по умолчанию пароль скрыт.

![image](https://github.com/user-attachments/assets/08958b72-9549-4fdb-b105-482b9807af13)

В нижней части экрана расположены кнопки для импорта и экспорта данных пользователя. Эти функции позволяют переносить данные между устройствами.

![image](https://github.com/user-attachments/assets/d776ade5-f000-4ec4-b21f-0041d19a389f)

### Экран редактирования информации для пароля

Вверху для редактирования доступно 4 поля:

+ **Name** - название ресурса для которого генерируется пароль, это же название будет отображаться на экране выбора пароля.

+ **User** - на случай если для одного и того же ресурса имеется несколько аккаунтов, сюда можно ввести логины аккаунтов, таким образом получив отличные пароли.

+ **Length** - длинна пароля.

+ **Version** - версия пароля. Увеличить версию можно по нажатию кнопки `Up`, повышение версии генерирует абсолютно новый пароль.

Ниже идет список наборов символов, из которого можно выделить те которые будут использоваться в генерации пароля. 

Список наборов символов редактируемый. Кнопка внизу списка со значком плюса добавляет новый пустой набор, кнопка в виде шестерни открывает экран редактирования набора символов, соседняя кнопка в виде корзины удаляет набор из списка.

![image](https://github.com/user-attachments/assets/538cf86a-47c9-4296-8290-6224c6f8af0a)

После завершения редактирования нажмите кнопку `Save` для сохранения изменений или `Cancel` для отмены.

![image](https://github.com/user-attachments/assets/efb2d3da-8c45-4468-b562-dbd89e055514)

### Экран редактирования набора символов

Для редактирования доступно 3 поля:

+ **Name** - отображаемое в приложении название набора. Никак не влияет на генерацию пароля.

+ **Charset** - набор символов в виде текста. После сохранения текст отформатируется, символы сортируются с удалением дубликатов.

+ **Priority** - приоритет набора. Приоритет влияет на частоту с которой символы встречаются в пароле. Частота рассчитывается относительно приоритета всех наборов, чем приоритет выше, тем чаще встречаются символы из данного набора. Вне зависимости от приоритета, в пароле будет использован как минимум 1 символ из набора.

![image](https://github.com/user-attachments/assets/b38c4022-d33d-44f8-b446-d7372f65616f)

После завершения редактирования нажмите кнопку `Save` для сохранения изменений или `Cancel` для отмены.

![image](https://github.com/user-attachments/assets/efb2d3da-8c45-4468-b562-dbd89e055514)

## 📑 Лицензия

MIT Лицензия: [https://raw.githubusercontent.com/DCFApixels/KeyTea/refs/heads/main/LICENSE](https://raw.githubusercontent.com/DCFApixels/KeyTea/refs/heads/main/LICENSE)