نام (NAME)

filter-dkimsign - افزودن امضای DKIM به پیام‌ها

خلاصه دستور (SYNOPSIS)

filter-dkimsign [-tz] [-a algorithm] [-c canonicalization] [-h headers] [-x seconds] -d domain -D file -k file -s selector

توضیحات (DESCRIPTION)

برنامه filter-dkimsign یک امضای DKIM به پیام اضافه می‌کند. گزینه‌های زیر پشتیبانی می‌شوند:

-a algorithm

الگوریتم مورد استفاده. الگوریتم‌های امضای پشتیبانی‌شده عبارتند از rsa و ed25519 (در صورت فعال بودن در زمان کامپایل). تنها باید از sha256 برای درهم‌سازی استفاده شود، چرا که سایر الگوریتم‌ها به احتمال زیاد توسط اعتبارسنج‌ها پشتیبانی نمی‌شوند. پیش‌فرض rsa-sha256 است.

-c canonicalization

الگوریتم یکسان‌سازی (canonicalization) مورد استفاده برای امضای پیام. پیش‌فرض simple/simple است.

-D file

این شناسه باید به فایلی حاوی فهرستی از دامنه‌ها اشاره کند. در هر سطر باید تنها یک دامنه مشخص شود. برای اطلاعات بیشتر به -d مراجعه کنید.

-d domain

دامنه‌ای که کلید عمومی در آن یافت می‌شود. این گزینه می‌تواند چندین بار مشخص شود تا بهترین domain در طول امضا انتخاب گردد. اگر چندین بار مشخص شود، بخش دامنه نخستین صندوق پستی در هدر from را بررسی کرده و تلاش می‌کند تطابقی پیدا کند. اگر هیچ تطابق دقیقی یافت نشود، نزدیک‌ترین دامنه والد (domain) را جستجو می‌کند. اگر هیچ تطابقی پیدا نشود، نخستین domain مشخص‌شده استفاده خواهد شد.

-h headers

هدرهای ایمیلی که در امضای ایمیل گنجانده می‌شوند. مطابق RFC، این گزینه دست‌کم نیازمند گنجاندن هدر from است. هدرها با جدا کردن آن‌ها به‌وسیله دونقطه (:) مشخص می‌شوند. مقدار پیش‌فرض عبارت است از from: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.

-k file

این شناسه باید به فایلی حاوی کلید خصوصی RSA برای امضای پیام‌ها اشاره کند.

-s selector

انتخاب‌گر (selector) درون زیردامنه _domainkey از domain که کلید عمومی در آن یافت می‌شود.

-t

افزودن زمان امضا به هدر dkim.

-x seconds

افزودن مدت‌زمانی که امضا معتبر است (به ثانیه) به هدر dkim.

-z

افزودن هدرهای ایمیل استفاده‌شده در امضای dkim به هدر dkim. اگر یک گزینه -z دوم مشخص شود، تمام هدرها در هدر dkim گنجانده خواهند شد. برای اهداف اشکال‌زدایی مفید است.

همچنین ببینید (SEE ALSO)

smtpd(8)

استانداردها (STANDARDS)

D. Crocker, Ed., T. Hansen, Ed., and M. Kucherawy, Ed., DomainKeys Identified Mail (DKIM) Signatures, RFC 6376, Brandenburg InternetWorking, AT&T Laboratories, and Cloudmark, September 2011.

J. Levine, A New Cryptographic Signature Method for DomainKeys Identified Mail, RFC 8463, Taughannock Networks, September 2018.

نویسندگان (AUTHORS)

Martijn van Duren <martijn@openbsd.org>