.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH XMLSEC1 "1" "June 2026" "xmlsec1 1.3.12 (openssl)" "User Commands"
.SH "نام (NAME)"
xmlsec1 \- امضا، اعتبارسنجی، رمزنگاری و رمزگشایی اسناد XML
.SH "خلاصه دستور (SYNOPSIS)"
.B xmlsec
\fI\,<command> \/\fR[\fI\,<options>\/\fR] [\fI\,<files>\/\fR]
.SH "توضیحات (DESCRIPTION)"
ابزار xmlsec یک ابزار خط فرمانی برای امضا، اعتبارسنجی، رمزنگاری و
رمزگشایی اسناد XML است. مقادیر مجاز برای <command> عبارتند از:
.TP
\fB\-\-help\fR
نمایش این اطلاعات راهنما و خروج
.TP
\fB\-\-help\-all\fR
نمایش اطلاعات راهنما برای تمام دستورها/گزینه‌ها و خروج
.TP
\fB\-\-help\-\fR<cmd>
نمایش اطلاعات راهنما برای دستور <cmd> و خروج
.TP
\fB\-\-version\fR
چاپ اطلاعات نسخه و خروج
.TP
\fB\-\-keys\fR
دستکاری فایل XML کلیدها
.TP
\fB\-\-sign\fR
امضای داده‌ها و تولید سند خروجی XML
.TP
\fB\-\-verify\fR
اعتبارسنجی سند امضاشده
.TP
\fB\-\-encrypt\fR
رمزنگاری داده‌ها و تولید سند خروجی XML
.TP
\fB\-\-decrypt\fR
رمزگشایی داده‌ها از سند XML
.SH "گزینه‌ها (OPTIONS)"
.HP
\fB\-\-ignore\-manifests\fR
.IP
عناصر <dsig:Manifest> پردازش نشوند
.HP
\fB\-\-store\-references\fR
.IP
ذخیره و چاپ نتیجه پردازش عنصر <dsig:Reference/>
درست پیش از محاسبه چکیده (digest)
.HP
\fB\-\-store\-signatures\fR
.IP
ذخیره و چاپ نتیجه پردازش <dsig:Signature>
درست پیش از محاسبه امضا
.HP
\fB\-\-enabled\-reference\-uris\fR <list>
.IP
فهرستی از مقادیر زیر که با کاما از هم جدا شده‌اند:
"empty"،‏ "same\-doc"،‏ "local"،‏ "remote" برای محدود کردن مقادیر مجاز
ویژگی URI برای عنصر <dsig:Reference>
.HP
\fB\-\-enable\-visa3d\-hack\fR
.IP
فعال‌سازی ترفند مختص پروتکل Visa3D برای پردازش ویژگی‌های URI در حالتی
که تلاش می‌شود از موتور XPath/XPointer استفاده نشود؛ این یک ترفند موقت
است و مشخص نیست چه موارد دیگری در برنامه شما با استفاده از آن دچار
اختلال شود (همچنین گزینه "\-\-id\-attr" را بررسی کنید، چرا که ممکن است به آن نیاز داشته باشید)
.HP
\fB\-\-enable\-asn1\-signatures\-hack\fR
.IP
فعال‌سازی پشتیبانی از مقادیر امضای ASN1 که توسط برخی پیاده‌سازی‌های XMLDsig
تولید شده‌اند.
.HP
\fB\-\-hmac\-min\-out\-len\fR <bits>
.IP
تنظیم حداقل طول خروجی HMAC به اندازه <bits>
.HP
\fB\-\-binary\-data\fR <file>
.IP
فایل باینری <file> برای رمزنگاری
.HP
\fB\-\-xml\-data\fR <file>
.IP
فایل XML با نام <file> برای رمزنگاری
.HP
\fB\-\-enabled\-cipher\-reference\-uris\fR <list>
.IP
فهرستی از مقادیر زیر که با کاما از هم جدا شده‌اند:
"empty"،‏ "same\-doc"،‏ "local"،‏ "remote" برای محدود کردن مقادیر مجاز
ویژگی URI برای عنصر <enc:CipherReference>
.HP
\fB\-\-session\-key\fR <keyKlass>\-<keySize>
.IP
تولید کلید نشست (session key) جدید از نوع <keyKlass> به اندازه <keySize> بیت
(برای نمونه، "\-\-session des\-192" یک کلید جدید ۱۹۲ بیتی DES
برای رمزنگاری DES3 تولید می‌کند)
.HP
\fB\-\-output\fR <filename>
.IP
نوشتن سند خروجی در فایل <filename>؛ مقدار <filename> می‌تواند
یک الگو باشد و شامل '{inputfile}' باشد که با نام فایل
ورودی جایگزین خواهد شد
.HP
\fB\-\-print\-debug\fR
.IP
چاپ اطلاعات اشکال‌زدایی در stdout
.HP
\fB\-\-print\-xml\-debug\fR
.IP
چاپ اطلاعات اشکال‌زدایی در stdout به قالب xml
.HP
\fB\-\-dtd\-file\fR <file>
.IP
بارگذاری فایل مشخص‌شده به عنوان DTD
.HP
\fB\-\-node\-id\fR <id>
.IP
تنظیم نقطه شروع عملیات بر روی گره با شناسه <id> داده‌شده
.HP
\fB\-\-node\-name\fR [<namespace\-uri>:]<name>
.IP
تنظیم نقطه شروع عملیات بر روی اولین گره
با <name> و URI فضای‌نام <namespace> مشخص‌شده
.HP
\fB\-\-node\-xpath\fR <expr>
.IP
تنظیم نقطه شروع عملیات بر روی نخستین گره
انتخاب‌شده توسط عبارت XPath داده‌شده
.HP
\fB\-\-id\-attr[\fR:<attr\-name>] [<node\-namespace\-uri>:]<node\-name>
.IP
افزودن ویژگی‌های <attr\-name> (مقدار پیش‌فرض "id") از تمام گره‌های
دارای <node\-name> و فضای‌نام <node\-namespace\-uri> به فهرست
ویژگی‌های شناسه (ID) شناخته‌شده؛ این یک ترفند است و در صورت امکان
به جای آن از DTD یا schema برای تعریف ویژگی‌های ID استفاده کنید (گزینه "\-\-dtd\-file" را ببینید)
.HP
\fB\-\-add\-id\-attr\fR <id\-attribute\-name>
.IP
افزودن ویژگی <id\-attribute\-name> به تمام گره‌های سند؛
این یک ترفند است و در صورت امکان به جای آن از DTD یا schema برای
تعریف ویژگی‌های ID استفاده کنید (گزینه "\-\-dtd\-file" را ببینید)
.HP
\fB\-\-enabled\-key\-data\fR <list>
.IP
فهرست جداشده با کاما از انواع key\-data برای فعال‌سازی.
مثال:
.TP
rsa,key\-value,x509
\-> عنصر <RSAKeyValue> را پر کرده و <X509Data> را نگه می‌دارد
.TP
هنگامی که جای‌نگهدارنده‌های <KeyValue/> و <X509Data/>
در الگو موجود باشند.
.IP
برای دیدن فهرست کامل کلاس‌های ثبت‌شده key data از "\-\-list\-key\-data" استفاده کنید.
به طور پیش‌فرض، تمام داده‌های کلید ثبت‌شده فعال هستند.
.HP
\fB\-\-enabled\-retrieval\-method\-uris\fR <list>
.IP
فهرستی از مقادیر زیر که با کاما از هم جدا شده‌اند:
"empty"،‏ "same\-doc"،‏ "local"،‏ "remote" برای محدود کردن مقادیر مجاز
ویژگی URI برای عنصر <dsig:RetrievalMethod>.
.HP
\fB\-\-enabled\-key\-info\-reference\-uris\fR <list>
.IP
فهرستی از مقادیر زیر که با کاما از هم جدا شده‌اند:
"empty"،‏ "same\-doc"،‏ "local"،‏ "remote" برای محدود کردن مقادیر مجاز
ویژگی URI برای عنصر <dsig11:KeyInfoReference>.
.HP
\fB\-\-gen\-key[\fR:<name>] <keyKlass>\-<keySize>
.IP
تولید یک کلید جدید <keyKlass> به اندازه <keySize> بیت،
تنظیم نام کلید به <name> و افزودن نتیجه به مدیر
کلیدها (برای نمونه، "\-\-gen:MyKeyName rsa\-1024" یک
کلید جدید ۱۰۲۴ بیتی RSA تولید کرده و نام آن را "MyKeyName" می‌گذارد)
.HP
\fB\-\-keys\-file\fR <file>
.IP
بارگذاری کلیدها از فایل XML
.HP
\fB\-\-privkey\-pem[\fR:<name>] <file>[,<cafile>[,<cafile>[...]]]
.IP
بارگذاری کلید خصوصی از فایل PEM و گواهی‌هایی
که این کلید را تأیید می‌کنند
.HP
\fB\-\-privkey\-der[\fR:<name>] <file>[,<cafile>[,<cafile>[...]]].IP
بارگذاری کلید خصوصی از فایل DER و گواهی‌هایی
که این کلید را تأیید می‌کنند
.HP
\fB\-\-pkcs8\-pem[\fR:<name>] <file>[,<cafile>[,<cafile>[...]]]
.IP
بارگذاری کلید خصوصی از فایل PKCS8 PEM و گواهی‌های PEM
که این کلید را تأیید می‌کنند
.HP
\fB\-\-pkcs8\-der[\fR:<name>] <file>[,<cafile>[,<cafile>[...]]]
.IP
بارگذاری کلید خصوصی از فایل PKCS8 DER و گواهی‌های DER
که این کلید را تأیید می‌کنند
.HP
\fB\-\-privkey\-openssl\-store[\fR:<name>] <uri>
.IP
بارگذاری کلید خصوصی و گواهی‌ها از طریق رابط ossl_store در OpenSSL (برای نمونه از HSM)
.HP
\fB\-\-privkey\-openssl\-engine[\fR:<name>] <openssl\-engine>;<openssl\-key\-id>[,<crtfile>[,<crtfile>[...]]]
.IP
بارگذاری کلید خصوصی از طریق رابط ENGINE در OpenSSL؛ تعیین نام موتور
(مانند پارامترهای \fB\-engine\fR)، مشخصات کلید (مانند پارامترهای \fB\-inkey\fR یا \fB\-key\fR)
و در صورت تمایل گواهی‌هایی که این کلید را تأیید می‌کنند
.HP
\fB\-\-pubkey\-pem[\fR:<name>] <file>
.IP
بارگذاری کلید عمومی از فایل PEM
.HP
\fB\-\-pubkey\-der[\fR:<name>] <file>
.IP
بارگذاری کلید عمومی از فایل DER
.HP
\fB\-\-pubkey\-openssl\-store[\fR:<name>] <uri>
.IP
بارگذاری کلید عمومی و گواهی‌ها از طریق رابط ossl_store در OpenSSL (برای نمونه از HSM)
.HP
\fB\-\-pubkey\-openssl\-engine[\fR:<name>] <openssl\-engine>;<openssl\-key\-id>[,<crtfile>[,<crtfile>[...]]]
.IP
بارگذاری کلید عمومی از طریق رابط ENGINE در OpenSSL؛ تعیین نام موتور
(مانند پارامترهای \fB\-engine\fR)، مشخصات کلید (مانند پارامترهای \fB\-inkey\fR یا \fB\-key\fR)
و در صورت تمایل گواهی‌هایی که این کلید را تأیید می‌کنند
.HP
\fB\-\-pwd\fR <password>
.IP
گذرواژه مورد استفاده برای خواندن کلیدها و گواهی‌ها
.HP
\fB\-\-lax\-key\-search\fR
.IP
فعال‌سازی جست‌وجوی آسان‌گیرانهٔ کلید (برای نمونه بر پایهٔ نوع کلید مانند "rsa") در برابر حالت پیش‌فرضِ
جست‌وجوی سخت‌گیرانه با استفادهٔ صرف از اطلاعات گره <dsig:KeyInfo/> (برای نمونه نام کلید)
.HP
\fB\-\-verify\-keys\fR
.IP
اجبار به اعتبارسنجی کلیدهای عمومی/خصوصی بارگذاری‌شده از دستور: کلیدها باید
دارای یک گواهی کلید باشند که در برابر گواهی‌های موجود در مخزن کلید اعتبارسنجی خواهد شد
.HP
\fB\-\-aes\-key[\fR:<name>] <file>
.IP
بارگذاری کلید AES از فایل باینری <file>
.HP
\fB\-\-camellia\-key[\fR:<name>] <file>
.IP
بارگذاری کلید Camellia از فایل باینری <file>
.HP
\fB\-\-chacha20\-key[\fR:<name>] <file>
.IP
بارگذاری کلید ChaCha20 از فایل باینری <file>
.HP
\fB\-\-concatkdf\-key[\fR:<name>] <file>
.IP
بارگذاری کلید ConcatKDF از فایل باینری <file>
.HP
\fB\-\-des\-key[\fR:<name>] <file>
.IP
بارگذاری کلید DES از فایل باینری <file>
.HP
\fB\-\-hmac\-key[\fR:<name>] <file>
.IP
بارگذاری کلید HMAC از فایل باینری <file>
.HP
\fB\-\-pbkdf2\-key[\fR:<name>] <file>
.IP
بارگذاری کلید Pbkdf2 از فایل باینری <file>
.HP
\fB\-\-hkdf\-key[\fR:<name>] <file>
.IP
بارگذاری کلید HKDF‏ (IKM) از فایل باینری <file>
.HP
\fB\-\-pkcs12[\fR:<name>] <file>
.IP
بارگذاری کلید خصوصی از فایل pkcs12 <file>
.HP
\fB\-\-pkcs12\-persist\fR
.IP
ماندگار کردن کلید خصوصی بارگذاری‌شده
.HP
\fB\-\-pubkey\-cert\-pem[\fR:<name>] <file>
.IP
بارگذاری کلید عمومی از فایل گواهی PEM
.HP
\fB\-\-pubkey\-cert\-der[\fR:<name>] <file>
.IP
بارگذاری کلید عمومی از فایل گواهی DER
.HP
\fB\-\-trusted\-pem\fR <file>
.IP
بارگذاری گواهی معتمد (ریشه) از فایل PEM <file>
.HP
\fB\-\-untrusted\-pem\fR <file>
.IP
بارگذاری گواهی نامعتمد از فایل PEM <file>
.HP
\fB\-\-trusted\-der\fR <file>
.IP
بارگذاری گواهی معتمد (ریشه) از فایل DER <file>
.HP
\fB\-\-untrusted\-der\fR <file>
.IP
بارگذاری گواهی نامعتمد از فایل DER <file>
.HP
\fB\-\-crl\-pem\fR <file>
.IP
بارگذاری CRLها از فایل PEM <file>
.HP
\fB\-\-crl\-der\fR <file>
.IP
بارگذاری CRLها از فایل DER <file>
.HP
\fB\-\-verify\-crls\fR
.IP
اجبار به اعتبارسنجی CRLهای بارگذاری‌شده: CRLها باید امضای معتبری
از گواهی صادرکننده در مخزن گواهی‌های معتمد یا نامعتمد داشته باشند و
باید در دورهٔ اعتبار خود (thisUpdate/nextUpdate) باشند
.HP
\fB\-\-verification\-time\fR <time>
.IP
زمان محلی در قالب "YYYY\-MM\-DD HH:MM:SS"
مورد استفاده برای اعتبارسنجی گواهی‌ها
.HP
\fB\-\-verification\-gmt\-time\fR <time>
.IP
زمان GMT در قالب "YYYY\-MM\-DD HH:MM:SS"
مورد استفاده برای اعتبارسنجی گواهی‌ها
.HP
\fB\-\-X509\-skip\-time\-checks\fR
.IP
صرف‌نظر کردن از بررسی زمانی گواهی‌های X509 و CRLها
.HP
\fB\-\-depth\fR <number>
.IP
بیشینهٔ عمق زنجیرهٔ گواهی‌ها
.HP
\fB\-\-X509\-skip\-strict\-checks\fR
.IP
صرف‌نظر کردن از بررسی دقیق داده‌های X509
.HP
\fB\-\-insecure\fR
.IP
عدم اعتبارسنجی گواهی‌ها یا CRLها
.HP
\fB\-\-crypto\fR <name>
.IP
نام موتور رمزنگاری مورد استفاده از فهرست روبرو:
openssl، mscrypto، nss، gnutls، gcrypt (اگر هیچ موتور رمزنگاری مشخص
نشده باشد، از گزینهٔ پیش‌فرض استفاده می‌شود)
.HP
\fB\-\-crypto\-config\fR <path>
.IP
مسیر پیکربندی موتور رمزنگاری
.HP
\fB\-\-verbose\fR
.IP
چاپ پیام‌های خطای مفصل
.HP
\fB\-\-print\-crypto\-library\-errors\fR
.IP
چاپ خطاهای کتابخانهٔ رمزنگاری (تنها برای OpenSSL)
.HP
\fB\-\-repeat\fR <number>
.IP
تکرار عملیات به تعداد <number> بار
.HP
\fB\-\-base64\-line\-size\fR <size>.IP
حداکثر اندازه خط را برای کدگذاری‌های base64 روی <size> تنظیم می‌کند.
.HP
\fB\-\-transform\-binary\-chunk\-size\fR <size>
.IP
اندازه تکه (chunk) پردازش دودویی تبدیلات را روی <size> تنظیم می‌کند؛
افزایش اندازه تکه ممکن است کارایی را به بهای افزایش مصرف حافظه
بهبود بخشد.
.HP
\fB\-\-transform\-max\-depth\fR <depth>
.IP
حداکثر عمق را برای اجرای تبدیلات روی <depth> تنظیم می‌کند؛
برای غیرفعال کردن بررسی بیشینه عمق، آن را روی 0 قرار دهید.
.HP
\fB\-\-xxe\fR
.IP
تفکیک موجودیت‌های خارجی (External Entity resolution) را فعال می‌کند.
هشدار: این کار ممکن است امکان خواندن فایل‌ها و نشانی‌های دلخواه را
تحت کنترل سند XML ورودی فراهم کند. با احتیاط استفاده شود!
.HP
\fB\-\-url\-map\fR:<url> <file>
.IP
یک <url> مشخص را برای بارگیری منابع خارجی به <file> تعیین‌شده نگاشت می‌کند.
.HP
\fB\-\-help\fR
.IP
اطلاعات راهنما پیرامون دستور را چاپ می‌کند.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Aleksey Sanin <aleksey@aleksey.com>.
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به http://www.aleksey.com/xmlsec/bugs.html
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2002\-2026 Aleksey Sanin <aleksey@aleksey.com>. تمامی حقوق محفوظ است.
.br
این نرم‌افزار آزاد است: برای اطلاعات نسخه‌برداری کد منبع را ببینید.