totpkit — одноразовые коды (TOTP) для любых сервисов
Одно шифрованное хранилище вторых факторов на все сервисы: PyPI, GitHub, Bitrix24, что угодно. Код можно получить командой, а можно кнопкой в Telegram, когда ноутбука под рукой нет. Другие проекты берут коды из того же стора одной строкой, не заводя собственных копий секретов.
Установка
uv add s-totpkit # как зависимость
uv sync --extra bot # с Telegram-ботом
uv run python scripts/self_check.py
Быстрый старт
totp entry add --uri "otpauth://totp/PyPI:alice?secret=…&issuer=PyPI"
totp list
totp code pypi # {"code": "366845", "seconds_left": 20}
Вывод — JSON по умолчанию; --text переключает на человекочитаемый.
Из своего кода
from totpkit import provider_for
login(username, password, totp_provider=provider_for("pypi"))
Провайдер отдаёт код по сигнатуре (попытка, прошлая ошибка) -> код и сам
разбирается с границей 30-секундного окна: ждёт ротацию, когда коду осталось
жить меньше трёх секунд, и никогда не отдаёт дважды один и тот же код — иначе
повторная попытка входа сгорает на коде, который сервис уже отверг.
Модель хранения
Запись — это сервис + аккаунт + иконка + группа. Ключ строится как
сервис или сервис:аккаунт и служит тем, что вы набираете руками: пока
аккаунт один, работает короткое totp code pypi; когда их стало два, короткая
форма даёт ошибку со списком вариантов, а не выдаёт код наугад.
Групп по умолчанию нет — всё лежит одним плоским списком, пока группу не задали.
Секреты пишутся в системное хранилище (keyring). Если рабочего бэкенда нет, кит
честно предупреждает и уходит в файл — проверить можно командой
totp store status. Длинные сторы режутся на куски: у Windows Credential
Manager есть жёсткий потолок на размер значения, и без нарезки хранилище молча
деградировало бы в открытый файл ровно тогда, когда записей стало много.
Telegram-бот
totp bot setup # токен бота и первый разрешённый аккаунт
totp bot run
Бот отдаёт коды только аккаунтам из белого списка: бот, отвечающий кому угодно, — это утечка второго фактора. Карточка показывает код, остаток жизни окна и кнопку «Обновить» — она стоит первой строкой одна на всю ширину, потому что за ней тянутся чаще всего (код живёт 30 секунд), а цвет кнопки Bot API задавать не умеет, и заметность даётся шириной и значком.
Навигация: внизу чата постоянный ряд «🏠 Главное меню» + «🗂 Сервисы», а возврат в начало есть на каждом экране. «Сервисы» — список сервисов с числом записей; вход в сервис показывает только его записи. «📋 Все записи» на первом экране появляется, только когда заведены группы: без групп первый экран и так плоский список, и кнопка вела бы туда, где человек уже стоит.
«⬅️ Назад» ведёт на ШАГ назад и дополняет «Главное меню», а не заменяет его:
из карточки — в тот список, откуда её открыли (группа, сервис или плоский
список), из записей сервиса — в «Сервисы». Точка возврата едет хвостом в
callback_data (код экрана плюс, для группы и сервиса, тот же 12-символьный
токен) — 13 байт, весь колбэк карточки укладывается в 28 из 64. Там, где шаг
назад и есть первый экран, отдельной кнопки нет: две кнопки с одинаковым
действием — выбор без разницы. Кнопки из старых сообщений точки возврата не
знают и по-прежнему ведут домой — падать им нельзя, они живут в чате вечно. Иконку сервиса и подписи
кнопок задаёт провайдер (плагин навыка, entry-point totpkit.providers); в
тексте сообщений иконка идёт премиум-эмодзи, в кнопках — обычная (Bot API
рисует custom_emoji только по entity сообщения). Если Telegram отверг
разметку, сообщение уходит повторно без неё: код важнее картинки.
Лицензия
MIT
Metadata
Release files for s-totpkit 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| s_totpkit-0.2.0.tar.gz | 177.8 kB | Without provenance | Details for s_totpkit-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| s_totpkit-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for s_totpkit-0.2.0-py3-none-any.whl |
Total release size: 251.0 kB
Release files / s_totpkit-0.2.0.tar.gz
| Download URL | s_totpkit-0.2.0.tar.gz |
|---|---|
| Size | 177.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
12bca604e8ab73b28adda55a192a037fa3f0646c127094ce0f621f0b23b8e4a6
|
|
BLAKE2b-256 checksum How to use checksums |
06a70d2aedabaf173d77b8354946c81dbc028f51420f7a89507a39eaa1bb1ccf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / s_totpkit-0.2.0-py3-none-any.whl
| Download URL | s_totpkit-0.2.0-py3-none-any.whl |
|---|---|
| Size | 73.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e934b564895a67952c9d48236f2e5ea4bd14c6b9688a52f3417d2bb6c8c0c647
|
|
BLAKE2b-256 checksum How to use checksums |
a4788579be7c578b729f87c387a000a21eb2d4f68a909ceca4e1207ce3655927
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for s-totpkit 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.