module documentation
Handling of RSA, DSA, ECDSA, and Ed25519 keys.
| Class | |
Constants representing the supported formats of key fingerprints. |
| Class | |
An object representing a key. A key can be either a public or private key. A public key can verify a signature; a private key can create or verify a signature. To generate a string that can be stored on disk, use the toString method... |
| Exception | |
Raises when unsupported fingerprint formats are presented to fingerprint. |
| Exception | |
Raised when a key isn't what we expected from it. |
| Exception | |
Raised when a public key signature algorithm name isn't defined for this public key format. |
| Exception | |
Raised when an encrypted key is presented to fromString/fromFile without a password. |
| Exception | |
Raised when a passphrase contains Unicode characters that cannot be normalized using the available Unicode character database. |
| Function | _get |
This function returns a persistent Key. |
| Function | _normalize |
Normalize a passphrase, which may be Unicode. |
| Variable | _curve |
Undocumented |
| Variable | _sec |
Undocumented |
This function returns a persistent Key.
The key is loaded from a PEM file in location. If it does not exist, a key with the key size of keySize is generated and saved.
| Parameters | |
location:twisted.python.filepath.FilePath | Where the key is stored. |
keyint | The size of the key, if it needs to be generated. |
| Returns | |
Key | A persistent key. |
Normalize a passphrase, which may be Unicode.
If the passphrase is Unicode, this follows the requirements of NIST 800-63B, section 5.1.1.2 for Unicode characters in memorized secrets: it applies the Normalization Process for Stabilized Strings using NFKC normalization. The passphrase is then encoded using UTF-8.
| Parameters | |
passphrase:bytes or unicode or None | The passphrase to normalize. |
| Returns | |
bytes or None | The normalized passphrase, if any. |
| Raises | |
PassphraseNormalizationError | if the passphrase is Unicode and cannot be normalized using the available Unicode character database. |