.lf 1 "-
.TH SLAPPW-ARGON2 5 "2026/03/09" "OpenLDAP 2.6.13"
.\" Copyright 2020-2026 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH "نام (NAME)"
slappw\-argon2 \- ماژول رمزنگاری گذرواژه بر پایه الگوریتم Argon2 برای slapd
.SH "خلاصه دستور (SYNOPSIS)"
/etc/openldap/slapd.conf
.RS
.LP
.B moduleload argon2
.RI [ <parameters> ]
.RE
.SH "توضیحات (DESCRIPTION)"
.LP
ماژول
.B argon2
برای
.BR slapd (8)
پشتیبانی از استفاده از تابع اشتقاق کلید Argon2 را که در ژوئیه ۲۰۱۵ به عنوان برنده رقابت درهم‌سازی گذرواژه‌ها (Password Hashing Competition) برگزیده شد، برای گذرواژه‌های درهم‌سازی‌شده در OpenLDAP فراهم می‌کند.
.LP
این کار با ارائه طرح گذرواژه اضافی
.B {ARGON2}
جهت استفاده در slapd انجام می‌شود.

.SH "پیکربندی (CONFIGURATION)"
ماژول
.B argon2
به هیچ پیکربندی خاصی نیاز ندارد، اما می‌توان با تعیین پارامترهای زیر آن را پیکربندی کرد:
.TP
.BI m= <memory>
میزان استفاده از حافظه را روی
.I <memory>
کیبی‌بایت (kiB) تنظیم می‌کند.
.TP
.BI p= <parallelism>
میزان موازی‌سازی را روی
.I <parallelism>
رشته (thread) تنظیم می‌کند. در حال حاضر فقط هنگام پیوند با
.BR libargon2
پشتیبانی می‌شود.
.TP
.BI t= <iterations>
تعداد تکرارها را روی
.I <iterations>
تنظیم می‌کند.
.LP
این مقادیر در صورت امکان، هنگام آماده‌سازی هش‌ها برای گذرواژه‌های جدید جایگزین مقادیر پیش‌فرض می‌شوند.
.LP
پس از بارگذاری ماژول، طرح گذرواژه
.B {ARGON2}
در مقادیر مشخصه
.I userPassword
شناسایی خواهد شد.
.LP
سپس می‌توانید با استفاده از گزینه
.BR password-hash
در
.BR slapd.conf (5)،
به OpenLDAP دستور دهید که در هنگام پردازش عملیات گسترش‌یافته Password Modify در LDAPv3 (بر اساس RFC 3062) از این طرح استفاده کند:
.RS
.LP
.B password\-hash {ARGON2}
.RE
.LP

.SS "نکات (NOTES)"
اگر می‌خواهید از طرح شرح‌داده‌شده در اینجا به همراه
.BR slappasswd (8)
استفاده کنید، به یاد داشته باشید که ماژول را با استفاده از گزینه‌های خط فرمان آن بارگذاری نمایید.
گزینه/مقدار مربوطه به این صورت است:
.RS
.LP
.B \-o
.BR module\-load = argon2
.LP
.RE
یا اگر پارامترهای غیرپیش‌فرض مورد نیاز باشند:
.RS
.LP
.B \-o
.BR module\-load =" argon2
.RB [ <param> ...]"
.LP
.RE
بسته به مکان
.BR argon2 ،
ممکن است به این گزینه نیز نیاز داشته باشید:
.RS
.LP
.B \-o
.BR module\-path = \fIpathspec\fP
.RE

.SH "مثال‌ها (EXAMPLES)"
هر دو مشخصه LDAP از نوع userPassword در زیر، گذرواژه
.RI ' secret '
را با استفاده از سالت‌های (salt) متفاوت کدگذاری می‌کنند:
.EX
.LP
userPassword: {ARGON2}$argon2i$v=19$m=4096,t=3,p=1$c2FsdHNhbHQ$DKlexoEJUoZTmkAAC3SaMWk30El9/RvVhlqGo6afIng
.LP
userPassword: {ARGON2}$argon2i$v=19$m=4096,t=3,p=1$c2FsdHNhbHRzYWx0$qOCkx9nMeFlaGOO4DUmPDgrlUbgMMuO9T1+vQCFuyzw
.EE

.SH "همچنین ببینید (SEE ALSO)"
.BR slapd.conf (5),
.BR ldappasswd (1),
.BR slappasswd (8),
.BR ldap (3),
.LP
.UR http://www.OpenLDAP.org/doc
"OpenLDAP Administrator's Guide"
.UE
.LP

.SH "قدردانی (ACKNOWLEDGEMENTS)"
این صفحه راهنما توسط Peter Marschall بر اساس فایل README ماژول نوشته‌شده توسط
.MT simon@levermann.de
Simon Levermann
.ME
نگاشته شده است.
.LP
.B OpenLDAP
توسط
.UR http://www.openldap.org
پروژه OpenLDAP
.UE
توسعه یافته و نگهداری می‌شود.
.B OpenLDAP
از انتشار LDAP 3.3 دانشگاه میشیگان برگرفته شده است.