نام (NAME)

opendkim-genkey - ابزار تولید کلید فیلتر DKIM

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

opendkim-genkey [گزینه‌ها]

توضیحات (DESCRIPTION)

opendkim-genkey (۱) یک کلید خصوصی برای امضای پیام‌ها با استفاده از opendkim(8) و (۲) یک رکورد TXT در DNS مناسب برای قرار دادن در یک فایل زون تولید می‌کند که کلید عمومی منطبق را جهت استفاده توسط اعتبارسنج‌های راه دور DKIM منتشر می‌سازد.

نام فایل‌های این کلیدها بر اساس سلکتور (به بخش زیر مراجعه کنید) تعیین می‌شود؛ کلید خصوصی دارای پسوند ".private" و رکورد TXT دارای پسوند ".txt" خواهد بود.

برای بیشتر گزینه‌ها هر دو نام کوتاه و طولانی پشتیبانی می‌شوند.

گزینه‌ها (OPTIONS)

-a

(--append-domain) نام دامنه (به گزینه -d در زیر مراجعه کنید) را به برچسب موجود در رکورد TXT تولیدشده به همراه یک نقطه پایانی اضافه می‌کند. به‌طور پیش‌فرض فرض می‌شود که نام دامنه از بافت فایل زون استنباط می‌شود و بنابراین در خروجی گنجانده نمی‌شود.

-b bits

(--bits=n) اندازه کلید تولیدی را بر حسب بیت مشخص می‌کند. مقدار پیش‌فرض ۱۰۲۴ است که مقدار توصیه‌شده توسط مشخصات DKIM می‌باشد.

-d domain

(--domain=string) دامنه‌ای را که از این کلید برای امضا استفاده خواهد کرد نام‌گذاری می‌کند. در حال حاضر فقط در یک کامنت در فایل رکورد TXT استفاده می‌شود. مقدار پیش‌فرض "example.com" است.

-D directory

(--directory=path) به ابزار دستور می‌دهد تا پیش از ایجاد فایل‌ها به دایرکتوری مشخص‌شده تغییر مسیر دهد. به‌طور پیش‌فرض دایرکتوری فعلی استفاده می‌شود.

--ed25519

تولید یک کلید ed25519.

-h algorithms

(--hash-algorithms=name[:name[...]]) فهرستی از الگوریتم‌های هش را که می‌توان با این کلید استفاده کرد مشخص می‌کند. به‌طور پیش‌فرض همه الگوریتم‌های هش مجاز هستند.

--help

چاپ پیام راهنما و خروج.

-n note

(--note=string) متن یادداشت دلخواهی را در رکورد کلید می‌گنجاند. به‌طور پیش‌فرض هیچ متنی گنجانده نمی‌شود.

-r

(--restrict) استفاده از کلید را فقط برای امضای ایمیل محدود می‌کند. رفتار پیش‌فرض این است که به کلید اجازه داده می‌شود برای هر سرویسی استفاده شود.

-s selector

(--selector=name) سلکتور یا نام جفت‌کلید تولیدشده را مشخص می‌کند. مقدار پیش‌فرض "default" است.

-S

(--[no]subdomains) امضای زیردامنه‌ها توسط این کلید را غیرمجاز می‌کند. به‌طور پیش‌فرض رکورد کلید به گونه‌ای تولید می‌شود که به اعتبارسنج‌ها اعلام می‌کند امضای زیردامنه‌ها مجاز است. توجه داشته باشید که به دلایل سازگاری با گذشته، -S همان معنای --nosubdomains را دارد.

-t

(--[no]testmode) مشخص می‌کند که رکورد کلید تولیدشده باید برچسب‌گذاری شود تا اعتبارسنج‌ها بدانند DKIM در دامنه امضاکننده در حالت آزمایشی است.

-v

(--verbose) افزایش خروجی با جزئیات (verbose).

-V

(--version) چاپ شماره نسخه و خروج.

نکات (NOTES)

نیازمند این است که باینری openssl(8) نصب شده و در مسیر جستجوی شل در حال اجرا موجود باشد.

نسخه (VERSION)

این صفحه راهنما نسخه‌ای از opendkim-genkey را پوشش می‌دهد که همراه با نسخه 2.11.0 از OpenDKIM عرضه شده است.

حق نشر (COPYRIGHT)

حق نشر (c) 2007, 2008 متعلق به Sendmail, Inc. و تأمین‌کنندگان آن است. کلیه حقوق محفوظ است.

حق نشر (c) 2009, 2011-2013 متعلق به The Trusted Domain Project است. کلیه حقوق محفوظ است.

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

opendkim(8), openssl(8)

RFC6376 - DomainKeys Identified Mail