.\" Automatically generated from an mdoc input file.  Do not edit.
.\"	$OpenBSD$
.\"
.\" Copyright (c) 2019 Martijn van Duren <martijn@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.TH "FILTER-DKIMSIGN" "8" "June 24, 2025" "Linux 6.15.2-arch1-1" "System Manager's Manual"
.nh
.if n .ad l
.SH "نام (NAME)"
filter-dkimsign \- افزودن امضای DKIM به پیام‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP 16n
\fBfilter-dkimsign\fR
[\fB\-tz\fR]
[\fB\-a\fR\ \fIalgorithm\fR]
[\fB\-c\fR\ \fIcanonicalization\fR]
[\fB\-h\fR\ \fIheaders\fR]
[\fB\-x\fR\ \fIseconds\fR]
\fB\-d\fR\ \fIdomain\fR
\fB\-D\fR\ \fIfile\fR
\fB\-k\fR\ \fIfile\fR
\fB\-s\fR\ \fIselector\fR
.SH "توضیحات (DESCRIPTION)"
برنامه
\fBfilter-dkimsign\fR
یک امضای DKIM به پیام اضافه می‌کند.
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 8n
\fB\-a\fR \fIalgorithm\fR
الگوریتم مورد استفاده.
الگوریتم‌های امضای پشتیبانی‌شده عبارتند از
\fIrsa\fR
و
\fIed25519\fR
(در صورت فعال بودن در زمان کامپایل).
تنها باید از sha256 برای درهم‌سازی استفاده شود، چرا که سایر الگوریتم‌ها به احتمال زیاد توسط اعتبارسنج‌ها پشتیبانی نمی‌شوند.
پیش‌فرض
\fBrsa\-sha256\fR
است.
.TP 8n
\fB\-c\fR \fIcanonicalization\fR
الگوریتم یکسان‌سازی (canonicalization) مورد استفاده برای امضای پیام.
پیش‌فرض
\fIsimple/simple\fR
است.
.TP 8n
\fB\-D\fR \fIfile\fR
این شناسه باید به فایلی حاوی فهرستی از دامنه‌ها اشاره کند.
در هر سطر باید تنها یک دامنه مشخص شود.
برای اطلاعات بیشتر به
\fB\-d\fR
مراجعه کنید.
.TP 8n
\fB\-d\fR \fIdomain\fR
دامنه‌ای که کلید عمومی در آن یافت می‌شود.
این گزینه می‌تواند چندین بار مشخص شود تا بهترین
\fIdomain\fR
در طول امضا انتخاب گردد.
اگر چندین بار مشخص شود، بخش دامنه نخستین صندوق پستی در هدر from را بررسی کرده و تلاش می‌کند تطابقی پیدا کند.
اگر هیچ تطابق دقیقی یافت نشود، نزدیک‌ترین دامنه والد
(\fIdomain\fR)
را جستجو می‌کند.
اگر هیچ تطابقی پیدا نشود، نخستین
\fIdomain\fR
مشخص‌شده استفاده خواهد شد.
.TP 8n
\fB\-h\fR \fIheaders\fR
هدرهای ایمیلی که در امضای ایمیل گنجانده می‌شوند.
مطابق RFC، این گزینه دست‌کم نیازمند گنجاندن هدر from است.
هدرها با جدا کردن آن‌ها به‌وسیله دونقطه (:) مشخص می‌شوند.
مقدار پیش‌فرض عبارت است از
\fIfrom:reply\-to:subject:date:to:cc:resent\-date:resent\-from:resent\-to:resent\-cc:in\-reply\-to:references:list\-id:list\-help:list\-unsubscribe:list\-subscribe:list\-post:list\-owner:list\-archive\fR.
.TP 8n
\fB\-k\fR \fIfile\fR
این شناسه باید به فایلی حاوی کلید خصوصی RSA برای امضای پیام‌ها اشاره کند.
.TP 8n
\fB\-s\fR \fIselector\fR
انتخاب‌گر (selector) درون زیردامنه _domainkey از
\fIdomain\fR
که کلید عمومی در آن یافت می‌شود.
.TP 8n
\fB\-t\fR
افزودن زمان امضا به هدر dkim.
.TP 8n
\fB\-x\fR \fIseconds\fR
افزودن مدت‌زمانی که امضا معتبر است (به ثانیه) به هدر dkim.
.TP 8n
\fB\-z\fR
افزودن هدرهای ایمیل استفاده‌شده در امضای dkim به هدر dkim.
اگر یک گزینه
\fB\-z\fR
دوم مشخص شود، تمام هدرها در هدر dkim گنجانده خواهند شد.
برای اهداف اشکال‌زدایی مفید است.
.SH "همچنین ببینید (SEE ALSO)"
smtpd(8)
.SH "استانداردها (STANDARDS)"
D. Crocker, Ed.,
T. Hansen, Ed., and
M. Kucherawy, Ed.,
\fIDomainKeys Identified Mail (DKIM) Signatures\fR,
RFC 6376,
Brandenburg InternetWorking,
AT&T Laboratories, and
Cloudmark,
September 2011.
.PP
J. Levine,
\fIA New Cryptographic Signature Method for DomainKeys Identified Mail\fR,
RFC 8463,
Taughannock Networks,
September 2018.
.SH "نویسندگان (AUTHORS)"
Martijn van Duren <\fImartijn@openbsd.org\fR>