git-credential - מקוון בענן

תָכְנִית:

שֵׁם

git-credential - אחזר ואחסן אישורי משתמש

תַקצִיר

git אישור

תיאור

ל-Git יש ממשק פנימי לאחסון ושליפה של אישורים ממערכת ספציפית
עוזרים, כמו גם הנחיה מהמשתמש לשמות משתמש וסיסמאות. ה-Git-אישור
הפקודה חושפת את הממשק הזה לסקריפטים שעשויים לרצות לאחזר, לאחסן או לבקש מהם
אישורים באותו אופן כמו Git. העיצוב של ממשק סקריפטים זה מדגים את
C API פנימי; לִרְאוֹת מה היא Git תְעוּדָה API[1] לרקע נוסף על המושגים.

git-credential לוקח אפשרות "פעולה" בשורת הפקודה (אחת של מילוי, אישור או
דחה) וקורא תיאור אישור ב-stdin (ראה פורמט קלט/פלט).

אם הפעולה היא מילוי, git-credential ינסה להוסיף "שם משתמש" ו"סיסמה"
מייחס לתיאור על ידי קריאת קובצי תצורה, על ידי פנייה לכל מוגדר
עוזרי אישורים, או באמצעות הנחיה למשתמש. תכונות שם המשתמש והסיסמה של
לאחר מכן מודפסים תיאור אישורים ל-stdout יחד עם התכונות כבר
בתנאי.

אם הפעולה תאושר, git-credential ישלח את התיאור לכל מוגדר
עוזרי אישורים, שעשויים לאחסן את האישור לשימוש מאוחר יותר.

אם הפעולה נדחית, git-credential ישלח את התיאור לכל מוגדר
עוזרי אישורים, אשר עשויים למחוק כל אישור מאוחסן התואם לתיאור.

אם הפעולה מאושרת או דוחה, אין לפלוט פלט.

טיפוסי להשתמש OF GIT תְעוּדָה

יישום המשתמש ב-git-credential ישתמש בדרך כלל ב-git credential בעקבות אלה
צעדים:

1. צור תיאור אישור בהתבסס על ההקשר.

לדוגמה, אם נרצה סיסמה עבור https://example.com/foo.git, אנו עשויים ליצור
תיאור האישור הבא (אל תשכח את השורה הריקה בסוף; הוא אומר
git אישור שהאפליקציה סיימה להזין את כל המידע שיש לה):

פרוטוקול=https
host=example.com
path=foo.git

2. בקש מ-git-credential לתת לנו שם משתמש וסיסמה עבור התיאור הזה. זה
נעשה על ידי הפעלת מילוי האישורים של git, הזנת התיאור משלב (1) לשלב שלו
קלט סטנדרטי. תיאור האישור המלא (כולל האישור כשלעצמו,
כלומר, הכניסה והסיסמה) יופקו על פלט סטנדרטי, כמו:

פרוטוקול=https
host=example.com
שם משתמש=בוב
סיסמה=secr3t

ברוב המקרים, המשמעות היא שהתכונות שניתנו בקלט יחזרו על עצמן ב-
פלט, אבל Git עשוי גם לשנות את תיאור האישורים, למשל על ידי הסרה
תכונת הנתיב כאשר הפרוטוקול הוא HTTP(s) ו-credential.useHttpPath הוא שקר.

אם האישור של git ידע על הסיסמה, ייתכן שהשלב הזה לא היה כרוך ב-
משתמש מקליד סיסמה זו בפועל (ייתכן שהמשתמש הקליד סיסמה כדי לפתוח את
מחזיק מפתחות במקום זאת, או שלא נעשתה אינטראקציה עם המשתמש אם מחזיק המפתחות כבר היה
unlocked) לפני שהוא החזיר את password=secr3t.

3. השתמש באישור (למשל, גש לכתובת האתר עם שם המשתמש והסיסמה מהשלב
(2)), ותראה אם ​​זה מתקבל.

4. דווח על הצלחה או כישלון של הסיסמה. אם האישור אפשר את
הפעולה תסתיים בהצלחה, אז ניתן לסמן אותה בפעולת "אישור".
תגיד ל-git credential לעשות בו שימוש חוזר בהזמנתו הבאה. אם האישור נדחה
במהלך הפעולה, השתמש בפעולת "דחה" כך ש-git credential יבקש א
סיסמה חדשה בהפעלתה הבאה. בכל מקרה, יש להזין אישורי git
תיאור האישור שהתקבל משלב (2) (שמכיל גם את אלה
מסופק בשלב (1)).

פלט קלט פורמט

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

האישור מפוצל לקבוצה של מאפיינים בעלי שם, עם תכונה אחת בכל שורה. כל אחד
התכונה מצוינת על ידי צמד מפתח-ערך, מופרד בסימן = (שווה), ואחריו
שורה חדשה. המפתח עשוי להכיל כל בתים מלבד =, newline או NUL. הערך עשוי להכיל
כל בתים מלבד newline או NUL. בשני המקרים, כל הבתים מטופלים כפי שהם (כלומר, שם
אינו מובא בציטוט, ואי אפשר להעביר ערך עם שורה חדשה או NUL בתוכו). רשימת
תכונות מסתיימות בשורה ריקה או בסוף הקובץ. Git מבין את הדברים הבאים
מאפיינים you

פרוטוקול
הפרוטוקול שעליו ישמש האישור (למשל, https).

המארח
שם המארח המרוחק עבור אישור רשת.

נתיב
הנתיב שאיתו ישמש האישור. למשל, לגישה ל-https מרחוק
מאגר, זה יהיה הנתיב של המאגר בשרת.

שם משתמש
שם המשתמש של האישור, אם כבר יש לנו אחד (למשל, מכתובת URL, מהמשתמש, או
ממסייע שהופעל בעבר).

סיסמא
הסיסמה של האישור, אם אנו מבקשים לשמור אותה.

כתובת אתר
כאשר התכונה המיוחדת הזו נקראת על ידי אישור git, הערך מנותח ככתובת URL
והתייחסו אליו כאילו נקראו החלקים המרכיבים שלו (למשל, url=https://example.com
תתנהג כאילו protocol=https ו-host=example.com סופקו). זה יכול לעזור
מתקשרים נמנעים מניתוח כתובות אתרים בעצמם. שים לב שכל רכיבים שחסרים
כתובת ה-URL (למשל, אין שם משתמש בדוגמה למעלה) תוגדר לריק; אם אתה
רוצה לספק כתובת URL ולעקוף כמה מאפיינים, ספק תחילה את תכונת ה-URL,
ואחריו כל ביטול.

אורים

1. ה-API של אישורי Git
file:///usr/share/doc/git/html/technical/api-credentials.html

השתמש ב-git-credential מקוון באמצעות שירותי onworks.net