🛡️ Desktop-2FA

डेस्कटॉप वातावरण के लिए एक सुरक्षित, ऑफ़लाइन दो-कारक प्रमाणीकरण (2FA) प्रबंधक। Python में निर्मित, जिसमें मजबूत एन्क्रिप्शन और कोई क्लाउड निर्भरता नहीं है।

🌐 लैंडिंग पेज: desktop-2fa.org

✨ विशेषताएँ

📸 स्क्रीनशॉट

इंटरैक्टिव रूप से नई TOTP प्रविष्टि जोड़ना

एक प्रविष्टि के लिए TOTP कोड उत्पन्न करना

डुप्लिकेट पहचान के साथ प्रविष्टि का पुनर्नामकरण

संस्करण जानकारी देखना और सभी प्रविष्टियाँ सूचीबद्ध करना

🚀 त्वरित आरंभ

स्थापना

pip install desktop-2fa

स्थापना सत्यापित करें:

python -c "import desktop_2fa; print(desktop_2fa.__version__)"
# Output: 0.8.1dev

बुनियादी उपयोग

# एक नया वॉल्ट आरंभ करें
d2fa vault init

# एक नया TOTP टोकन जोड़ें
d2fa vault add GitHub GitHub JBSWY3DPEHPK3PXP

# सभी प्रविष्टियाँ सूचीबद्ध करें
d2fa vault list

# एक कोड उत्पन्न करें
d2fa code GitHub

गैर-इंटरैक्टिव उपयोग

# कमांड लाइन के माध्यम से पासवर्ड प्रदान करें
d2fa vault add GitHub GitHub JBSWY3DPEHPK3PXP --password mypassphrase

# फ़ाइल के माध्यम से पासवर्ड प्रदान करें
d2fa vault add GitHub GitHub JBSWY3DPEHPK3PXP --password-file /path/to/passphrase.txt

📁 वॉल्ट जीवनचक्र

वॉल्ट एक एन्क्रिप्टेड संग्रहण फ़ाइल है जो ~/.desktop-2fa/vault पर स्थित है।

वॉल्ट निर्माण

जब किसी कमांड को वॉल्ट की आवश्यकता होती है और कोई वॉल्ट मौजूद नहीं है:

1. CLI नए पासवर्ड के लिए संकेत देता है (इंटरैक्टिव मोड) या --password/--password-file (गैर-इंटरैक्टिव मोड) की आवश्यकता होती है
2. एक खाली एन्क्रिप्टेड वॉल्ट बनाया जाता है
3. एक पुष्टिकरण संदेश हमेशा मुद्रित होता है: Vault created at <path>

वॉल्ट लोड करना

जब किसी कमांड को वॉल्ट की आवश्यकता होती है और वह मौजूद है:

1. CLI मौजूदा पासवर्ड के लिए संकेत देता है (इंटरैक्टिव मोड) या क्रेडेंशियल्स (गैर-इंटरैक्टिव मोड) की आवश्यकता होती है
2. वॉल्ट को डिक्रिप्ट और लोड किया जाता है
3. यदि पासवर्ड अमान्य है, तो CLI typer.Exit(1) के साथ बाहर निकलता है

डुप्लिकेट प्रविष्टि प्रबंधन

rename कमांड तब नियतात्मक व्यवहार लागू करता है जब एकाधिक प्रविष्टियाँ लक्ष्य नाम से मेल खाती हैं:

• यदि प्रदान किए गए नाम (issuer या account_name) से एकाधिक प्रविष्टियाँ मेल खाती हैं, तो पुनर्नामकरण निरस्त कर दिया जाता है
• त्रुटि संदेश: Error: Multiple entries named '<name>' exist. Operation aborted. Resolve duplicates first.
• इस मामले में कोई प्रविष्टि पुनर्नामित नहीं की जाती है
• यह जाँच किसी भी उत्परिवर्तन से पहले होती है

📖 CLI कमांड

मुख्य कमांड

वॉल्ट प्रबंधन

वैश्विक विकल्प

🔒 सुरक्षा

वॉल्ट निम्न का उपयोग करता है:

• AES-256-GCM प्रमाणित एन्क्रिप्शन के लिए
• Argon2id कुंजी व्युत्पत्ति के लिए (time_cost=4, memory_cost=128MiB, parallelism=2)
• zxcvbn पासवर्ड शक्ति मूल्यांकन के लिए
• संस्करणित हेडर आगे की अनुकूलता के लिए

प्रत्येक कमांड के लिए स्पष्ट पासवर्ड प्रमाणीकरण आवश्यक है। कोई सत्र-आधारित पहुंच नहीं।

पासवर्ड शक्ति मूल्यांकन

Desktop-2FA वॉल्ट पासवर्ड बनाते या बदलते समय पासवर्ड शक्ति का मूल्यांकन करने के लिए zxcvbn का उपयोग करता है:

• स्कोर 0-2 (कमजोर): आसानी से अनुमान लगाने योग्य पासवर्ड (जैसे, "password123")
• स्कोर 3-4 (मजबूत): सामान्य हमलों के प्रति प्रतिरोधी (अनुशंसित)

उदाहरण:

• ❌ कमजोर: password, 123456, qwerty, admin2024
• ✅ मजबूत: Battery-Horse-Staple-Correct, Mountain@River*2024, MySecureVault#42

कॉन्फ़िगरेशन (~/.config/d2fa/config.toml):

[security]
# मजबूत पासवर्ड आवश्यक (स्कोर >= 3)
reject_weak_passwords = false  # चेतावनी दें लेकिन अनुमति दें | true: कमजोर पासवर्ड अस्वीकार करें

जब reject_weak_passwords = false:

• कमजोर पासवर्ड एक पीली चेतावनी ट्रिगर करते हैं
• उपयोगकर्ता को जारी रखने की पुष्टि करने के लिए संकेत दिया जाता है
• पासवर्ड स्वीकृति गैर-अवरोधक है

जब reject_weak_passwords = true:

• कमजोर पासवर्ड तुरंत अस्वीकार कर दिए जाते हैं
• कमांड त्रुटि के साथ बाहर निकलता है
• उपयोगकर्ता को एक मजबूत पासवर्ड चुनना होगा

पिछड़ी अनुकूलता: यदि आपके कॉन्फ़िग में min_password_entropy सेट है (विरासत विकल्प), तो इसे पहचाना जाता है और zxcvbn स्कोर >= 3 की आवश्यकता के समान माना जाता है।

सुरक्षा सुदृढ़ीकरण (v0.8.0)

संस्करण 0.8.0 pichhale v0.7.3 ke sabhi सुरक्षा सुदृढ़ीकरण को बनाए रखता है और बेहतर कोड अलगाव के लिए मॉड्यूलर आर्किटेक्चर प्रस्तुत करता है:

• खाली पासवर्ड तुरंत स्पष्ट त्रुटि संदेश के साथ अस्वीकार कर दिए जाते हैं
• अनुमति त्रुटियों को लापता वॉल्ट फ़ाइलों से अलग किया जाता है
• उपयोगकर्ताओं को कोई Python स्टैक ट्रेस नहीं दिखाया जाता है
• फ़ाइलसिस्टम अनुमति समस्याओं के लिए उपयोगकर्ता-अनुकूल त्रुटि संदेश
• मॉड्यूलर डिज़ाइन बढ़ी हुई सुरक्षा सीमाओं के लिए CLI और मुख्य क्रिप्टोग्राफ़िक घटकों को अलग करता है
• zxcvbn-आधारित पासवर्ड शक्ति मूल्यांकन (v0.8.0 में नया)

📚 दस्तावेज़ीकरण

🧪 परीक्षण

pytest tests/              # सभी परीक्षण चलाएँ
pytest --cov=src/desktop_2fa  # कवरेज के साथ चलाएँ

🏗️ परियोजना संरचना

src/desktop_2fa/
├── app/           # एप्लिकेशन घटक
├── cli/           # कमांड-लाइन इंटरफ़ेस
├── crypto/        # एन्क्रिप्शन उपयोगिताएँ
├── totp/          # TOTP जनरेशन
├── ui/            # उपयोगकर्ता इंटरफ़ेस घटक
├── vault/         # वॉल्ट प्रबंधन
└── utils/         # उपयोगिताएँ

📄 लाइसेंस

Apache License 2.0. LICENSE फ़ाइल देखें।

👤 लेखक

Łukasz Perek

🏆 प्रायोजन

desktop‑2fa को Kilo OSS प्रायोजन कार्यक्रम के माध्यम से समर्थन प्राप्त है।

📧 संपर्क

प्रश्नों या सहायता के लिए, हमसे [email protected] पर संपर्क करें।

💖 परियोजना का समर्थन करें

Desktop‑2FA एक स्वतंत्र ओपन‑सोर्स टूल है जो स्वायत्तता, पारदर्शिता और ऑफ़लाइन सुरक्षा पर केंद्रित है। यदि आप इसे उपयोगी पाते हैं और विकास जारी रखने में सहायता करना चाहते हैं, तो आप नीचे दिए गए प्लेटफ़ॉर्म के माध्यम से ऐसा कर सकते हैं:

• Ko‑fi: https://ko-fi.com/lukaszperek
• Buy Me a Coffee: https://buymeacoffee.com/lukaszperek
• AirTM: https://airtm.me/lukper