gpg-agent - מקוון בענן

תָכְנִית:

שֵׁם

gpg-agent - ניהול מפתח סודי עבור GnuPG

תַקצִיר

gpg-agent [--homedir dir] [--אפשרויות פילה] [אפשרויות]
gpg-agent [--homedir dir] [--אפשרויות פילה] [אפשרויות] --שרת
gpg-agent [--homedir dir] [--אפשרויות פילה] [אפשרויות] --דימון [command_line]

תיאור

gpg-agent הוא דמון לניהול מפתחות סודיים (פרטיים) ללא תלות מכל פרוטוקול. זה
משמש כקצה אחורי עבור Gpg ו gpgsm כמו גם עבור כמה כלי עזר אחרים.

הסוכן מופעל אוטומטית לפי דרישה על ידי Gpg, gpgsm, gpgconf, או gpg-connect-agent.
לכן אין סיבה להפעיל אותו ידנית. למקרה שתרצה להשתמש ב-Secure הכלול
Shell Agent אתה יכול להפעיל את הסוכן באמצעות:

gpg-connect-agent /bye

אתה תמיד צריך להוסיף את השורות הבאות שלך .bashrc או כל קובץ אתחול
משמש עבור כל קריאות המעטפת:

GPG_TTY=$(tty)
ייצא GPG_TTY

חשוב שמשתנה סביבה זה תמיד ישקף את הפלט של ה- tty
פקודה. עבור מערכות W32 אפשרות זו אינה נדרשת.

אנא ודא שתוכנית pinentry מתאימה הותקנה תחת ברירת המחדל
שם הקובץ (התלוי במערכת) או השתמש באפשרות תוכנית pinentry כדי לציין את
השם המלא של אותה תוכנית. לעתים קרובות כדאי להתקין קישור סמלי מהמציאות
השתמשו ב-pinentry (למשל '/usr/bin/pinentry-gtk') לצפוי (למשל
"/usr/bin/pinentry').

פקודות

אין להבדיל בין פקודות לאפשרויות למעט העובדה שרק פקודה אחת כן
מותר.

--גִרְסָה
הדפס את גרסת התוכנית ומידע הרישוי. שים לב שאתה לא יכול
קיצור פקודה זו.

- עזרה

-h הדפס הודעת שימוש המסכמת את אפשרויות שורת הפקודה השימושיות ביותר. ציין זאת
אתה לא יכול לקצר את הפקודה הזו.

--אפשרויות dump
הדפס רשימה של כל האפשרויות והפקודות הזמינות. שים לב שאתה לא יכול
קיצור פקודה זו.

--שרת
הפעל במצב שרת והמתן לפקודות ב- סטדין. מצב ברירת המחדל הוא ל
ליצור שקע ולהאזין לפקודות שם.

--דימון [הפקודה קו]
הפעל את ה-gpg-agent בתור דמון; כלומר, לנתק אותו מהקונסולה ולהפעיל אותו פנימה
הרקע.

כחלופה תוכל ליצור תהליך חדש בתור ילד של gpg-agent: gpg-agent
--דימון / Bin / sh. בדרך זו אתה מקבל מעטפת חדשה עם הגדרת הסביבה
כראוי; לאחר יציאה מהמעטפת הזו, ה-gpg-agent מסתיים תוך כמה
שניות.

אפשרויות

--אפשרויות פילה
קורא תצורה מ פילה במקום מתצורת ברירת המחדל לכל משתמש
קוֹבֶץ. קובץ התצורה המוגדר כברירת מחדל נקרא 'gpg-agent.conf' וצפוי ב
".gnupg' ספרייה ישירות מתחת לספריית הבית של המשתמש.

--homedir dir
הגדר את שם ספריית הבית ל dir. אם אפשרות זו אינה בשימוש, הבית
ברירת המחדל של הספרייה היא '~/.gnupg'. זה מזוהה רק כאשר ניתן בפקודה
קַו. זה גם עוקף כל ספרייה ביתית המוצהרת דרך משתנה הסביבה
"GNUPGHOME' או (במערכות Windows) באמצעות ערך הרישום
HKCU\Software\GNU\GnuPG:HomeDir.

במערכות Windows אפשר להתקין את GnuPG כאפליקציה ניידת. ב
במקרה זה רק אפשרות שורת הפקודה הזו נחשבת, כל שאר הדרכים להגדיר בית
מתעלמים מהספרייה.

כדי להתקין את GnuPG כאפליקציה ניידת תחת Windows, צור שם קובץ ריק
"gpgconf.ctl' באותה ספרייה כמו הכלי 'gpgconf.exe'. השורש של ה
ההתקנה היא מהספרייה הזו; או אם 'gpgconf.exe' הותקן
ישירות מתחת לספרייה בשם 'בן', ספריית האב שלו. אתה גם צריך
ודא שהספריות הבאות קיימות וניתנות לכתיבה: 'שורש/בית' ל
הבית של GnuPG ו'ROOT/var/cache/gnupg2' עבור קבצי מטמון פנימיים.

-v

--מִלוּלִי
מוציא מידע נוסף תוך כדי ריצה. אתה יכול להגביר את המלל על ידי
מתן מספר פקודות מילוליות ל gpgsm, כגון '-vv'.

-q

--שֶׁקֶט
נסה להיות כמה שיותר שקט.

--קבוצה
אל תזעיק מבנה או תעשה שום דבר אחר הדורש אינטראקציה אנושית.

--זמן מערכת מזויף תקופה
אפשרות זו שימושית רק לבדיקה; הוא מגדיר את זמן המערכת קדימה או אחורה
תקופה שהוא מספר השניות שחלפו מאז שנת 1970.

--רמת ניפוי באגים רָמָה
בחר את רמת ניפוי הבאגים לחקירת בעיות. רָמָה יכול להיות ערך מספרי או
מילת מפתח:

אף לא אחד אין איתור באגים בכלל. ניתן להשתמש בערך של פחות מ-1 במקום ה-
מילת מפתח.

בסיסי כמה הודעות ניפוי באגים בסיסיות. ניתן להשתמש בערך בין 1 ל-2 במקום
מילת המפתח.

מתקדם
הודעות ניפוי באגים מפורטות יותר. ניתן להשתמש בערך בין 3 ל-5 במקום
מילת המפתח.

מומחה הודעות אפילו יותר מפורטות. ניתן להשתמש בערך בין 6 ל-8 במקום
מילת המפתח.

גורו כל הודעות ניפוי הבאגים שאתה יכול לקבל. ניתן להשתמש בערך גדול מ-8
במקום מילת המפתח. היצירה של קובצי מעקב אחר hash מופעלת רק
אם נעשה שימוש במילת המפתח.

אופן מיפוי ההודעות הללו לדגלי ניפוי הבאגים לא מצוין ועשויים
לשנות עם מהדורות חדשות יותר של תוכנית זו. עם זאת, הם נבחרו בקפידה על הצד הטוב ביותר
סיוע באיתור באגים.

--לנפות דגלים
אפשרות זו שימושית רק עבור ניפוי באגים וההתנהגות עשויה להשתנות בכל עת
ללא הודעה מוקדמת. דגלים מקודדים בסיביות ועשויים להינתן בתחביר C הרגיל. ה
ביטים המוגדרים כעת הם:

0 (1) נתונים הקשורים לפרוטוקול X.509 או OpenPGP

1 (2) ערכים של מספרים שלמים של מספרים גדולים

2 (4) פעולות קריפטו ברמה נמוכה

5 (32) הקצאת זיכרון

6 (64) מטמון

7 (128)
להראות סטטיסטיקות זיכרון.

9 (512)
כתוב נתונים hash לקבצים בשם dbgmd-000*

10 (1024)
לעקוב אחר פרוטוקול אסואן

12 (4096)
לעקוף את כל אימות האישורים

--- debug-all
כמו --debug=0xffffffff

--באוג-חכה n
כאשר פועל במצב שרת, המתן n שניות לפני הכניסה לעיבוד בפועל
לולאה והדפיס את ה-Pid. זה נותן זמן לצרף באגים.

--debug-quick-random
אפשרות זו מונעת את השימוש ברמת האיכות האקראית המאוד מאובטחת (של Libgcrypt
GCRY_VERY_STRONG_RANDOM) ומדרדר את כל הבקשות לאיכות אקראית סטנדרטית.
הוא משמש רק לבדיקה ולא ישמש עבור כל מפתחות איכות ייצור.
אפשרות זו יעילה רק כאשר היא ניתנת בשורת הפקודה.

--debug-pinentry
אפשרות זו מאפשרת מידע נוסף על ניפוי באגים הנוגע ל-Pinentry. נכון לעכשיו
זה שימושי רק בשימוש יחד עם --לנפות 1024.

--ללא ניתוק
אל תנתק את התהליך מהקונסולה. זה שימושי בעיקר עבור איתור באגים.

-s

--ש

-c

--csh פרמט את פלט המידע במצב daemon לשימוש עם מעטפת Bourne הסטנדרטית או עם
C-shell בהתאמה. ברירת המחדל היא לנחש זאת על סמך משתנה הסביבה
SHELL מה שנכון כמעט בכל המקרים.

--לא לתפוס
אמור ל-pinentry לא לתפוס את המקלדת והעכבר. אפשרות זו צריכה להיכנס
כללי לא לשמש כדי למנוע התקפות של רחרוח X.

--קובץ לוג פילה
הוסף את כל פלט הרישום ל פילה. זה מאוד עוזר לראות מה הסוכן
בעצם עושה. אם לא הוגדרו קובץ יומן או מתאר קובץ יומן ב-a
פלטפורמת Windows, ערך הרישום HKCU\Software\GNU\GnuPG:DefaultLogFile, אם
set, משמש לציון פלט הרישום.

--לא-לאפשר-סימן-מהימן
אל תאפשר ללקוחות לסמן מפתחות כאמינים, כלומר להכניס אותם ל-
"trustlist.txt'קובץ. זה מקשה על המשתמשים לקבל בטעות שורש-
מפתחות CA.

--allow-preset-passphrase
אפשרות זו מאפשרת שימוש ב gpg-preset-passphrase כדי לראות את המטמון הפנימי של
gpg-agent עם ביטויי סיסמה.

--allow-loopback-pinentry
אפשר ללקוחות להשתמש בתכונות ה-pinentry של loopback; לראות את האפשרות מצב pinentry
לקבלת פרטים.

--no-allow-external-cache
אמור ל-Pinentry לא להפעיל תכונות המשתמשות במטמון חיצוני עבור ביטויי סיסמה.

חלק מסביבות שולחן העבודה מעדיפות לפתוח את כל האישורים באמצעות סיסמת אב אחת
וייתכן שהתקינו Pinentry שמשתמש במטמון חיצוני נוסף
ליישם מדיניות כזו. על ידי שימוש באפשרות זו ל-Pinentry מומלץ לא לעשות
שימוש במטמון כזה ובמקום זאת תמיד לבקש מהמשתמש את ביטוי הסיסמה המבוקש.

--allow-emacs-pinentry
אמור ל-Pinentry לאפשר לתכונות להסיט את הערך של ביטוי הסיסמה ל-Emacs פועל
למשל. איך זה מטופל בדיוק תלוי בגרסה של Pinentry בשימוש.

--תעלם-מטמון-לחתימה
אפשרות זו תאפשר gpg-agent לעקוף את המטמון של ביטוי הסיסמה לכל החתימות
מבצע. שים לב שישנה גם אפשרות לכל הפעלה לשלוט בהתנהגות זו
אבל אפשרות שורת הפקודה הזו מקבלת עדיפות.

--default-cache-ttl n
הגדר את השעה שבה רשומת המטמון תקפה n שניות. ברירת המחדל היא 600 שניות.
בכל פעם שניגשים לערך מטמון, הטיימר של הערך מאופס. כדי להגדיר ערך
חיים מקסימליים, שימוש max-cache-ttl.

--default-cache-ttl-ssh n
הגדר את הזמן שבו רשומת מטמון המשמשת עבור מפתחות SSH תקפה n שניות. ברירת המחדל היא
1800 שניות. בכל פעם שניגשים לערך מטמון, הטיימר של הערך מאופס. ל
הגדר את משך החיים המרבי של ערך, השתמש max-cache-ttl-ssh.

--max-cache-ttl n
הגדר את הזמן המקסימלי שרשומה במטמון תקפה n שניות. לאחר הזמן הזה מטמון
תוקף הערך יפוג גם אם ניגשו אליו לאחרונה או הוגדר באמצעות
gpg-preset-passphrase. ברירת המחדל היא שעתיים (2 שניות).

--max-cache-ttl-ssh n
הגדר את הזמן המקסימלי שרשומה מטמון המשמשת עבור מפתחות SSH תקפה n שניות. לאחר
הפעם פג תוקפו של ערך מטמון גם אם ניגשו אליו לאחרונה או
הוגדר באמצעות gpg-preset-passphrase. ברירת המחדל היא שעתיים (2 שניות).

--לאכוף-ביטוי-סיסמה-אילוצים
אכוף את אילוצי ביטוי הסיסמה על ידי אי מתן אפשרות למשתמש לעקוף אותם באמצעות
הלחצן ``קח את זה בכל זאת''.

--min-passphrase-len n
הגדר את האורך המינימלי של ביטוי סיסמה. בהזנת ביטוי סיסמה חדש קצר יותר
מעבר לערך זה תוצג אזהרה. ברירת המחדל היא 8.

---min-passphrase-nonalpha n
הגדר את המספר המינימלי של ספרות או תווים מיוחדים הנדרשים בביטוי סיסמה.
בעת הזנת ביטוי סיסמה חדש עם פחות ממספר הספרות הזה או מיוחד
תווים תוצג אזהרה. ברירת המחדל היא 1.

--בדוק-phrase-pattern פילה
בדוק את ביטוי הסיסמה מול התבנית המופיעה ב פילה. כאשר נכנסים חדש
ביטוי סיסמה התואם לאחת מהדפוסים הללו תוצג אזהרה. פילה צריך
להיות שם קובץ מוחלט. ברירת המחדל היא לא להשתמש בקובץ דפוס כלשהו.

הערת אבטחה: ידוע שבדיקת ביטוי סיסמה מול רשימה של דפוס או
אפילו נגד מילון שלם אינו יעיל במיוחד לאכוף טוב
ביטויי סיסמה. המשתמשים ימצאו בקרוב דרכים לעקוף מדיניות כזו. טוב יותר
המדיניות היא ללמד את המשתמשים על התנהגות אבטחה טובה ובאופן אופציונלי להפעיל א
ביטויי סיסמה מפצח באופן קבוע על כל ביטויי הסיסמה של המשתמשים כדי לתפוס את הפשוט מאוד
יחידות.

--max-phrase-days n
בקש מהמשתמש לשנות את ביטוי הסיסמה אם n ימים חלפו מאז השינוי האחרון.
עם --לאכוף-ביטוי-סיסמה-אילוצים הגדר שהמשתמש לא יוכל לעקוף בדיקה זו.

--enable-phrase-history
אפשרות זו עדיין לא עושה כלום.

--pinentry-invisible-char char
אפשרות זו מבקשת מה-Pinentry להשתמש char להצגת תווים נסתרים. char
חייב להיות מחרוזת UTF-8 תו אחד. A Pinentry עשוי לכבד בקשה זו או לא.

---pinentry-timeout n
אפשרות זו מבקשת מה-Pinentry לקבוע פסק זמן לאחר מכן n שניות ללא קלט משתמש. ה
ערך ברירת המחדל של 0 אינו מבקש מה-pinentry להגדיר פסק זמן, אולם Pinentry עשוי להשתמש
ערך ברירת המחדל לזמן קצוב משלו במקרה זה. A Pinentry עשוי לכבד זאת או לא
בַּקָשָׁה.

---pinentry-program שם הקובץ
השתמש בתוכנית שם הקובץ בתור הזנת ה-PIN. ברירת המחדל היא תלויה בהתקנה.
עם תצורת ברירת המחדל השם של ברירת המחדל של pinentry הוא 'פסנתר'; אם
הקובץ הזה לא קיים אלא 'pinentry-בסיסיקיים בשימוש האחרון.

בפלטפורמת Windows ברירת המחדל היא להשתמש בתוכנית הקיימת הראשונה מכאן
רשימה: 'bin\pinentry.exe','..\Gpg4win\bin\pinentry.exe','..\Gpg4win\pinentry.exe',
"..\GNU\GnuPG\pinentry.exe','..\GNU\bin\pinentry.exe','bin\pinentry-basic.exe"
כאשר שמות הקבצים הם ביחס לספריית ההתקנה של GnuPG.

--pinentry-touch-file שם הקובץ
כברירת מחדל, שם הקובץ של ה-socket gpg-agent מאזין לבקשות מועבר
ל-Pinentry, כדי שהוא יוכל לגעת בקובץ הזה לפני היציאה (הוא עושה זאת רק ב
מצב קללות). אפשרות זו משנה את הקובץ שהועבר ל-Pinentry ל שם הקובץ. ה
שם מיוחד / dev / null ניתן להשתמש כדי להשבית לחלוטין תכונה זו. ציין זאת
Pinentry לא תיצור את הקובץ הזה, היא רק תשנה את השינוי והגישה
הזמן.

--- scdaemon-program שם הקובץ
השתמש בתוכנית שם הקובץ בתור הדמון של הכרטיס החכם. ברירת המחדל היא התקנה
תלוי וניתן להציג אותו עם gpgconf פקודה.

--disable-scdaemon
אל תעשה שימוש בכלי scdaemon. אפשרות זו משפיעה על השבתת ה
יכולת לבצע פעולות כרטיס חכם. שימו לב, הפעלת אפשרות זו בזמן ריצה
לא הורג סקדאמון שכבר מפוצל.

--disable-check-own-socket
gpg-agent משתמש בבדיקה עצמית תקופתית כדי לזהות שקע גנוב. זה בדרך כלל
פירושו מופע שני של gpg-agent השתלט על השקע ו gpg-agent יצטרך
ואז לסיים את עצמו. ניתן להשתמש באפשרות זו כדי להשבית בדיקה עצמית זו עבור
למטרות איתור באגים.

--השתמש בשקע-סטנדרטי

--אין-שימוש-תקן-שקע

-- use-standard-socket-p
מאז GnuPG 2.1 תמיד נעשה שימוש בשקע הסטנדרטי. לאפשרויות האלה אין יותר
השפעה. הפקודה gpg-agent -- use-standard-socket-p כך תמיד יחזור
הצלחה.

--לְהַצִיג מחרוזת

--ttyname מחרוזת

--ttytype מחרוזת

--lc-ctype מחרוזת

--lc-messages מחרוזת

-- סמכות מחרוזת
אפשרויות אלה משמשות עם מצב השרת כדי להעביר מידע לוקליזציה.

--שמור-tty

--שמור-תצוגה
התעלם מבקשות לשנות את הזרם tty או מערכת חלונות X תצוגה משתנה
בהתאמה. זה שימושי כדי לנעול את ה-pinentry כדי לצוץ ב tty או להציג
התחלת את הסוכן.

--שקע נוסף שם
האזינו גם לחיבורי gpg-agent מקוריים בשקע הנתון. השימוש המיועד
עבור שקע נוסף זה הוא להגדיר העברת שקע תחום Unix מרחוק
מכונה לשקע זה במכונה המקומית. א Gpg פועל על המחשב המרוחק
לאחר מכן עשוי להתחבר ל-gpg-agent המקומי ולהשתמש במפתחות הפרטיים שלו. זה מאפשר
פענוח או חתימה על נתונים במחשב מרוחק מבלי לחשוף את המפתחות הפרטיים ל-
מכונה מרוחקת.

--enable-ssh-support

--enable-putty-support

הפעל את פרוטוקול OpenSSH Agent.

במצב פעולה זה, הסוכן לא מיישם רק את ה-gpg-agent
פרוטוקול, אלא גם פרוטוקול הסוכן המשמש את OpenSSH (דרך שקע נפרד).
כתוצאה מכך, זה אמור להיות אפשרי להשתמש ב-gpg-agent כתחליף drop-in
עבור ה-ssh-agent הידוע.

יש להוסיף מפתחות SSH, שבהם יש להשתמש דרך הסוכן, ל-gpg-agent
בתחילה דרך כלי השירות ssh-add. כאשר מפתח נוסף, ssh-add יבקש
את הסיסמה של קובץ המפתח שסופק ולשלוח את חומר המפתח הלא מוגן אל
סוֹכֵן; זה גורם ל-gpg-agent לבקש ביטוי סיסמה, שעבורו יש להשתמש
הצפנת המפתח החדש שהתקבל ואחסוןו בספרייה ספציפית ל-gpg-agent.

לאחר הוספת מפתח ל-gpg-agent בדרך זו, ה-gpg-agent יהיה מוכן
להשתמש במפתח.

הערה: במקרה שה-gpg-agent יקבל בקשת חתימה, ייתכן שהמשתמש יצטרך לקבל זאת
תתבקש להזין ביטוי סיסמה, הדרוש לפענוח המפתח המאוחסן. מאז
פרוטוקול ssh-agent אינו מכיל מנגנון למידע לסוכן שעליו
הצג/טרמינל שהוא פועל, ה-ssh-support של gpg-agent ישתמש ב-TTY או ב-X
להציג היכן הופעל gpg-agent. כדי להעביר את התצוגה הנוכחית
האחת, ניתן להשתמש בפקודה הבאה:

gpg-connect-agent updatestartuptty /bye

למרות שכל רכיבי GnuPG מנסים להפעיל את ה-gpg-agent לפי הצורך, זה לא אפשרי
לתמיכת ssh כי ssh לא יודע על זה. כך אם אין כלי GnuPG אשר
גישה לסוכן הופעל, אין ערובה ש-ssh מסוגל להשתמש ב-gpg-agent
לצורך אימות. כדי לתקן את זה, אתה יכול להפעיל את gpg-agent במידת הצורך באמצעות זה פשוט
פקודה:

gpg-connect-agent /bye

הוספת ה- --מִלוּלִי מציג את ההתקדמות של הפעלת הסוכן.

אל האני --enable-putty-support זמין רק תחת Windows ומאפשר שימוש ב-gpg-agent
עם יישום ssh מרק. זה דומה לתמיכה הרגילה של ssh-agent אבל
עושה שימוש בתור הודעות של Windows כנדרש על ידי מרק.

כל האפשרויות הארוכות עשויות להינתן גם בקובץ התצורה לאחר הסרת ה-
שני מקפים מובילים.

דוגמאות

חשוב להגדיר את משתנה הסביבה GPG_TTY במעטפת ההתחברות שלך, למשל
בתוך ה '~ / .bashrc' סקריפט init:

ייצוא GPG_TTY=$(tty)

אם הפעלת את התמיכה של סוכן Ssh, אתה גם צריך לספר ל-ssh על זה על ידי הוספת זה
סקריפט הפתיחה שלך:

בטל את ההגדרה של SSH_AGENT_PID
if [ "${gnupg_SSH_AUTH_SOCK_by:-0}" -ne $$ ]; לאחר מכן
ייצוא SSH_AUTH_SOCK="${HOME}/.gnupg/S.gpg-agent.ssh"
fi

השתמש ב-gpg-agent באינטרנט באמצעות שירותי onworks.net