نام (NAME)

apt_auth.conf - فایل اطلاعات احراز هویت برای منابع APT

توضیحات (DESCRIPTION)

فایل‌های پیکربندی APT مانند sources.list(5) یا apt.conf(5) باید برای هر کسی که از ابزارهای apt روی سیستم استفاده می‌کند قابل دسترس باشند تا به تمام اطلاعات مرتبط با بسته‌ها مانند بسته‌های موجود در یک مخزن دسترسی داشته باشد. از سوی دیگر، اطلاعات ورود مورد نیاز برای اتصال به یک پروکسی یا بارگیری داده‌ها از یک مخزن نباید همواره در دسترس همگان باشد و بنابراین نمی‌توان آن‌ها را در فایلی با مجوزهای دسترسی خواندنی برای عموم قرار داد.

فایل auth.conf مربوط به APT در مسیر /etc/apt/auth.conf و فایل‌های .conf درون /etc/apt/auth.conf.d می‌توانند برای ذخیره اطلاعات ورود در قالبی شبیه به netrc با مجوزهای دسترسی محدود استفاده شوند.

قالب شبیه به NETRC (NETRC-LIKE FORMAT)

قالب تعریف‌شده در اینجا مشابه قالب فایل ~/.netrc است که توسط ftp(1) و برنامه‌های مشابه در تعامل با سرورها استفاده می‌شود. این یک قالب ساده مبتنی بر توکن است که در آن توکن‌های زیر شناخته می‌شوند؛ توکن‌های ناشناخته نادیده گرفته خواهند شد. توکن‌ها می‌توانند با فاصله، تب یا خط تازه از یکدیگر جدا شوند.

machine [protocol://]hostname[:port][/path]

مدخل‌ها با جستجوی توکن machine منطبق با نام میزبان نشانی URI که apt به اطلاعات ورود آن نیاز دارد، پیدا می‌شوند. با گسترش قالب netrc، یک شماره پورت نیز می‌تواند مشخص شود. اگر هیچ پورتی تعیین نشود، توکن با تمام پورت‌ها مطابقت می‌یابد. به طور مشابه، مسیر اختیاری است و فقط زمانی مورد نیاز و مفید است که چندین مخزن با اطلاعات ورود مختلف روی یک سرور میزبانی شوند. یک توکن machine دارای مسیر زمانی تطبیق می‌یابد که مسیر درون URI با مسیر داده‌شده در توکن آغاز شود. پس از برقراری تطابق، توکن‌های بعدی پردازش می‌شوند و این پردازش با رسیدن به انتهای فایل یا مواجهه با یک توکن machine دیگر متوقف می‌شود.

اگر پروتکل مشخص نشود، مدخل تنها با https و tor+https تطبیق می‌یابد.

login name

نام کاربری مورد استفاده.

password string

گذرواژه مورد استفاده.

مثال (EXAMPLE)

ارائه اطلاعات ورود برای کاربری با نام apt و گذرواژه debian برای مدخل sources.list(5)

deb https://example.org/debian trixie main

می‌تواند مستقیماً در خود مدخل انجام گیرد:

deb https://apt:debian@example.org/debian trixie main

به عنوان روش جایگزین، می‌توان از مدخلی مشابه زیر در فایل auth.conf استفاده کرد:

machine example.org
login apt
password debian

یا به عنوان جایگزین در قالب یک خط واحد:

machine example.org login apt password debian

در صورت نیاز به جزئیات دقیق‌تر، تمام خط‌های زیر نیز برای مدخل نمونه اعمال خواهند شد:

machine example.org/deb login apt password debian
machine example.org/debian login apt password debian
machine example.org/debian/ login apt password debian

از سوی دیگر، هیچ‌یک از خط‌های زیر اعمال نخواهند شد:

machine example.org:443 login apt password debian
machine example.org/deb/ login apt password debian
machine example.org/ubuntu login apt password debian
machine example.orga login apt password debian
machine example.net login apt password debian

یادداشت‌ها (NOTES)

پشتیبانی اولیه از این قابلیت از نسخه 0.7.25 وجود داشته است، اما برای سال‌ها مستند نشده بود. مستندات در نسخه 1.5 افزوده شد و پیاده‌سازی نیز اندکی دستخوش تغییر گردید. برای حداکثر سازگاری با نسخه‌های گذشته باید از تعیین چندین توکن machine با نام میزبان یکسان پرهیز کنید، اما اگر به چندین مورد نیاز دارید همگی باید دارای یک مسیر مشخص در توکن machine باشند.

اطلاعات ورود در auth.conf انعطاف‌پذیرتر از موارد موجود در sources.list هستند. برای نمونه، اطلاعات ورود می‌توانند تنها برای بخش‌هایی از یک مخزن تعیین شوند، یا اگر مدخل sources.list به نشانی دیگری ریدایرکت شود، اطلاعات ورود برای مقصد ریدایرکت‌شده قابل ارائه خواهد بود.