gpg-agent - عبر الإنترنت في السحابة

برنامج:

اسم

وكيل gpg - إدارة المفاتيح السرية لـ GnuPG

موجز

وكيل gpg [- هومدير دير] [--والخيارات ملف] [الخيارات]
وكيل gpg [- هومدير دير] [--والخيارات ملف] [الخيارات] --الخادم
وكيل gpg [- هومدير دير] [--والخيارات ملف] [الخيارات] - ديمون [سطر الأوامر]

الوصف

وكيل gpg هو برنامج خفي لإدارة المفاتيح السرية (الخاصة) بشكل مستقل عن أي بروتوكول. هو - هي
يستخدم كخلفية ل المنافع العامة العالمية و com.gpgsm وكذلك لبضعة المرافق الأخرى.

يتم بدء تشغيل الوكيل تلقائيًا عند الطلب بواسطة المنافع العامة العالمية, com.gpgsm, com.gpgconfالطرق أو وكيل اتصال gpg.
وبالتالي لا يوجد سبب لبدء تشغيله يدويًا. في حالة رغبتك في استخدام Secure
وكيل شل يمكنك بدء الوكيل باستخدام:

gpg-الاتصال وكيل / وداعا

يجب عليك دائمًا إضافة الأسطر التالية إلى ملفك .bashrc أو أي ملف تهيئة
يستخدم لجميع استدعاءات الصدفة:

GPG_TTY=$(tty)
تصدير GPG_TTY

من المهم أن يعكس متغير البيئة هذا دائمًا مخرجات الملف الكتابة البعيدة
يأمر. بالنسبة لأنظمة W32، هذا الخيار غير مطلوب.

يرجى التأكد من تثبيت برنامج pinentry المناسب ضمن الإعداد الافتراضي
اسم الملف (الذي يعتمد على النظام) أو استخدم الخيار برنامج بينينتري لتحديد
الاسم الكامل لهذا البرنامج. غالبًا ما يكون من المفيد تثبيت رابط رمزي من الرابط الفعلي
تستخدم pinentry (على سبيل المثال '/usr/bin/pinentry-gtk') إلى المتوقع (على سبيل المثال
'/usr/bin/pinentry').

أوامر

لا يتم تمييز الأوامر عن الخيارات باستثناء حقيقة أن هناك أمرًا واحدًا فقط
المسموح به.

--الإصدار
اطبع نسخة البرنامج ومعلومات الترخيص. لاحظ أنه لا يمكنك ذلك
اختصر هذا الأمر.

--مساعدة

-h اطبع رسالة استخدام تلخص أكثر خيارات سطر الأوامر فائدة. لاحظ أن
لا يمكنك اختصار هذا الأمر.

- خيارات تفريغ
اطبع قائمة بجميع الخيارات والأوامر المتاحة. لاحظ أنه لا يمكنك ذلك
اختصر هذا الأمر.

--الخادم
قم بالتشغيل في وضع الخادم وانتظر الأوامر على ستدين. الوضع الافتراضي هو
قم بإنشاء مأخذ توصيل واستمع للأوامر هناك.

- ديمون [أمر خط]
ابدأ تشغيل وكيل gpg كبرنامج خفي؛ أي افصله عن وحدة التحكم وقم بتشغيله
الخلفية.

وكبديل، يمكنك إنشاء عملية جديدة باعتبارها فرعًا لـ gpg-agent: وكيل gpg
- ديمون / بن / ش. بهذه الطريقة تحصل على غلاف جديد مع إعداد البيئة
على وجه صحيح؛ بعد الخروج من هذه الصدفة، ينتهي gpg-agent خلال فترة قليلة
ثواني.

OPTIONS

--والخيارات ملف
يقرأ التكوين من ملف بدلاً من التكوين الافتراضي لكل مستخدم
ملف. ملف التكوين الافتراضي يسمى "gpg-agent.conf"والمتوقع في
'.gnupg"الدليل الموجود مباشرة أسفل الدليل الرئيسي للمستخدم.

- هومدير دير
اضبط اسم الدليل الرئيسي على دير. إذا لم يتم استخدام هذا الخيار ، المنزل
الدليل الافتراضي إلى '~ / .gnupg". يتم التعرف عليه فقط عند إعطائه للأمر
خط. كما أنه يتجاوز أي دليل رئيسي مذكور من خلال متغير البيئة
'غنوغ هومأو (في أنظمة Windows) عن طريق إدخال السجل
HKCU \ Software \ GNU \ GnuPG: HomeDir.

على أنظمة Windows ، من الممكن تثبيت GnuPG كتطبيق محمول. في
في هذه الحالة ، يتم اعتبار خيار سطر الأوامر هذا فقط ، وجميع الطرق الأخرى لتعيين منزل
يتم تجاهل الدليل.

لتثبيت GnuPG كتطبيق محمول ضمن Windows ، قم بإنشاء اسم ملف فارغ
'gpgconf.ctl"في نفس دليل الأداة"gpgconf.exe". جذر
التثبيت من هذا الدليل ؛ أو إذا 'gpgconf.exeتم تثبيت '
مباشرة أسفل دليل باسم "بن'، دليله الأصل. أنت أيضا بحاجة إلى
تأكد من أن الدلائل التالية موجودة وقابلة للكتابة: 'الجذر / المنزل' إلى عن على
منزل GnuPG و "ROOT / var / cache / gnupg2لملفات ذاكرة التخزين المؤقت الداخلية.

-v

- الإسراف
يخرج معلومات إضافية أثناء التشغيل. يمكنك زيادة الإسهاب من خلال
إعطاء عدة أوامر مطولة ل com.gpgsm، مثل "-vv".

-q

--هادئ
حاول أن تكون هادئًا قدر الإمكان.

--حزمة
لا تستدعي Pinentry أو تفعل أي شيء آخر يتطلب التفاعل البشري.

- مزيف-وقت النظام عصر
هذا الخيار مفيد فقط للاختبار ؛ يقوم بتعيين وقت النظام ذهابًا وإيابًا إلى
عصر وهو عدد الثواني المنقضية منذ عام 1970.

--مستوى التصحيح مستوى
حدد مستوى التصحيح للتحقيق في المشكلات. مستوى قد تكون قيمة رقمية أو
كلمة رئيسية:

لا شيء لا تصحيح على الإطلاق. يمكن استخدام قيمة أقل من 1 بدلاً من
الكلمة.

الأساسية بعض رسائل التصحيح الأساسية. يمكن استخدام قيمة بين 1 و 2 بدلاً من
الكلمة الرئيسية.

متقدم
المزيد من رسائل التصحيح المطول. يمكن استخدام قيمة بين 3 و 5 بدلاً من
الكلمة الرئيسية.

خبير رسائل أكثر تفصيلا. يمكن استخدام قيمة بين 6 و 8 بدلاً من
الكلمة الرئيسية.

المعلم كل رسائل التصحيح التي يمكنك الحصول عليها. يمكن استخدام قيمة أكبر من 8
بدلا من الكلمة الرئيسية. يتم تمكين إنشاء ملفات تتبع التجزئة فقط
إذا تم استخدام الكلمة الأساسية.

لم يتم تحديد كيفية تعيين هذه الرسائل إلى علامات التصحيح الفعلي وربما
التغيير مع أحدث إصدارات هذا البرنامج. ومع ذلك يتم اختيارهم بعناية للأفضل
المساعدة في التصحيح.

--Debug الأعلام
يعد هذا الخيار مفيدًا فقط لتصحيح الأخطاء وقد يتغير السلوك في أي وقت
دون سابق إنذار. يتم ترميز الأعلام بتات ويمكن تقديمها بلغة C المعتادة. ال
البتات المحددة حاليًا هي:

0 (1) البيانات المتعلقة ببروتوكول X.509 أو OpenPGP

1 (2) قيم الأعداد الصحيحة الكبيرة

2 (4) عمليات التشفير منخفضة المستوى

5 (32) تخصيص الذاكرة

6 (64) التخزين المؤقت

7 (128)
عرض إحصائيات الذاكرة.

9 (512)
كتابة البيانات المجزأة إلى الملفات المسماة ديبغمد-000*

10 (1024)
تتبع بروتوكول أسوان

12 (4096)
تجاوز كافة التحقق من صحة الشهادة

- الشطب الكل
مثل --debug=0xffffffff

--debug-wait n
عند التشغيل في وضع الخادم، انتظر n ثواني قبل الدخول في المعالجة الفعلية
حلقة وطباعة pid. وهذا يعطي الوقت لإرفاق مصحح الأخطاء.

--debug-quick-random
يمنع هذا الخيار استخدام مستوى الجودة العشوائي الآمن للغاية (Libgcrypt's
GCRY_VERY_STRONG_RANDOM) ويحط من جميع الطلبات وصولاً إلى الجودة العشوائية القياسية.
يتم استخدامه للاختبار فقط ولا يجوز استخدامه لأي مفاتيح جودة إنتاج.
يكون هذا الخيار فعالاً فقط عند تقديمه في سطر الأوامر.

--debug-pinentry
يمكّن هذا الخيار معلومات التصحيح الإضافية المتعلقة بـ Pinentry. اعتبارا من الآن
إنه مفيد فقط عند استخدامه مع --Debug 1024.

--لا انفصال
لا تقم بفصل العملية عن وحدة التحكم. وهذا مفيد بشكل أساسي لتصحيح الأخطاء.

-s

--ش

-c

--csh قم بتنسيق إخراج المعلومات في الوضع الخفي للاستخدام مع Bourne Shell القياسي أو
قذيفة C على التوالي. الافتراضي هو تخمينه بناءً على متغير البيئة
SHELL وهو الصحيح في جميع الحالات تقريبًا.

--لا انتزاع
أخبر Pinentry ألا يمسك بلوحة المفاتيح والماوس. يجب أن يكون هذا الخيار في
عام لا يمكن استخدامه لتجنب هجمات استنشاق X.

--ملف تسجيل ملف
إلحاق جميع مخرجات التسجيل بـ ملف. وهذا مفيد جدًا في رؤية ما يفعله الوكيل
في الواقع يفعل. إذا لم يتم تعيين ملف سجل أو واصف ملف سجل على ملف
منصة ويندوز، إدخال التسجيل HKCU\Software\GNU\GnuPG:DefaultLogFile، إذا
set، يُستخدم لتحديد إخراج التسجيل.

--no-allow-mark-trusted
لا تسمح للعملاء بوضع علامة على المفاتيح على أنها موثوقة، أي ضعها في ملف
'Trustlist.txt' ملف. وهذا يجعل من الصعب على المستخدمين قبول الجذر عن غير قصد
مفاتيح CA.

- السماح بعبارة مرور محددة مسبقًا
يسمح هذا الخيار باستخدام gpg-Presphrase لبذر ذاكرة التخزين المؤقت الداخلية لـ
وكيل gpg مع عبارات المرور.

--allow-loopback-pinentry
السماح للعملاء باستخدام ميزات الاسترجاع؛ انظر الخيار وضع pinentry
للتفاصيل.

--no-allow-external-cache
أخبر Pinentry بعدم تمكين الميزات التي تستخدم ذاكرة تخزين مؤقت خارجية لعبارات المرور.

تفضل بعض بيئات سطح المكتب فتح جميع بيانات الاعتماد بكلمة مرور رئيسية واحدة
وربما قمت بتثبيت Pinentry الذي يستخدم ذاكرة تخزين مؤقت خارجية إضافية
تنفيذ مثل هذه السياسة. باستخدام هذا الخيار، يُنصح Pinentry بعدم القيام بذلك
استخدم ذاكرة التخزين المؤقت هذه واطلب دائمًا من المستخدم عبارة المرور المطلوبة.

- السماح - إيماكس - الدبوس
اطلب من Pinentry السماح للميزات بتحويل إدخال عبارة المرور إلى Emacs قيد التشغيل
مثال. تعتمد كيفية التعامل مع هذا الأمر بالضبط على إصدار Pinentry المستخدم.

--تجاهل ذاكرة التخزين المؤقت للتوقيع
هذا الخيار سوف يسمح وكيل gpg تجاوز ذاكرة التخزين المؤقت لعبارة المرور لجميع التوقيعات
عملية. لاحظ أن هناك أيضًا خيارًا لكل جلسة للتحكم في هذا السلوك
ولكن خيار سطر الأوامر هذا له الأسبقية.

--default-cache-ttl n
قم بتعيين الوقت الذي يكون فيه إدخال ذاكرة التخزين المؤقت صالحًا n ثواني. الافتراضي 600 ثانية.
في كل مرة يتم فيها الوصول إلى إدخال ذاكرة التخزين المؤقت، تتم إعادة ضبط مؤقت الإدخال. لتعيين الإدخال
الحد الأقصى للعمر، الاستخدام الحد الأقصى لذاكرة التخزين المؤقت-TTL.

--default-cache-ttl-ssh n
قم بتعيين الوقت الذي يكون فيه إدخال ذاكرة التخزين المؤقت المستخدم لمفاتيح SSH صالحًا n ثواني. الافتراضي هو
1800 ثانية. في كل مرة يتم فيها الوصول إلى إدخال ذاكرة التخزين المؤقت، تتم إعادة ضبط مؤقت الإدخال. ل
قم بتعيين الحد الأقصى لعمر الإدخال، استخدم الحد الأقصى لذاكرة التخزين المؤقت-TTL-SSH.

- max-cache-ttl n
قم بتعيين الحد الأقصى للوقت الذي يكون فيه إدخال ذاكرة التخزين المؤقت صالحًا n ثواني. بعد هذا الوقت مخبأ
ستنتهي صلاحية الإدخال حتى لو تم الوصول إليه مؤخرًا أو تم تعيينه باستخدام
gpg-Presphrase. الافتراضي هو ساعتان (2 ثانية).

--max-cache-ttl-ssh n
قم بتعيين الحد الأقصى للوقت الذي يكون فيه إدخال ذاكرة التخزين المؤقت المستخدم لمفاتيح SSH صالحًا n ثواني. بعد
هذه المرة ستنتهي صلاحية إدخال ذاكرة التخزين المؤقت حتى لو تم الوصول إليه مؤخرًا أو
تم تعيينه باستخدام gpg-Presphrase. الافتراضي هو ساعتان (2 ثانية).

--فرض قيود عبارة المرور
قم بفرض قيود عبارة المرور من خلال عدم السماح للمستخدم بتجاوزها باستخدام
زر "خذها على أي حال".

--min-passphrase-len n
قم بتعيين الحد الأدنى لطول عبارة المرور. عند إدخال عبارة مرور جديدة أقصر
من هذه القيمة سيتم عرض تحذير. الافتراضي هو 8.

--min-passphrase-nonalpha n
قم بتعيين الحد الأدنى لعدد الأرقام أو الأحرف الخاصة المطلوبة في عبارة المرور.
عند إدخال عبارة مرور جديدة بأقل من هذا العدد من الأرقام أو خاص
الأحرف سيتم عرض تحذير. الإعدادات الافتراضية إلى 1.

--التحقق من نمط عبارة المرور ملف
تحقق من عبارة المرور مقابل النمط الوارد في ملف. عند الدخول جديد
عبارة المرور المطابقة لأحد هذه الأنماط سيتم عرض تحذير. ملف ينبغي
يكون اسم الملف المطلق. الافتراضي هو عدم استخدام أي ملف نمط.

ملاحظة أمنية: من المعروف أن التحقق من عبارة المرور مقابل قائمة الأنماط أو
حتى ضد القاموس الكامل ليس فعالًا جدًا لفرض الخير
عبارات المرور. سيكتشف المستخدمون قريبًا طرقًا لتجاوز مثل هذه السياسة. افضل
تتمثل السياسة في تثقيف المستخدمين بشأن السلوك الأمني ​​الجيد وتشغيل ملف
يقوم برنامج تكسير عبارة المرور بانتظام على عبارات مرور جميع المستخدمين للتعرف على العبارات البسيطة للغاية
منها.

--الحد الأقصى لعدد أيام عبارة المرور n
اطلب من المستخدم تغيير عبارة المرور إذا n لقد مرت أيام منذ التغيير الأخير.
بدافع --فرض قيود عبارة المرور تعيين لا يجوز للمستخدم تجاوز هذا الاختيار.

--enable-passphrase-history
هذا الخيار لا يفعل شيئًا حتى الآن.

--pinentry-invisible-char دبابة
يطلب هذا الخيار من Pinentry استخدامه دبابة لاظهار الحروف المخفية دبابة
يجب أن تكون سلسلة UTF-8 مكونة من حرف واحد. قد يحترم Pinentry هذا الطلب وقد لا يحترمه.

--مهلة pinentry n
يطلب هذا الخيار من Pinentry انتهاء المهلة بعد ذلك n ثواني بدون إدخال المستخدم. ال
القيمة الافتراضية 0 لا تطلب من Pinentry انتهاء المهلة، ولكن قد يستخدمها Pinentry
قيمة المهلة الافتراضية الخاصة بها في هذه الحالة. قد يحترم Pinentry هذا أو لا يحترمه
طلب.

--pinentry-برنامج اسم الملف
استخدم البرنامج اسم الملف كإدخال رقم التعريف الشخصي. الافتراضي هو التثبيت المعتمد.
مع التكوين الافتراضي، يكون اسم Pinentry الافتراضي هو 'دبابيس'; لو
هذا الملف غير موجود ولكن "دبوس أساسي' موجود يستخدم الأخير.

على نظام التشغيل Windows، يكون الوضع الافتراضي هو استخدام أول برنامج موجود من هذا البرنامج
قائمة: 'بن\pinentry.exe'،'..\Gpg4win\bin\pinentry.exe'،'..\Gpg4win\pinentry.exe'،
'..\GNU\GnuPG\pinentry.exe'،'..\GNU\bin\pinentry.exe'،'بن\pinentry-basic.exe'
حيث تكون أسماء الملفات مرتبطة بدليل تثبيت GnuPG.

--pinentry-touch-file اسم الملف
افتراضيًا، يتم تمرير اسم ملف مأخذ التوصيل gpg-agent الذي يستمع للطلبات
إلى Pinentry، حتى يتمكن من لمس هذا الملف قبل الخروج (يقوم بذلك فقط في
وضع اللعنات). يؤدي هذا الخيار إلى تغيير الملف الذي تم تمريره إلى Pinentry إلى اسم الملف.
اسم خاص / ديف / لاغية يمكن استخدامها لتعطيل هذه الميزة بشكل كامل. لاحظ أن
لن يقوم Pinentry بإنشاء هذا الملف، بل سيغير فقط التعديل والوصول
مرة.

--scdaemon-program اسم الملف
استخدم البرنامج اسم الملف مثل البرنامج الخفي للبطاقة الذكية. الافتراضي هو التثبيت
تعتمد ويمكن أن تظهر مع com.gpgconf أمر.

--disable-scdaemon
لا تستخدم أداة scdaemon. هذا الخيار له تأثير تعطيل
القدرة على القيام بعمليات البطاقة الذكية. لاحظ أن تمكين هذا الخيار في وقت التشغيل
لا يقتل scdaemon متشعب بالفعل.

--تعطيل التحقق من المقبس الخاص
وكيل gpg يستخدم اختبارًا ذاتيًا دوريًا للكشف عن المقبس المسروق. هذا عادة
يعني مثيل ثاني وكيل gpg وقد اتخذت على المقبس و وكيل gpg سوف
ثم إنهاء نفسه. يمكن استخدام هذا الخيار لتعطيل هذا الاختبار الذاتي لـ
أغراض التصحيح.

--استخدام المقبس القياسي

--no-use-standard-socket

--use-standard-socket-p
منذ GnuPG 2.1، يتم استخدام المقبس القياسي دائمًا. هذه الخيارات ليس لديها المزيد
تأثير. الامر وكيل gpg --use-standard-socket-p وبالتالي سوف يعود دائما
النجاح.

--عرض سلسلة

--ttyname سلسلة

- نوع سلسلة

--lc-ctype سلسلة

--lc- الرسائل سلسلة

--xauthority سلسلة
يتم استخدام هذه الخيارات مع وضع الخادم لتمرير معلومات الترجمة.

--keep-tty

--احتفظ بالعرض
تجاهل طلبات تغيير التيار الكتابة البعيدة أو نظام النوافذ X عرض متغير
على التوالى. يعد هذا مفيدًا لقفل أداة التثبيت لتنبثق عند الكتابة البعيدة أو العرض
لقد بدأت الوكيل.

--مقبس إضافي الاسم
استمع أيضًا إلى اتصالات وكيل gpg الأصلي على المقبس المحدد. الاستخدام المقصود
لهذا المقبس الإضافي هو إعداد مأخذ توصيل مجال Unix لإعادة توجيهه من جهاز التحكم عن بعد
الجهاز إلى هذا المقبس على الجهاز المحلي. أ المنافع العامة العالمية يعمل على الجهاز البعيد
ويمكنه بعد ذلك الاتصال بوكيل gpg المحلي واستخدام مفاتيحه الخاصة. هذا يسمح ل
فك تشفير البيانات أو تسجيلها على جهاز بعيد دون تعريض المفاتيح الخاصة للجهاز
آلة بعيدة.

--تمكين-SSH-الدعم

--تمكين المعجون الدعم

تمكين بروتوكول وكيل OpenSSH.

في وضع التشغيل هذا، لا يقوم الوكيل بتنفيذ وكيل gpg فقط
البروتوكول، ولكن أيضًا بروتوكول الوكيل الذي يستخدمه OpenSSH (من خلال مقبس منفصل).
وبالتالي، ينبغي أن يكون من الممكن استخدام وكيل gpg كبديل مباشر
لوكيل ssh المعروف.

يجب إضافة مفاتيح SSH، التي سيتم استخدامها من خلال الوكيل، إلى وكيل gpg
في البداية من خلال الأداة المساعدة ssh-add. عند إضافة مفتاح، سيطلب منك ssh-add
كلمة المرور لملف المفتاح المقدم وأرسل المادة الرئيسية غير المحمية إلى
عامل؛ يؤدي هذا إلى قيام وكيل gpg بطلب عبارة المرور التي سيتم استخدامها
تشفير المفتاح المستلم حديثًا وتخزينه في دليل خاص بعامل gpg.

بمجرد إضافة مفتاح إلى وكيل gpg بهذه الطريقة، سيكون وكيل gpg جاهزًا
استخدم المفتاح.

ملاحظة: في حالة تلقي وكيل gpg طلب توقيع، فقد يحتاج المستخدم إلى ذلك
تتم المطالبة بعبارة المرور، وهو أمر ضروري لفك تشفير المفتاح المخزن. منذ
لا يحتوي بروتوكول ssh-agent على آلية لإخبار الوكيل الذي عليه
العرض/المحطة قيد التشغيل، سيستخدم دعم ssh الخاص بـ gpg-agent جهاز TTY أو X
عرض المكان الذي بدأ فيه وكيل gpg. لتبديل هذا العرض إلى التيار
واحد، يمكن استخدام الأمر التالي:

gpg-connect-agent updatestartuptty /bye

على الرغم من أن جميع مكونات GnuPG تحاول تشغيل وكيل gpg حسب الحاجة، إلا أن هذا غير ممكن
للحصول على دعم ssh لأن ssh لا يعرف ذلك. وبالتالي إذا لم تكن هناك أداة GnuPG
إذا تم تشغيل الوكيل، فليس هناك ما يضمن أن ssh قادر على استخدام gpg-agent
للمصادقة. لإصلاح ذلك، يمكنك تشغيل gpg-agent إذا لزم الأمر باستخدام هذه الطريقة البسيطة
أمر:

gpg-الاتصال وكيل / وداعا

مضيفا - الإسراف يظهر التقدم المحرز في بدء الوكيل.

• --تمكين المعجون الدعم متاح فقط في نظام التشغيل Windows ويسمح باستخدام gpg-agent
مع تنفيذ SSH المعجون. وهذا مشابه لدعم وكيل ssh العادي ولكن
يستخدم قائمة انتظار رسائل Windows كما هو مطلوب بواسطة المعجون.

يمكن أيضًا توفير جميع الخيارات الطويلة في ملف التكوين بعد إزالة ملف
شرطتان رائدتان.

أمثلة

من المهم تعيين متغير البيئة GPG_TTY في واجهة تسجيل الدخول الخاصة بك، على سبيل المثال
في ال '~ / .bashrc'النص البرمجي الأولي:

تصدير GPG_TTY=$(tty)

إذا قمت بتمكين دعم وكيل Ssh، فستحتاج أيضًا إلى إخبار ssh بذلك عن طريق إضافة هذا إلى
البرنامج النصي init الخاص بك:

قم بإلغاء تعيين SSH_AGENT_PID
إذا [ "${gnupg_SSH_AUTH_SOCK_by:-0}" -ne $$ ]; ثم
تصدير SSH_AUTH_SOCK="${HOME}/.gnupg/S.gpg-agent.ssh"
fi

استخدم gpg-agent عبر الإنترنت باستخدام خدمات onworks.net