نام (NAME)

sq-key-userid - مدیریت شناسه‌های کاربری

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

sq key userid add [OPTIONS]
sq key userid revoke [OPTIONS]

توضیحات (DESCRIPTION)

مدیریت شناسه‌های کاربری (User IDs).

افزودن شناسه‌های کاربری به یک کلید، یا ابطال آن‌ها.

زیردستورها (SUBCOMMANDS)

sq key userid add

افزودن یک شناسهٔ کاربری.

یک شناسهٔ کاربری می‌تواند حاوی یک نام، مانند `Juliet`، یا یک نشانی رایانامه، مانند `<juliet@example.org>` باشد. از نظر تاریخی، نام و نشانی رایانامه معمولاً در یک شناسهٔ کاربری واحد ترکیب می‌شدند، مانند `Juliet <juliet@example.org>`. با این حال، تحلیل شناسه‌های کاربری که شامل اطلاعات متفاوتی مانند نام و نشانی رایانامه هستند دشوارتر است؛ بنابراین امروزه استفاده از شناسه‌های کاربری مجزا برای نام و نشانی رایانامه ترجیح داده می‌شود.

دستور `sq key userid add` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` تبعیت می‌کند. این دستور زمان ایجاد امضای پیونددهندهٔ (binding signature) شناسهٔ کاربری را روی زمان مشخص‌شده تنظیم می‌کند.

sq key userid revoke

ابطال یک شناسهٔ کاربری.

یک گواهی ابطال برای شناسهٔ کاربری ایجاد می‌کند.

اگر `--revoker` یا `--revoker-file` مشخص شده باشد، از آن کلید برای ایجاد گواهی ابطال استفاده می‌شود. اگر آن کلید با گواهی‌ای که در حال ابطال است متفاوت باشد، این عمل به ابطال شخص ثالث (third-party revocation) منجر خواهد شد. این حالت معمولاً تنها در صورتی مفید است که مالک گواهی، کلید مزبور را به عنوان باطل‌کنندهٔ تعیین‌شده (designated revoker) مشخص کرده باشد.

برای ابطال یک شناسهٔ کاربری، گواهی باید تحت شیوه‌نامهٔ (policy) فعلی معتبر باشد. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر نیست، ابطال کل گواهی یا تصحیح آن را با استفاده از `sq cert lint` پس از تأیید یکپارچگی گواهی مد نظر قرار دهید. اگر گواهی تحت شیوه‌نامهٔ فعلی معتبر باشد، اما شناسهٔ کاربری‌ای که می‌خواهید ابطال کنید معتبر نباشد، همچنان می‌توانید با استفاده از `--add-userid` آن شناسهٔ کاربری را ابطال کنید.

دستور `sq key userid revoke` از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `--time` تبعیت می‌کند. در صورت تنظیم شدن، هنگام تعیین کلیدهای معتبر، به جای زمان فعلی از زمان مشخص‌شده استفاده می‌کند و زمان ایجاد گواهی ابطال را نیز به جای زمان فعلی روی زمان مرجع تنظیم می‌نماید.

مثال‌ها (EXAMPLES)

sq key userid add

# افزودن یک شناسهٔ کاربری جدید به کلید Alice.

sq key userid add --cert \

EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --name Alice \

--email alice@work.example.com

sq key userid revoke

از رده خارج کردن یک شناسهٔ کاربری در کلید Alice.

sq key userid revoke --cert \

EB28F26E2739A4870ECC47726F0073F60FD0CBF0 --userid \

"Alice <alice@example.org>" --reason retired --message \

"No longer at example.org."

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

sq(1), sq-key(1), sq-key-userid-add(1), sq-key-userid-revoke(1).

برای مستندات کامل، https://book.sequoia-pgp.org را ببینید.

نسخه (VERSION)

1.4.0