'\" t
.\"     Title: apt_auth.conf
.\"    Author: تیم APT
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 02\ \&December\ \&2019
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT_AUTH\&.CONF" "5" "02\ \&December\ \&2019" "APT 3.3.3" "APT"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
apt_auth.conf \- فایل اطلاعات احراز هویت برای منابع APT
.SH "توضیحات (DESCRIPTION)"
.PP
فایل‌های پیکربندی APT مانند
\fBsources.list\fR(5)
یا
\fBapt.conf\fR(5)
باید برای هر کسی که از ابزارهای apt روی سیستم استفاده می‌کند قابل دسترس باشند تا به تمام اطلاعات مرتبط با بسته‌ها مانند بسته‌های موجود در یک مخزن دسترسی داشته باشد\&. از سوی دیگر، اطلاعات ورود مورد نیاز برای اتصال به یک پروکسی یا بارگیری داده‌ها از یک مخزن نباید همواره در دسترس همگان باشد و بنابراین نمی‌توان آن‌ها را در فایلی با مجوزهای دسترسی خواندنی برای عموم قرار داد\&.
.PP
فایل auth\&.conf مربوط به APT در مسیر
/etc/apt/auth\&.conf
و فایل‌های \&.conf درون
/etc/apt/auth\&.conf\&.d
می‌توانند برای ذخیره اطلاعات ورود در قالبی شبیه به netrc با مجوزهای دسترسی محدود استفاده شوند\&.
.SH "قالب شبیه به NETRC (NETRC\-LIKE FORMAT)"
.PP
قالب تعریف‌شده در اینجا مشابه قالب فایل
~/\&.netrc
است که توسط
\fBftp\fR(1)
و برنامه‌های مشابه در تعامل با سرورها استفاده می‌شود\&. این یک قالب ساده مبتنی بر توکن است که در آن توکن‌های زیر شناخته می‌شوند؛ توکن‌های ناشناخته نادیده گرفته خواهند شد\&. توکن‌ها می‌توانند با فاصله، تب یا خط تازه از یکدیگر جدا شوند\&.
.PP
machine \fI[protocol://]\fR\fIhostname\fR[:\fIport\fR][/\fIpath\fR]
.RS 4
مدخل‌ها با جستجوی توکن
\fImachine\fR
منطبق با نام میزبان نشانی URI که apt به اطلاعات ورود آن نیاز دارد، پیدا می‌شوند\&. با گسترش قالب netrc، یک شماره پورت نیز می‌تواند مشخص شود\&. اگر هیچ پورتی تعیین نشود، توکن با تمام پورت‌ها مطابقت می‌یابد\&. به طور مشابه، مسیر اختیاری است و فقط زمانی مورد نیاز و مفید است که چندین مخزن با اطلاعات ورود مختلف روی یک سرور میزبانی شوند\&. یک توکن machine دارای مسیر زمانی تطبیق می‌یابد که مسیر درون URI با مسیر داده‌شده در توکن آغاز شود\&. پس از برقراری تطابق، توکن‌های بعدی پردازش می‌شوند و این پردازش با رسیدن به انتهای فایل یا مواجهه با یک توکن
\fImachine\fR
دیگر متوقف می‌شود\&.
.sp
اگر پروتکل مشخص نشود، مدخل تنها با https و tor+https تطبیق می‌یابد\&.
.RE
.PP
login \fIname\fR
.RS 4
نام کاربری مورد استفاده\&.
.RE
.PP
password \fIstring\fR
.RS 4
گذرواژه مورد استفاده\&.
.RE
.SH "مثال (EXAMPLE)"
.PP
ارائه اطلاعات ورود برای کاربری با نام
apt
و گذرواژه
debian
برای مدخل
\fBsources.list\fR(5)
.sp
.if n \{\
.RS 4
.\}
.nf
deb https://example\&.org/debian trixie main
.fi
.if n \{\
.RE
.\}
.sp
می‌تواند مستقیماً در خود مدخل انجام گیرد:
.sp
.if n \{\
.RS 4
.\}
.nf
deb https://apt:debian@example\&.org/debian trixie main
.fi
.if n \{\
.RE
.\}
.sp
به عنوان روش جایگزین، می‌توان از مدخلی مشابه زیر در فایل auth\&.conf استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
machine example\&.org
login apt
password debian
.fi
.if n \{\
.RE
.\}
.sp
یا به عنوان جایگزین در قالب یک خط واحد:
.sp
.if n \{\
.RS 4
.\}
.nf
machine example\&.org login apt password debian
.fi
.if n \{\
.RE
.\}
.sp
در صورت نیاز به جزئیات دقیق‌تر، تمام خط‌های زیر نیز برای مدخل نمونه اعمال خواهند شد:
.sp
.if n \{\
.RS 4
.\}
.nf
machine example\&.org/deb login apt password debian
machine example\&.org/debian login apt password debian
machine example\&.org/debian/ login apt password debian
.fi
.if n \{\
.RE
.\}
.sp
از سوی دیگر، هیچ‌یک از خط‌های زیر اعمال نخواهند شد:
.sp
.if n \{\
.RS 4
.\}
.nf
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
.fi
.if n \{\
.RE
.\}
.sp
.SH "یادداشت‌ها (NOTES)"
.PP
پشتیبانی اولیه از این قابلیت از نسخه 0\&.7\&.25 وجود داشته است، اما برای سال‌ها مستند نشده بود\&. مستندات در نسخه 1\&.5 افزوده شد و پیاده‌سازی نیز اندکی دستخوش تغییر گردید\&. برای حداکثر سازگاری با نسخه‌های گذشته باید از تعیین چندین توکن
machine
با نام میزبان یکسان پرهیز کنید، اما اگر به چندین مورد نیاز دارید همگی باید دارای یک مسیر مشخص در توکن
machine
باشند\&.
.PP
اطلاعات ورود در auth\&.conf انعطاف‌پذیرتر از موارد موجود در sources\&.list هستند\&. برای نمونه، اطلاعات ورود می‌توانند تنها برای بخش‌هایی از یک مخزن تعیین شوند، یا اگر مدخل sources\&.list به نشانی دیگری ریدایرکت شود، اطلاعات ورود برای مقصد ریدایرکت‌شده قابل ارائه خواهد بود\&.
.SH "فایل‌ها (FILES)"
.PP
/etc/apt/auth\&.conf
.RS 4
اطلاعات ورود برای منابع APT و پروکسی‌ها در قالبی شبیه به netrc\&. آیتم پیکربندی:
Dir::Etc::netrc\&.
.RE
.PP
/etc/apt/auth\&.conf\&.d/*\&.conf
.RS 4
اطلاعات ورود برای منابع APT و پروکسی‌ها در قالبی شبیه به netrc\&. آیتم پیکربندی:
Dir::Etc::netrcparts\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapt.conf\fR(5)
\fBsources.list\fR(5)
.SH "خطاها (BUGS)"
.PP
\m[blue]\fBصفحه باگ‌های APT\fR\m[]\&\s-2\u[1]\d\s+2\&. اگر تمایل به گزارش باگ در APT دارید، لطفاً
/usr/share/doc/debian/bug\-reporting\&.txt
یا دستور
\fBreportbug\fR(1)
را بررسی کنید\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBتیم APT\fR
.RS 4
.RE
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه باگ‌های APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE