Skip to main content

totp-client — одноразовые коды (TOTP) для любых сервисов

Одно шифрованное хранилище вторых факторов на все сервисы: PyPI, GitHub, Bitrix24, что угодно. Другие проекты берут коды из того же стора одной строкой, не заводя собственных копий секретов.

Это клиент, и только клиент: библиотека плюс CLI. Фронтендов он не содержит — Telegram-бот выдачи кодов живёт отдельным проектом totp-bot, серверная часть с общим стором и журналом выдач — totp-service. Граница проведена намеренно: клиент ставится в окружение каждого навыка, которому нужен код, и тащить туда aiogram с обработчиками чужого интерфейса — плохая сделка.

Установка

uv add s-totp-client        # как зависимость
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 totp_client 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: он ставит себе этот клиент зависимостью и берёт коды тем же provider_for. Здесь про него только одно: иконку сервиса и подписи кнопок в любом фронтенде задаёт провайдер — плагин навыка, объявленный entry-point'ом totpkit.providers (имя группы осталось прежним после переименования пакета, чтобы уже написанные плагины продолжали находиться). Провайдер отдаёт готовые строки и ничего не знает ни про Telegram, ни про aiogram — потому и живёт в клиенте, а не во фронтенде.

Лицензия

MIT

Metadata

Release files for s-totp-client 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for s-totp-client 0.3.0
File Size Uploaded Provenance Actions
s_totp_client-0.3.0.tar.gz 83.3 kB Without provenance Details for s_totp_client-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for s-totp-client 0.3.0
File Interpreter ABI Platform Actions
s_totp_client-0.3.0-py3-none-any.whl Python 3 none any Details for s_totp_client-0.3.0-py3-none-any.whl

Total release size: 117.6 kB

Release files / s_totp_client-0.3.0.tar.gz

Download URL s_totp_client-0.3.0.tar.gz
Size 83.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5a5648447348584939867de19c8f57451caaa5f6adbdd27cb82f2dc648a8371c
BLAKE2b-256 checksum
How to use checksums
c476bf136b69590048c229d49c1772728366a466a84663ee9b2bb8a39a3b905e
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_totp_client-0.3.0-py3-none-any.whl

Download URL s_totp_client-0.3.0-py3-none-any.whl
Size 34.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1dbdfcb1b15fb0b3c32134cff6a1e528386c8a1e8fe9ec10e88e0b384995b68c
BLAKE2b-256 checksum
How to use checksums
a183a23c287357fac28acacfbea2a697a0b70e8acb4d5b606710b785cbe55474
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-totp-client 0.3.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.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page