'\" t
.\"     Title: idmap_ldap
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/16/2026
.\"    Manual: System Administration tools
.\"    Source: Samba 4.24.6
.\"  Language: Persian
.\"
.TH "IDMAP_LDAP" "8" "08/16/2026" "Samba 4\&.24\&.6" "System Administration tools"
.\" -----------------------------------------------------------------
.\" * 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)"
idmap_ldap \- بک‌اند idmap_ldap سامبا برای Winbind
.SH "توضیحات (DESCRIPTION)"
.PP
پلاگین idmap_ldap سازوکاری را برای Winbind فراهم می‌کند تا جدول‌های نگاشت SID/uid/gid را در یک سرویس دایرکتوری LDAP ذخیره و بازیابی کند\&.
.PP
برخلاف بک‌اندهای فقط‌خواندنی مانند idmap_rid، این بک‌اند از نوع تخصیص‌دهنده (allocating) است؛ به این معنی که برای ایجاد نگاشت‌های جدید، باید شناسه‌های کاربری و گروهی جدیدی را تخصیص دهد\&.
.SH "گزینه‌های IDMAP (IDMAP OPTIONS)"
.PP
ldap_base_dn = DN
.RS 4
پسوند پایه دایرکتوری (base suffix) را برای استفاده در مدخل‌های نگاشت SID/uid/gid مشخص می‌کند\&. اگر تعریف نشود، idmap_ldap به‌طور پیش‌فرض از گزینه "ldap idmap suffix" در فایل
/etc/samba/smb\&.conf
استفاده خواهد کرد\&.
.RE
.PP
ldap_user_dn = DN
.RS 4
نام متمایز کاربر (user DN) را که برای احراز هویت استفاده می‌شود تعیین می‌کند\&. رمز عبور برای احراز هویت این کاربر باید با دستور net idmap secret ذخیره شود (به
\fBnet\fR(8)
مراجعه کنید)\&. در صورت عدم وجود، از اعتبارنامه‌های ldap پیکربندی ldap passdb استفاده می‌شود و اگر آن‌ها نیز وجود نداشته باشند، به عنوان آخرین راه‌حل یک اتصال ناشناس (anonymous bind) انجام خواهد شد\&.
.RE
.PP
ldap_url = ldap://server/
.RS 4
سرور LDAP مورد استفاده برای مدخل‌های نگاشت SID/uid/gid را مشخص می‌کند\&. اگر تعریف نشود، idmap_ldap فرض می‌کند که باید از ldap://localhost استفاده شود\&.
.RE
.PP
range = low \- high
.RS 4
محدوده در دسترس UID و GID منطبق را مشخص می‌کند که این بک‌اند نسبت به آن‌ها مرجعیت دارد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
مثال زیر نشان می‌دهد چگونه یک دایرکتوری ldap به عنوان بک‌اند پیش‌فرض idmap استفاده می‌شود\&. این مثال همچنین محدوده idmap و پسوند دایرکتوری پایه را پیکربندی می‌کند\&. رمز عبور مربوط به ldap_user_dn باید با "net idmap secret \*(Aq*\*(Aq password" تنظیم شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
	[global]
	idmap config * : backend      = ldap
	idmap config * : range        = 1000000\-1999999
	idmap config * : ldap_url     = ldap://localhost/
	idmap config * : ldap_base_dn = ou=idmap,dc=example,dc=com
	idmap config * : ldap_user_dn = cn=idmap_admin,dc=example,dc=com
.fi
.if n \{\
.RE
.\}
.PP
این مثال نشان می‌دهد که چگونه می‌توان از ldap به عنوان یک بک‌اند فقط‌خواندنی استفاده کرد، در حالی که tdb بک‌اند پیش‌فرض مورد استفاده برای ذخیره نگاشت‌ها است\&. این مثال یک پیکربندی صریح برای دامنه‌ای به نام DOM1 اضافه می‌کند که از بک‌اند ldap idmap استفاده می‌نماید\&. توجه داشته باشید که از محدوده‌ای مجزا از محدوده پیش‌فرض استفاده شده است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
	[global]
	# "backend = tdb" is redundant here since it is the default
	idmap config * : backend = tdb
	idmap config * : range = 1000000\-1999999

	idmap config DOM1 : backend = ldap
	idmap config DOM1 : range = 2000000\-2999999
	idmap config DOM1 : read only = yes
	idmap config DOM1 : ldap_url = ldap://server/
	idmap config DOM1 : ldap_base_dn = ou=idmap,dc=dom1,dc=example,dc=com
	idmap config DOM1 : ldap_user_dn = cn=idmap_admin,dc=dom1,dc=example,dc=com
.fi
.if n \{\
.RE
.\}
.SH "نکته (NOTE)"
.PP
برای استفاده از احراز هویت در برابر سرورهای ldap ممکن است نیاز به ارائه یک DN و یک رمز عبور داشته باشید\&. به منظور جلوگیری از قرارگیری رمز عبور به صورت متن ساده در فایل پیکربندی، آن را در یک مخزن امنیتی ذخیره می‌کنیم\&. دستور "net idmap" برای ذخیره یک رمز عبور برای DN مشخص‌شده در یک دامنه خاص idmap استفاده می‌شود\&.
.SH "نویسنده (AUTHOR)"
.PP
نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند\&. Samba اکنون توسط Samba Team به عنوان یک پروژه متن‌باز و مشابه شیوه توسعه هسته لینوکس توسعه داده می‌شود\&.