نام (NAME)

git-credential-store - ابزار کمکی برای ذخیره اطلاعات هویتی روی دیسک

خلاصه دستور (SYNOPSIS)

git config credential.helper 'store [<options>]'

توضیحات (DESCRIPTION)

نکته

استفاده از این ابزار کمکی، گذرواژه‌های شما را به صورت رمزگذاری‌نشده و فقط با محافظت مجوزهای سیستم فایل روی دیسک ذخیره می‌کند. اگر این یک مصالحه امنیتی قابل قبول برای شما نیست، git-credential-cache(1) را امتحان کنید، یا ابزار کمکی دیگری بیابید که با فضای ذخیره‌سازی امن ارائه‌شده توسط سیستم‌عامل شما یکپارچه شود.

این دستور، اطلاعات هویتی را برای استفاده در آینده توسط برنامه‌های گیت، به صورت نامحدود روی دیسک ذخیره می‌کند.

احتمالاً نمی‌خواهید این دستور را مستقیماً اجرا کنید؛ این دستور برای استفاده به عنوان یک ابزار کمکی اطلاعات هویتی توسط سایر بخش‌های گیت در نظر گرفته شده است. به gitcredentials(7) یا بخش مثال‌ها (EXAMPLES) در ادامه مراجعه کنید.

گزینه‌ها (OPTIONS)

--file=<path>

از <path> برای جستجو و ذخیره اطلاعات هویتی استفاده می‌کند. مجوزهای سیستم فایل این پرونده طوری تنظیم می‌شود که از خواندن آن توسط سایر کاربران سیستم جلوگیری شود، اما رمزگذاری نخواهد شد و به شکل دیگری محافظت نمی‌شود. در صورت عدم تعیین، اطلاعات هویتی در ~/.git-credentials و $XDG_CONFIG_HOME/git/credentials جستجو می‌شوند، و اطلاعات هویتی در ~/.git-credentials (در صورت وجود) یا در $XDG_CONFIG_HOME/git/credentials (اگر وجود داشته باشد و فایل اولی موجود نباشد) نوشته خواهند شد. همچنین بخش “فایل‌ها (FILES)” را ببینید.

فایل‌ها (FILES)

اگر با --file صریحاً مشخص نشده باشد، دو فایل وجود دارد که git-credential-store به ترتیب اولویت برای یافتن اطلاعات هویتی در آن‌ها جستجو می‌کند:

~/.git-credentials

فایل اطلاعات هویتی ویژه کاربر.

$XDG_CONFIG_HOME/git/credentials

دومین فایل اطلاعات هویتی ویژه کاربر. اگر $XDG_CONFIG_HOME تنظیم نشده یا خالی باشد، از $HOME/.config/git/credentials استفاده خواهد شد. هرگونه اطلاعات هویتی ذخیره‌شده در این فایل، در صورتی که ~/.git-credentials نیز دارای اطلاعات هویتی منطبق باشد، استفاده نخواهد شد. توصیه می‌شود در صورتی که گاهی از نسخه‌های قدیمی‌تر گیت که از این فایل پشتیبانی نمی‌کنند استفاده می‌کنید، این فایل را ایجاد نکنید.

برای جستجوی اطلاعات هویتی، فایل‌ها به ترتیبی که در بالا ذکر شد خوانده می‌شوند و اولین اطلاعات هویتی منطبقِ یافت‌شده، بر اطلاعات هویتی موجود در فایل‌های بعدی فهرست اولویت دارد.

ذخیره‌سازی اطلاعات هویتی به طور پیش‌فرض در اولین فایل موجود در فهرست نوشته می‌شود. اگر هیچ‌یک از این فایل‌ها وجود نداشته باشند، ~/.git-credentials ایجاد شده و در آن نوشته می‌شود.

هنگام پاک کردن اطلاعات هویتی، اطلاعات منطبق از تمام فایل‌ها پاک خواهند شد.

مثال‌ها (EXAMPLES)

هدف این ابزار کمکی کاهش دفعاتی است که باید نام کاربری یا گذرواژه خود را وارد کنید. برای مثال:

$ git config credential.helper store
$ git push http://example.com/repo.git
Username: <type your username>
Password: <type your password>
[several days later]
$ git push http://example.com/repo.git
[your credentials are used automatically]

قالب ذخیره‌سازی (STORAGE FORMAT)

فایل .git-credentials به صورت متن ساده (plaintext) ذخیره می‌شود. هر بخش از اطلاعات هویتی در یک خط جداگانه به صورت یک نشانی وب مانند زیر ذخیره می‌شود:

https://user:pass@example.com

هیچ نوع خط دیگری (مانند خطوط خالی یا خطوط توضیحات) در فایل مجاز نیست، حتی اگر برخی از آن‌ها بدون هشدار نادیده گرفته شوند. این فایل را با ویرایشگرها مشاهده یا ویرایش نکنید.

هنگامی که گیت برای یک بستر نشانی وب (URL) خاص به احراز هویت نیاز دارد، credential-store آن بستر را به عنوان الگویی برای تطبیق با هر ورودی در فایل اطلاعات هویتی در نظر می‌گیرد. اگر پروتکل، نام میزبان (hostname) و نام کاربری (در صورت وجود) مطابقت داشته باشند، گذرواژه به گیت بازگردانده می‌شود. برای اطلاعات بیشتر، به بحث پیرامون پیکربندی در gitcredentials(7) مراجعه کنید.

GIT

بخشی از مجموعه git(1)