openemail.encryption
이 네임스페이스의 모든 메서드: 시그니처, 매개변수, 반환값과 예시.
메서드
The OpenPGP public keys that let senders seal mail to your addresses: list the ones you published, publish or rotate one, and look up the keys of recipients before sealing a message.
encryption.list_keys()
List your published encryption keys
def list_keys( *, api_key: str | None = None, timeout: float | None = None,) -> builtins.list[EncryptionKeyResource]Returns every OpenPGP public key published for an address in this workspace as one list, newest first, as the Encryption page of the app shows them. Retired keys are included, with revokedAt and revokedReason set, and the live key of each address has revokedAt set to None.
Published keys belong to a person. An API key reads and publishes the keys of the workspace owner, and an access token those of the person who connected the app. An API key limited to particular addresses lists only the keys of those addresses.
매개변수
api_keystrOverrides the client's API key for this call only.
timeoutfloatSeconds this call may take, the response included, before it raises
OpenEmailNetworkErrorwithis_timeout. It overrides the client'stimeoutfor this call, and0turns the limit off.
반환값
list[EncryptionKeyResource], each with id, address, fingerprint, publicKey, algorithm, createdAt, revokedAt and revokedReason.
예시
from openemail import openemail keys = openemail.encryption.list_keys() for key in keys: state = 'live' if key['revokedAt'] is None else 'retired' print(key['address'], key['fingerprint'], state)참고
Only public keys travel through the API. The private key stays on the device that made it.
다른 사용처
encryption.publish_key()
Publish a public key for one of your addresses
def publish_key( body: EncryptionKeyPublish, *, api_key: str | None = None, timeout: float | None = None,) -> EncryptionKeyResourcePublishes 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. The address has to be an address of this workspace on a verified domain, switched on, and one you may use.
An address keeps one live key. To rotate, pass the fingerprint of the live key as replaces: it is retired as the new key is published. Mail already sealed to the old key stays readable only with the old private key.
Published keys belong to a person. An API key reads and publishes the keys of the workspace owner, and an access token those of the person who connected the app.
매개변수
body['address']str필수The address the key is for.
body['publicKey']str필수The armored OpenPGP PUBLIC KEY BLOCK, up to 64 KB.
body['fingerprint']str필수The fingerprint of the key, 40 upper-case hexadecimal characters.
body['algorithm']strThe algorithm of the key, such as
ed25519, for display only.body['replaces']strThe fingerprint of the live key this one replaces, to rotate it.
api_keystrOverrides the client's API key for this call only.
timeoutfloatSeconds this call may take, the response included, before it raises
OpenEmailNetworkErrorwithis_timeout. It overrides the client'stimeoutfor this call, and0turns the limit off.
반환값
EncryptionKeyResource for the key, now live.
예시
from openemail import openemail armored = ( '-----BEGIN PGP PUBLIC KEY BLOCK-----\n\n' 'mDMEZxN4mBYJKwYBBAHaRw8BAQdAv2y8nV5k1o8Wq3dJ0rJmZzJ9T0p6l4x2c1bC\n' '-----END PGP PUBLIC KEY BLOCK-----\n') key = openemail.encryption.publish_key( { 'address': '[email protected]', 'publicKey': armored, 'fingerprint': '3F2A9C1B7E4D5F60A1B2C3D4E5F60718293A4B5C', }) print(key['id'], key['address'], key['createdAt'])참고
With an OAuth access token it asks for a verification code: until the app has verified one, it is refused with 403
step_up_required, andis_step_up_requiredon the error says so. An API key is never asked.A second key while one is live, without
replaces, is 409key_already_published, and so is a key that was published for the address before. An address on a domain that is not verified yet is 409domain_not_verified, and an address you may not use is 403address_not_allowed.The SDK does not retry it.
다른 사용처
encryption.lookup_keys()
Find the keys to seal mail to
def lookup_keys( *, addresses: Sequence[str], api_key: str | None = None, timeout: float | None = None,) -> builtins.list[EncryptionKeyLookupResource]Returns the live public keys published for each recipient address, the lookup the composer makes before it seals a message. An address with no key comes back with keys empty, so mail to it cannot be sealed. Only keys published by somebody who can read the address count.
매개변수
addressesSequence[str]필수Recipient addresses, at most 51, sent comma-separated.
api_keystrOverrides the client's API key for this call only.
timeoutfloatSeconds this call may take, the response included, before it raises
OpenEmailNetworkErrorwithis_timeout. It overrides the client'stimeoutfor this call, and0turns the limit off.
반환값
list[EncryptionKeyLookupResource], one per address, each with address and keys, every key with fingerprint, publicKey and createdAt.
예시
from openemail import openemail found = openemail.encryption.lookup_keys(addresses=['[email protected]', '[email protected]']) for entry in found: print(entry['address'], [key['fingerprint'] for key in entry['keys']]) if not all(entry['keys'] for entry in found): print('Some recipients have no key, so the message cannot be sealed')참고
A display name in angle brackets is read as its address.