| SQ(1) | User Commands | SQ(1) |
نام (NAME)
sq-pki-link-authorize - تبدیل یک گواهی به یک معرف مورد اعتماد
خلاصه دستور (SYNOPSIS)
sq pki link authorize [OPTIONS]
توضیحات (DESCRIPTION)
یک گواهی را به معرف مورد اعتماد تبدیل میکند.
این دستور باعث میشود `sq` گواهی مورد نظر را به عنوان یک معرف مورد اعتماد (trusted introducer) در نظر بگیرد. معرف مورد اعتماد نام دیگری برای مرجع صدور گواهی (CA) است. هنگامی که به یک معرف مورد اعتماد پیوند (link) برقرار میکنید، تصدیقهای صادرشده توسط آن معرف را معتبر میدانید. یک معرف مورد اعتماد همچنین میتواند معرفهای مورد اعتماد دیگری را تعیین کند.
به خودی خود، یک معرف مورد اعتماد اختیارات بسیار زیادی دارد. این اختیارات را میتوان از چندین روش محدود کرد.
- توانایی
تعیین
معرفهای
بیشتر را
میتوان با
استفاده از
پارامتر `--depth`
محدود کرد.
- میزان
اعتماد به
یک معرف را
میتوان با
استفاده از
پارامتر `--amount`
تغییر داد.
- شناسههای
کاربری
قابلتصدیق
توسط معرف
را میتوان
بر اساس
دامنه با
استفاده از
پارامتر `--domain`
یا بر اساس
یک عبارت
باقاعده با
استفاده از
پارامتر `--regex`
محدود کرد.
این سازوکارها به شما اجازه میدهند تا برای مثال تعیین کنید که مایلید به CA مربوط به example.org اعتماد کنید، اما فقط برای شناسههای کاربری که نشانی ایمیلی در example.org دارند.
یک پیوند را میتوان با استفاده از `sq pki link retract` باطل کرد.
این دستور شبیه به `sq pki vouch authorize` است، با این تفاوت که تصدیقهای ایجادشده با استفاده از ریشهٔ اعتماد (trust root) دایرکتوری گواهی انجام میشوند، نه یک کلید دلخواه. علاوه بر این، گواهیها به عنوان غیرقابلصادرکردن (non-exportable) علامتگذاری میشوند. مورد اول مدیریت تصدیقها را آسانتر میکند، بهویژه زمانی که کلید تصدیق شما آفلاین است؛ و مورد دوم با کاهش احتمال افشای بخشهایی از نمودار اجتماعی شما در زمان بهاشتراکگذاری گواهی، حریم خصوصیتان را بهبود میبخشد.
بهطور پیشفرض یک پیوند هرگز منقضی نمیشود. با استفاده از آرگومان `--expiration` میتوان دورههای اعتبار مشخصی را تعریف کرد. این آرگومان امکان تعیین یک نقطه زمانی برای پایان اعتبار یا یک مدتزمان اعتبار را فراهم میکند.
دستور `sq pki link authorize` زمان مرجع تعیینشده توسط آرگومان سطحبالای `--time` را رعایت میکند و زمان ایجاد پیوند را برابر با این زمان مرجع قرار میدهد.
گزینهها (OPTIONS)
گزینههای زیردستور (Subcommand options)
- --add-email=EMAIL
- استفاده از یک شناسه کاربری با نشانی ایمیل مشخصشده
- شناسه کاربری تنها شامل نشانی ایمیل خواهد بود. نیازی نیست که نشانی ایمیل در یک شناسه کاربری خودامضاشده ظاهر شده باشد.
- --add-userid=USERID
- استفاده از شناسه کاربری مشخصشده
- شناسه کاربری مشخصشده نیازی ندارد که خودامضاشده باشد.
- از آنجا که استفاده از شناسه کاربریای که خودامضاشده نیست اغلب یک اشتباه است، برای پذیرش آن باید صراحتاً از این گزینه استفاده کنید.
- --all
- استفاده از تمام شناسههای کاربری خودامضاشده
- --allow-non-canonical-userids
- عدم رد شناسههای کاربری جدیدی که در قالب استاندارد نیستند
- شناسههای کاربری استاندارد به شکل `Name (Comment) <localpart@example.org>` هستند.
- --amount=AMOUNT
- تنظیم میزان اعتماد
- مقادیر بین 1 و 120 معنادار هستند. مقدار 120 به معنای اعتماد کامل است. مقادیر کمتر از 120 درجهٔ اعتماد را نشان میدهند. معمولاً مقدار 60 برای اعتماد نسبی استفاده میشود.
- [پیشفرض: full]
- --cert=FINGERPRINT|KEYID
- استفاده از گواهیهای دارای اثرانگشت یا شناسه کلید مشخصشده
- --cert-special=SPECIAL
- استفاده از گواهیهای شناساییشده با نام ویژه
- [مقادیر ممکن: public-directories, keys.openpgp.org, keys.mailvelope.com, proton.me, wkd, dane, autocrypt, web]
- --depth=TRUST_DEPTH
- تنظیم عمق اعتماد
- این مورد گاهی به عنوان سطح اعتماد (trust level) شناخته میشود. مقدار 1 یعنی CERTIFICATE یک معرف مورد اعتماد است (پیشفرض)، مقدار 2 یعنی CERTIFICATE یک معرف فرامورد اعتماد است و میتواند معرف مورد اعتماد دیگری را مجاز کند، و غیره.
- [پیشفرض: 255]
- --domain=DOMAIN
- افزودن محدودیت دامنه به معرف
- افزودن یک دامنه برای محدود کردن تصدیقهای مورد پذیرش. تصدیقی که توسط گواهی صادر شده تنها در صورتی پذیرفته میشود که روی یک شناسه کاربری با نشانی ایمیلی در دامنه مشخصشده باشد. میتوان چندین دامنه تعیین کرد. در این حالت، حداقل یکی باید مطابقت داشته باشد.
- --email=EMAIL
- استفاده از یک شناسه کاربری که فقط شامل نشانی ایمیل است، در صورتی که نشانی ایمیل در یک شناسه کاربری خودامضاشده آمده باشد
- --expiration=EXPIRATION
- تنظیم زمان انقضا
- مقدار EXPIRATION یا یک تاریخ در قالب ISO 8601 به همراه زمان اختیاری است یا یک مدتزمان سفارشی. مدتزمان به شکل `N[ymwds]` است که در آن حروف به ترتیب بیانگر سال، ماه، هفته، روز و ثانیه هستند. همچنین، کلمه کلیدی `never` هیچ زمان انقضایی تنظیم نمیکند.
- [پیشفرض: never]
- --recreate
- تولید مجدد امضا حتی در صورت عدم تغییر پارامترها
- اگر پارامترهای پیوند تغییری نکرده باشند و در نتیجه نیازی به ایجاد امضا نباشد، از این عملیات صرفنظر میشود. این پرچم میتواند برای اجبار به بازتولید امضا در هر صورت به کار رود.
- --regex=REGEX
- افزودن عبارت باقاعده برای محدود کردن معرف
- افزودن یک عبارت باقاعده برای محدود کردن تصدیقهای مورد پذیرش. تصدیق صادرشده توسط گواهی تنها در صورتی پذیرفته میشود که روی شناسه کاربریای باشد که با یکی از عبارتهای باقاعده مشخصشده مطابقت دارد. میتوان چندین عبارت باقاعده تعیین کرد. در این حالت، حداقل یکی باید مطابقت داشته باشد.
- --signature-notation NAME VALUE
- افزودن یک نشانهگذاری به امضا
- نام یک نشانهگذاری تعریفشده توسط کاربر باید به شکل `name@a.domain.you.control.org` باشد. اگر نام نشانهگذاری با `!` آغاز شود، به عنوان بحرانی (critical) علامتگذاری میشود. اگر پردازشکنندهٔ امضا یک نشانهگذاری بحرانی را متوجه نشود، از امضا صرفنظر خواهد کرد. این نشانهگذاری به صورت خوانا برای انسان علامتگذاری میشود.
- --unconstrained
- عدم محدودسازی معرف
- بهطور معمول یک معرف به گونهای محدود میشود که تنها شناسههای کاربری خاصی مورد پذیرش قرار گیرند، برای مثال، شناسههایی که نشانی ایمیلی برای یک نام دامنه خاص دارند. این گزینه بدون اعمال چنین محدودیتهایی به معرف اجازه فعالیت میدهد. از آنجا که این کار اختیارات زیادی به معرف میدهد، باید صراحتاً این رفتار را فعال کنید.
- --userid=USERID
- استفاده از شناسه کاربری خودامضاشده مشخص
- شناسه کاربری مشخصشده باید خودامضاشده باشد.
- --userid-by-email=EMAIL
- استفاده از شناسه کاربری خودامضاشده با نشانی ایمیل مشخصشده
گزینههای عمومی (Global options)
برای شرح گزینههای عمومی، sq(1) را ببینید.
مثالها (EXAMPLES)
افزودن یک معرف مورد اعتماد نامحدود.
sq pki link authorize --unconstrained \
--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --all
افزودن یک معرف مورد اعتماد برای example.org و example.com.
sq pki link authorize --domain=example.org \
--domain=example.com \
--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --all
افزودن یک معرف با اعتماد نسبی.
sq pki link authorize --unconstrained --amount=60 \
--cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --all
همچنین ببینید (SEE ALSO)
sq(1), sq-pki(1), sq-pki-link(1).
برای مستندات کامل به https://book.sequoia-pgp.org مراجعه کنید.
نسخه (VERSION)
1.4.0
| 1.4.0 | Sequoia PGP |