gpasskey

.. image:: https://gitlab.com/renich/gpasskey/-/raw/master/assets/logo.svg :width: 140px :align: center :alt: gpasskey logo

Linux के लिए केंद्रीकृत क्रिप्टोग्राफ़िक पहचान एन्क्लेव।

.. caution::

PRE-ALPHA सॉफ़्टवेयर — अपने जोखिम पर उपयोग करें!

रिलीज़ नंबरिंग के बावजूद, gpasskey वर्तमान में प्रयोगात्मक प्री-अल्फा सॉफ़्टवेयर है जो तेज़ी से आर्किटेक्चरल विकास से गुज़र रहा है। क्रिप्टोग्राफ़िक स्कीमा, वॉल्ट प्रारूप और प्रोटोकॉल ब्रिज बिना पिछड़ी संगतता के बदल सकते हैं।

कुंजी और डेटा हानि का उच्च जोखिम: अपना 24-शब्दीय BIP39 रिकवरी वाक्यांश हमेशा लिख लें और सुरक्षित रूप से संग्रहीत करें।
द्वितीयक 2FA बनाए रखें: प्रोडक्शन खातों पर वर्चुअल FIDO2 सुरक्षा कुंजियाँ पंजीकृत करते समय, हमेशा एक द्वितीयक 2FA विधि (जैसे TOTP या बैकअप रिकवरी कोड) कॉन्फ़िगर करें।
कोई वारंटी नहीं: GNU GPLv3 लाइसेंस के तहत बिना किसी प्रकार की वारंटी के सख्ती से "ज्यों का त्यों" प्रदान किया गया।

अवलोकन

gpasskey एक हार्डवेयर-समर्थित सुरक्षा एन्क्लेव प्रदान करता है जो निजी कुंजियों को एक एन्क्रिप्टेड वॉल्ट में संग्रहीत करता है। यह एक मल्टी-प्रोटोकॉल ब्रिज के रूप में कार्य करता है, जो SSH Agent, age एन्क्रिप्शन प्लगइन प्रोटोकॉल और GnuPG कमिट साइनिंग एमुलेशन का समर्थन करता है।

मुख्य विशेषताएँ

मल्टी-प्रोटोकॉल समर्थन:
- FIDO2 / CTAP2 पासकीज़: नेटिव ब्राउज़र (Firefox, Chrome, Chromium) और OS पासकी प्रमाणीकरण के लिए /dev/uhid पर वर्चुअल USB सुरक्षा कुंजी एमुलेटर।
- SSH Agent: OpenSSH-अनुरूप एजेंट प्रोटोकॉल।
- age-plugin: age (v1) फ़ाइल एन्क्रिप्शन के लिए नेटिव समर्थन।
- GnuPG ब्रिज: सहज Git कमिट साइनिंग और सत्यापन के लिए GPG CLI का अनुकरण करता है।
हार्डवेयर-समर्थित सुरक्षा: निजी कुंजियाँ AES-256-GCM से एन्क्रिप्ट की जाती हैं, मुख्य रूप से SRK कैशिंग के साथ TPM 2.0 पर सील की जाती हैं।
क्रिप्टोग्राफ़िक PIN बाइंडिंग और UV कैश: प्रत्येक ऑपरेशन लॉक की गई RAM (mlock) में 15-सेकंड के सुरक्षित सत्र कैश के साथ PIN-व्युत्पन्न सबकी से बंधा होता है।
Argon2id KDF: मास्टर पासफ़्रेज़, रिकवरी और सबकीज़ के लिए मेमोरी-हार्ड कुंजी व्युत्पत्ति।
ब्रूट-फोर्स सुरक्षा: विफल प्राधिकरण प्रयासों के लिए स्वचालित एक्सपोनेंशियल बैकऑफ़।
बुद्धिमान UI रूटिंग: प्राधिकरण संकेतों के लिए स्वचालित सत्र पहचान (ग्राफ़िकल बनाम TTY)।
सुरक्षित मेमोरी: कुंजी सामग्री को स्वैप या GC हीप में लीक होने से रोकने के लिए mmap/mlock और "Wrap and Clear" रणनीति का उपयोग करता है।
पहचान प्रबंधन: वॉल्ट प्रशासन और एन्क्रिप्टेड सीक्रेट प्रबंधन के लिए मज़बूत CLI (gpasskey-cli)।

TPM 2.0 एकीकरण

gpasskey TPM 2.0 के माध्यम से हार्डवेयर-समर्थित सुरक्षा का समर्थन करता है। यह सुनिश्चित करता है कि आपकी मास्टर कुंजी कभी भी अनएन्क्रिप्टेड रूप में TPM से बाहर न जाए और सिस्टम की बूट स्थिति से बंधी हो।

आवश्यकताएँ


* TPM 2.0 संगत डिवाइस (या विकास के लिए ``swtpm``)।
* सिस्टम पर ``tpm2-tools`` स्थापित।

आरंभीकरण

जब आप एक नई पहचान बनाते हैं तो TPM स्टोरेज स्वचालित रूप से आरंभ हो जाता है। TPM स्थिति सत्यापित करने के लिए:

.. code-block:: bash

gpasskey-cli status

उपयोग


आरंभ होने के बाद, TPM का उपयोग डेमन द्वारा पारदर्शी रूप से किया जाता है। सभी संवेदनशील डेटा **PCR 0** (कोर सिस्टम फ़र्मवेयर) और **PCR 7** (सिक्योर बूट स्थिति) के विरुद्ध सील किया जाता है। फ़र्मवेयर या सिक्योर बूट कॉन्फ़िगरेशन में कोई भी संशोधन वॉल्ट को अनलॉक होने से रोकेगा, जो ऑफ़लाइन हमलों और अनधिकृत OS छेड़छाड़ से सुरक्षा प्रदान करता है।

त्वरित आरंभ
-----------

अपने उपयोगकर्ता खाते के लिए बिल्ड और इंस्टॉल करें (अनुशंसित, गैर-root)::

   make clean && make all
   make install-user   # Installs to ~/.local/bin, ~/.config/systemd/user, ~/.local/share/dbus-1

या सिस्टम-व्यापी इंस्टॉल करें (root की आवश्यकता है)::

   sudo make install   # Installs to /usr/local/bin

सॉकेट सक्रियण सक्षम और प्रारंभ करें::

   systemctl --user enable --now gpasskey-ssh.socket gpasskey-gpg.socket

अपना वॉल्ट आरंभ करें और स्थिति सत्यापित करें::

   gpasskey-cli status
   # Identities are enrolled automatically on first use by clients 
   # (WebAuthn passkeys, SSH, age, GPG) or via the portal API.

ब्राउज़र में WebAuthn पासकीज़::

   # Open Firefox or Chrome, go to https://webauthn.io/
   # Click "Register" -> enter your PIN in the gpasskey prompt -> Passkey is created!
   # Click "Authenticate" -> enter your PIN -> Instant login verified!

TPM-समर्थित कॉन्फ़िग स्टोर में एन्क्रिप्टेड सीक्रेट प्रबंधित करें::

   gpasskey-cli set-secret my-api-key "super-secret-value"
   gpasskey-cli get-secret my-api-key

दस्तावेज़ीकरण और विनिर्देश
------------------------------

हमारा व्यापक इंजीनियरिंग दस्तावेज़ीकरण मॉड्यूलर विनिर्देशों, आर्किटेक्चर रिकॉर्ड्स और रोडमैप में व्यवस्थित है:

* **कार्यात्मक विनिर्देश**: `Functional Spec Index`_ — उपयोगकर्ता आवश्यकताओं और प्राधिकरण मॉडल को परिभाषित करता है।
* **तकनीकी ब्लूप्रिंट**: `Technical Spec Index`_ — विस्तृत Go आर्किटेक्चर, क्रिप्टो प्रिमिटिव और एन्क्लेव डिज़ाइन।
* **आर्किटेक्चर निर्णय रिकॉर्ड (ADRs)**: `ADR Index`_ — आर्किटेक्चरल, क्रिप्टो और सुरक्षा विकल्पों का अपरिवर्तनीय लॉग।
* **API और वायर प्रोटोकॉल**: `API Spec Index`_ — प्रबंधन सॉकेट, D-Bus पोर्टल और ब्रिज वायर स्कीमा।
* **परियोजना निष्पादन रोडमैप**: `Roadmap Index`_ — चरणबद्ध इंजीनियरिंग समयसीमाएँ और माइलस्टोन डिलिवरेबल्स।

उपयोगकर्ता गाइड

User Quick Start_ - 5 मिनट में शुरू करें।
Installation Guide_ - विस्तृत बिल्ड, udev और systemd सेटअप।
Security Guide_ - हार्डवेयर TPM 2.0 एन्क्लेव और "Wrap and Clear" मेमोरी आइसोलेशन।
Configuration Guide_ - पर्यावरण चर और सेवा विकल्प।

.. _Functional Spec Index: docs/functional/spec.rst .. _Technical Spec Index: docs/technical/spec.rst .. _ADR Index: docs/adrs/index.rst .. _API Spec Index: docs/api/spec.rst .. _Roadmap Index: docs/project/roadmap.rst .. _User Quick Start: docs/user/quickstart.rst .. _Installation Guide: docs/user/installation.rst .. _Security Guide: docs/user/security.rst .. _Configuration Guide: docs/user/configuration.rst

हम क्या योजना बना रहे हैं (चरण 7)

हम वर्तमान में चरण 7: प्लगेबल मल्टी-फैक्टर और मल्टी-पार्टी कोरम इंजन का विनिर्देशन और आर्किटेक्चरिंग कर रहे हैं:

स्ट्रीमिंग आर्बिट्रेरी फ़ाइल हैशर: स्थिर :math:\mathcal{O}(1) मेमोरी खपत (:math:\le 64\,\text{KB} बफर) के साथ किसी भी फ़ाइल (छोटी टेक्स्ट कविता से लेकर 100GB ऑडियो मास्टर FLAC या इमेज तक) को प्राधिकरण फैक्टर के रूप में उपयोग करें।
मल्टी-पार्टी कोरम ("द कोका-कोला रेसिपी"): HMAC सत्यापन टैग के साथ :math:\text{GF}(2^8) पर Key-Wrapped Shamir Secret Sharing, जो :math:k-of-:math:n स्प्लिट-की प्राधिकरण सक्षम करता है।
हार्डवेयर और बायोमेट्रिक्स: भौतिक YubiKey (Slot 2 HMAC-SHA1), भौतिक FIDO2 कुंजियाँ (hmac-secret) और Linux बायोमेट्रिक्स (fprintd)।
डायनामिक फैक्टर री-कीइंग: कुंजियों को दोबारा बनाए बिना किसी पहचान की फैक्टर नीति को तुरंत बदलने के लिए एटॉमिक इन-मेमोरी री-एन्क्रिप्शन (gpk rekey)।
CLI आधुनिकीकरण: कमांड-लाइन इंटरफ़ेस को विहित gpk (/usr/local/bin/gpk) में सुव्यवस्थित करना।
डेस्कटॉप ऑटो-अनलॉक: Freedesktop Secret Service (org.freedesktop.secrets) के साथ सहज एकीकरण।

पूर्ण विनिर्देशों के लिए Phase 7 Roadmap_ और ADR-006_ देखें।

.. _Phase 7 Roadmap: docs/project/roadmaps/phase-7-pluggable-factors.rst .. _ADR-006: docs/adrs/2026-08-25-pluggable-auth-factors.rst

घटक

gpasskeyd: कोर सुरक्षा एन्क्लेव और वर्चुअल USB CTAP2/FIDO2 सुरक्षा कुंजी डेमन।
gpasskey-cli: वॉल्ट प्रबंधन और एन्क्रिप्टेड कॉन्फ़िगरेशन के लिए प्रशासनिक उपकरण।
age-plugin-gpasskey: age एन्क्रिप्शन उपकरण के लिए प्लगइन।
gpasskey-gpg: GnuPG-संगत साइनिंग और सत्यापन के लिए एमुलेशन ब्रिज।
gpasskey-ui: PIN प्रविष्टि के लिए ग्राफ़िकल सहायक।

विकास

यूनिट टेस्ट चलाएँ::

make test

पूर्ण Go-नेटिव इंटीग्रेशन सुइट चलाएँ (swtpm की आवश्यकता है)::

make integration-test

सहायता और दान

यदि आपको gpasskey उपयोगी लगता है और आप इसके निरंतर विकास का समर्थन करना चाहते हैं, तो Liberapay के माध्यम से दान करने पर विचार करें:

.. image:: https://liberapay.com/assets/widgets/donate.svg :target: https://liberapay.com/Renich/donate :alt: Donate using Liberapay

लाइसेंस

कॉपीराइट 2026 EVALinux

यह परियोजना GNU General Public License v3.0 या बाद वाले संस्करण के अंतर्गत लाइसेंस प्राप्त है। विवरण के लिए LICENSE फ़ाइल देखें।

gpasskey

सबसे लोकप्रिय

gpasskey

अवलोकन

मुख्य विशेषताएँ

TPM 2.0 एकीकरण

हम क्या योजना बना रहे हैं (चरण 7)

घटक

विकास

सहायता और दान

लाइसेंस