رمزگذاری
کلیدهای عمومی‌ای که فرستندگان با آن‌ها ایمیلِ شما را مهروموم می‌کنند.
ابزارهای رمزگذاری
| ابزار | چه می‌کند |
|---|---|
| listEncryptionKeys | کلیدهای عمومی OpenPGP منتشرشده برای نشانی‌های شما، فعال و کنارگذاشته، تازه‌ترین‌ها اول، با اثر انگشتشان. |
| publishEncryptionKey | انتشار کلید عمومی در قالب armor برای یکی از نشانی‌های شما، یا چرخاندن کلید فعال با replaces. کد تأیید می‌خواهد. |
| lookupEncryptionKeys | کلیدهای عمومی فعال هر نشانی گیرنده، همان جست‌وجویی که ویرایشگر پیش از مهروموم کردن پیام انجام می‌دهد. |
کلیدهای منتشرشده مال کسی‌اند که کلاینت را وصل کرده. خواندن و انتشار به emails:read نیاز دارند و جست‌وجوی گیرندگان به emails:send. کلاینتی که به برخی نشانی‌ها محدود است فقط برای همان‌ها فهرست و منتشر می‌کند.
از این ابزارها فقط کلیدهای عمومی می‌گذرند. کلید خصوصی روی دستگاهی که آن را ساخته می‌ماند، پس هیچ چیز این‌جا نمی‌تواند ایمیل مهروموم‌شده را بخواند. در گفت‌وگوی اپ، انتشار اول می‌پرسد مگر اینکه خودتان خواسته باشید.
برخی ابزارهای این سرور تغییری انجام می‌دهند که REST API آن را با کد تأیید هویت محافظت می‌کند، و همان کد را می‌خواهند. تا وقتی کلاینت در 60 دقیقهٔ گذشته کدی را تأیید نکرده باشد و شخص هم در حساب ← برنامه‌های متصل برای آن «اجازهٔ تغییرات برای 60 دقیقه» را انتخاب نکرده باشد، چنین ابزاری با نتیجه‌ای پاسخ می‌دهد که با Refused (step_up_required): شروع می‌شود و چیزی را تغییر نمی‌دهد. emptyAudience هرگز کد نمی‌خواهد. صفحهٔ احراز هویت API همهٔ ابزارهایی را که کد می‌خواهند فهرست می‌کند و نشان می‌دهد چگونه کد بخواهید و آن را تأیید کنید.
مرجع
listEncryptionKeys
The OpenPGP public keys published for your addresses in this workspace, the Encryption page of the app: live ones and retired ones, newest first, with their fingerprints. Published keys belong to the person who connected the client.
ورودی‌ها
هیچ ورودی‌ای نمی‌گیرد.
همچنین در دسترس در
publishEncryptionKey
Publish an armored OpenPGP public key for one of your addresses, so that senders can seal mail to it, as Publish on the Encryption page does. An address keeps one live key: to rotate, pass the fingerprint of the live key as replaces. Never invent a key; only publish one the person gave you.
- کد تأیید می‌خواهد
POST /encryption/keys
ورودی‌ها
addressstringالزامی- تا 320 نویسه
publicKeystringالزامی- 64 تا 65536 نویسهالگو
^-----BEGIN PGP PUBLIC KEY BLOCK-----[\s\S]+-----END PGP PUBLIC KEY BLOCK-----\s*$ fingerprintstringالزامی- الگو
^[0-9A-F]{40}$ algorithmstring- تا 32 نویسه
replacesstring- الگو
^[0-9A-F]{40}$
همچنین در دسترس در
lookupEncryptionKeys
The live public keys published for each recipient address, the lookup the composer makes before it seals a message. An address with no key cannot be sent sealed mail.
ورودی‌ها
addressesstring[]الزامی- 1 تا 51 مورد