نام (NAME)

Profanity - یک کلاینت سادهٔ چت XMPP مبتنی بر کنسول

توضیحات (DESCRIPTION)

این صفحهٔ راهنما با هدف کمک به شما در راه‌اندازی XEP-0374: OpenPGP for XMPP Instant Messaging تهیه شده است. که همچنین به نام OX شناخته می‌شود.

برای جزئیات بیشتر دربارهٔ نحوهٔ استفاده، به راهنمای profanity-ox یا /help ox مراجعه کنید.

نرم‌افزار Profanity مایل است حداکثر آزادی عمل را در پیکربندی سامانه به کاربر بدهد. بنابراین ما مستقیماً به تنظیمات GPG شما دست نخواهیم زد. این بدان معناست که نیاز است برخی مراحل را به‌صورت دستی انجام دهید. این مراحل در اینجا شرح داده شده‌اند.

تولید کلیدهای OpenPGP (GENERATE OPENPGP KEY MATERIALS)

نخستین گام، ایجاد یک جفت‌کلید OpenPGP است. تولید جفت‌کلید با استفاده از دستور gpg در GnuPG انجام خواهد شد.

gpg --quick-generate-key xmpp:alice@domain.tld future-default default 3y

این دستور یک کلید OpenPGP با UID به صورت xmpp:alice@domain.tld تولید می‌کند. گزینهٔ future-default برای تولید یک کلید ed25519/cv25519 استفاده شده است. این کلید به‌گونه‌ای تنظیم شده که پس از سه سال منقضی شود.

شناسهٔ Jabber ID را با JID خود جایگزین کنید و پیشوند URI یعنی xmpp: را فراموش نکنید.

خروجی نمونه:

pub   ed25519 2021-09-21 [SC] [verfällt: 2024-09-20]
      583BAE703A801095B6B71A56BD801174B1A0B84A
uid                      xmpp:alice@domain.tld
sub   cv25519 2021-09-21 [E]

برون‌ریزی کلید عمومی (EXPORT YOUR PUBLIC KEY)

شما باید کلید عمومی خود را برون‌ریزی کنید تا بتوانید بعداً آن را در یک گره PEP بارگذاری نمایید. این روشی است که طرف‌های گفتگوی شما می‌توانند کلید عمومی را از شما دریافت کنند. برای برون‌ریزی کلید عمومی از دستور زیر استفاده کنید:

دستور نمونه:

gpg --export \
  --export-options export-minimal \
  --export-filter 'keep-uid=uid =~ xmpp:alice@domain.tld' \
  --export-filter 'drop-subkey=usage =~ a' \
  583BAE703A801095B6B71A56BD801174B1A0B84A \
  > /tmp/pep-key.gpg

کلید در مسیر /tmp/pep-key.gpg برون‌ریزی خواهد شد. می‌توانید کلید را با دستور زیر بررسی کنید:

gpg --show-key --with-sig-list /tmp/pep-key.gpg

به یاد داشته باشید: کلیدهای عمومی ممکن است حاوی اطلاعاتی (امضاها، نام، نشانی ایمیل) باشند. مراقب باشید که چه داده‌هایی برون‌ریزی می‌شوند. گزینه‌های export-options و export-filter در GnuPG به شما در پالایش و فیلتر کردن داده‌ها کمک خواهند کرد.

انتشار کلید (PUBLISH YOUR KEY)

می‌توانید از profanity برای انتشار کلید برون‌ریزی‌شده در حساب کاربری خود (PEP) استفاده کنید. دستور /ox announce کلید شما را منتشر خواهد کرد.

/ox announce /tmp/pep-key.gpg

این دستور دو رکورد گره PEP برای ذخیرهٔ کلید ایجاد خواهد کرد.

کشف کلیدها (DISCOVER KEYS)

برای کشف کلیدهای عمومی مخاطبان خود از دستور /ox discover استفاده کنید.

خروجی نمونه:

/ox discover buddy@domain.tld
Discovering Public Key for buddy@domain.tld 
1234567890ABCDEF1234567890ABCDEF12345678

برای درخواست و وارد کردن یک کلید، می‌توانید از دستور /ox request استفاده نمایید.

/ox request buddy@domain.tld 1234567890ABCDEF1234567890ABCDEF12345678
Requesting Public Key 1234567890ABCDEF1234567890ABCDEF12345678 for buddy@domain.tld
Public Key imported 

کلید به جاکلیدی (keyring) برنامهٔ gnupg شما وارد خواهد شد.

امضای کلید واردشده (SIGN THE IMPORTED KEY)

کلید را می‌توان از طریق gpg مشاهده کرد: gpg -k xmpp:buddy@domain.tld. مطمئن شوید کلید متعلق به مخاطب شما است و آن را با کلید خود امضا کنید.

gpg --ask-cert-level --default-key 583BAE703A801095B6B71A56BD801174B1A0B84A --sign-key 1234567890ABCDEF1234567890ABCDEF12345678

دستور /ox contacts کلیدهای دارای XMPP-UID را نمایش خواهد داد. دستور /ox keys همهٔ کلیدهای OpenPGP شناخته‌شده را نشان خواهد داد.

تنها پس از اینکه کلید را امضا کردید، می‌توانید عملاً از OX با مخاطب خود استفاده کنید.

استفاده از OX (USE OX)

درون پنجرهٔ چت می‌توانید OX را با دستور /ox start آغاز و با /ox end متوقف کنید.

پیام‌ها به‌صورت امضاشده و رمزگذاری‌شده ارسال خواهند شد.