Skip to content

smartlegionlab/smart-2fa-secure

Repository files navigation

Smart 2FA Security System v0.2.4


Advanced Two-Factor Authentication system with enhanced security features.


Python Version License Security

GitHub top language GitHub release (latest by date) GitHub GitHub Repo stars GitHub watchers GitHub forks PyPI - Downloads PyPI PyPI - Format


Key Security Features

  • Complex Code Generation:

    • Supports ASCII letters, digits and special characters
    • Customizable code length (default: 6)
  • Flexible Expiration:

    • Adjustable TTL (Time-To-Live) for codes
    • Default 60 seconds expiration
  • 📱 Secure Delivery:

    • Telegram integration with customizable message templates

⚠️ Disclaimer

By using this software, you agree to the full disclaimer terms.

Summary: Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md


Installation

pip install smart-2fa-secure

Advanced Usage

from smart_2fa_secure import Smart2FA
from smart_2fa_secure.exceptions import InvalidCodeError

smart_2fa = Smart2FA(
  redis_host="localhost",
  redis_port=6379,
  telegram_token="YOUR_BOT_TOKEN",
  code_ttl=60,
  max_attempts=3,
  code_length=6,
)
code = smart_2fa.send_code(user_id="user1", recipient="1234567", message="Your code:")

# Verify with complex code
try:
    smart_2fa.verify_code("user123", "A1b2@#")
    print("Authentication successful!")
except InvalidCodeError:
    print("Invalid security code!")

Information for developers:

  • pip install pytest

  • pip install pytest-cov

  • pip install setuptools

  • pip install wheel

  • pip install build

  • pip install twine

  • pytest tests/ -v

  • pytest tests/ -v --cov=smart_2fa_secure --cov-report=html

  • python -m build or python setup.py sdist bdist_wheel

  • twine upload dist/*


License

BSD 3-Clause License: See file LICENSE

Copyright (©) 2025, Alexander Suvorov


Tests & Coverage

LOGO


Releases

Packages

Contributors

Languages