U
vf @ sP d Z ddlZddlmZmZ ddlmZ ddlZddlmZ ddl m
Z
m Z ddl Z ddl
Z
ddlZddlmZ ddlmZ dd lmZmZmZ dd
lmZ dd lmZ dd lmZm Z dd
l m Z ddl m Z m!Z! ddl"m#Z# zddl$m%Z% W n" e&k
r ddl'm%Z% Y nX dZ(dd Z)G dd de*Z+G dd dZ,G dd dZ-dS )z!
Common API for all public keys.
N) encodebytes decodebytes) unhexlify)Path)md5sha256)default_backend)
serialization)
algorithmsmodesCipher)
asymmetric)util)ub)o600) SSHExceptionPasswordRequiredException)Message) TripleDESs openssh-key-v1 c C sl | d }d| kr dk r$n n| S |dkr4t dt|D ] }| || |d kr/opt/alt/python38/lib/python3.8/site-packages/paramiko/pkey.py_unpad_openssh? s
r c @ s" e Zd ZdZdddZdd ZdS )UnknownKeyTypezK
An unknown public/private key algorithm was attempted to be read.
Nc C s || _ || _d S Nkey_type key_bytes)selfr$ r% r r r __init__S s zUnknownKeyType.__init__c C s d| j dt| j dS )NzUnknownKeyType(type=z , bytes=))r$ lenr% r& r r r __str__W s zUnknownKeyType.__str__)NN)__name__
__module__ __qualname____doc__r' r* r r r r r! N s
r! c @ s e Zd ZdZejddejdejddejdeddejddZ dZ
d Z e
d
Ze
d ZedOd
dZedd Zedd ZdPddZdd Zdd Zdd Zdd Zd d Zed d Z d!d" Z ed#d$ Z d%d& Z d'd( Z d)d* Z!ed+d, Z"d-d. Z#dQd/d0Z$d1d2 Z%edRd3d4Z&edSd5d6Z'dTd7d8Z(dUd9d:Z)dVd;d<Z*dWd=d>Z+d?d@ Z,dAdB Z-dCdD Z.dEdF Z/dXdGdHZ0dYdIdJZ1dKdL Z2dMdN Z3d S )ZPKeyz
Base class for public keys.
Also includes some "meta" level convenience constructors such as
`.from_type_string`.
)cipherkeysize blocksizemoder )z AES-128-CBCz AES-256-CBCz DES-EDE3-CBCr z3^-{5}BEGIN (RSA|DSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$z1^-{5}END (RSA|DSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$Nc C sN ddl m}m}m}m} t| } d}t| |rJ| dt| }| }n | }| | }t| }t| }|
} zt j | |d}
W n" t
k
r t j| |d}
Y nX d} t|
tjjr|} nLt|
tjjr|} n8t|
tjjr|} n$t|
tjjr|} nt| |
jd| } | j | |d}
W 5 Q R X | rJ|
t| |
S )aV
Attempt to instantiate appropriate key subclass from given file path.
:param Path path: The path to load (may also be a `str`).
:returns:
A `PKey` subclass instance.
:raises:
`UnknownKeyType`, if our crypto backend doesn't know this key type.
.. versionadded:: 3.2
r )DSSKeyRSAKey
Ed25519KeyECDSAKeyz -cert.pubN)r password)r% r$ r< ) paramikor8 r9 r: r; strendswithr( r
expanduser
read_bytesr Zload_ssh_private_key
ValueErrorZload_pem_private_key
isinstancer
ZdsaZ
DSAPrivateKeyrsaZ
RSAPrivateKeyZed25519ZEd25519PrivateKeyecZEllipticCurvePrivateKeyr! __class__openfrom_private_keyexistsload_certificate)pathZ
passphraser8 r9 r: r; Z cert_suffixZkey_pathZ cert_pathr Zloaded key_classfdkeyr r r from_path sH
zPKey.from_pathc C s@ ddl m} |D ] }| | kr||d S qt| |ddS )av
Given type `str` & raw `bytes`, return a `PKey` subclass instance.
For example, ``PKey.from_type_string("ssh-ed25519", )``
will (if successful) return a new `.Ed25519Key`.
:param str key_type:
The key type, eg ``"ssh-ed25519"``.
:param bytes key_bytes:
The raw byte data forming the key material, as expected by
subclasses' ``data`` parameter.
:returns:
A `PKey` subclass instance.
:raises:
`UnknownKeyType`, if no registered classes knew about this type.
.. versionadded:: 3.2
r ) key_classes)r r# N)r> rQ identifiersr! )r$ r% rQ rM r r r from_type_string s
zPKey.from_type_stringc C s | j gS )z
returns an iterable of key format/name strings this class can handle.
Most classes only have a single identifier, and thus this default
implementation suffices; see `.ECDSAKey` for one example of an
override.
)name)clsr r r rR s zPKey.identifiersc C s dS )aV
Create a new instance of this public key type. If ``msg`` is given,
the key's public part(s) will be filled in from the message. If
``data`` is given, the key's public part(s) will be filled in from
the string.
:param .Message msg:
an optional SSH `.Message` containing a public key of this type.
:param bytes data:
optional, the bytes of a public key of this type
:raises: `.SSHException` --
if a key cannot be created from the ``data`` or ``msg`` given, or
no key was passed in.
Nr )r& msgr r r r r' s z
PKey.__init__c C sD d}t | dr | jr d| j}d| j d| d| j | dS )N commentz
, comment=z PKey(alg=z, bits=z, fp=))hasattrrX algorithm_nameget_bits fingerprint)r& rX r r r __repr__ s z
PKey.__repr__c C s t S )z
Return a string of an SSH `.Message` made up of the public part(s) of
this key. This string is suitable for passing to `__init__` to
re-create the key object later.
bytesr) r r r asbytes s z PKey.asbytesc C s | S r" )ra r) r r r __bytes__ s zPKey.__bytes__c C s t |to| j|jkS r" )rD r/ _fieldsr& otherr r r __eq__# s z PKey.__eq__c C s
t | jS r" )hashrc r) r r r __hash__& s z
PKey.__hash__c C s t d S r" )NotImplementedErrorr) r r r rc ) s z PKey._fieldsc C s dS )z
Return the name of this private key implementation.
:return:
name of this private key type, in SSH terminology, as a `str` (for
example, ``"ssh-rsa"``).
rW r r) r r r get_name- s z
PKey.get_namec C s@ | dd}d}||kr*||d}n|dd }| S )z
Return the key algorithm identifier for this key.
Similar to `get_name`, but aimed at pure algorithm name instead of SSH
protocol field value.
zssh-rW z-cert-v01@openssh.comz-cert-r )rj replacesplitupper)r& rT Z cert_tailr r r r[ 7 s
zPKey.algorithm_namec C s dS )z
Return the number of significant bits in this key. This is useful
for judging the relative security of a key.
:return: bits in the key (as an `int`)
r r r) r r r r\ K s z
PKey.get_bitsc C s dS )zf
Return ``True`` if this key has the private part necessary for signing
data.
Fr r) r r r can_signV s z
PKey.can_signc C s t | S )z
Return an MD5 fingerprint of the public part of this key. Nothing
secret is revealed.
:return:
a 16-byte `string ` (binary) of the MD5 fingerprint, in SSH
format.
)r ra digestr) r r r get_fingerprint] s zPKey.get_fingerprintc C sB t t| }|j }t| }t| d}| d| S )z
Modern fingerprint property designed to be comparable to OpenSSH.
Currently only does SHA256 (the OpenSSH default).
.. versionadded:: 3.2
=:) r r` rT rn r rp r striprstrip)r& Zhashy hash_nameZb64edcleanedr r r r] h s
zPKey.fingerprintc C s t t| ddS )a+
Return a base64 string containing the public part of this key. Nothing
secret is revealed. This format is compatible with that used to store
public key files or recognized host keys.
:return: a base64 `string ` containing the public part of the key.
rW )r r ra rl r) r r r
get_base64w s zPKey.get_base64c C s t S )a
Sign a blob of data with this private key, and return a `.Message`
representing an SSH signature message.
:param bytes data:
the data to sign.
:param str algorithm:
the signature algorithm to use, if different from the key's
internal name. Default: ``None``.
:return: an SSH signature `message <.Message>`.
.. versionchanged:: 2.9
Added the ``algorithm`` kwarg.
r_ )r& r algorithmr r r
sign_ssh_data s zPKey.sign_ssh_datac C s dS )a^
Given a blob of data, and an SSH message representing a signature of
that data, verify that it was signed with this key.
:param bytes data: the data that was signed.
:param .Message msg: an SSH signature message
:return:
``True`` if the signature verifies correctly; ``False`` otherwise.
Fr )r& r rV r r r verify_ssh_sig s
zPKey.verify_ssh_sigc C s | ||d}|S )a
Create a key object by reading a private key file. If the private
key is encrypted and ``password`` is not ``None``, the given password
will be used to decrypt the key (otherwise `.PasswordRequiredException`
is thrown). Through the magic of Python, this factory method will
exist in all subclasses of PKey (such as `.RSAKey` or `.DSSKey`), but
is useless on the abstract PKey class.
:param str filename: name of the file to read
:param str password:
an optional password to use to decrypt the key file, if it's
encrypted
:return: a new `.PKey` based on the given private key
:raises: ``IOError`` -- if there was an error reading the file
:raises: `.PasswordRequiredException` -- if the private key file is
encrypted, and ``password`` is ``None``
:raises: `.SSHException` -- if the key file is invalid
)filenamer< r )rU r} r< rO r r r from_private_key_file s zPKey.from_private_key_filec C s | ||d}|S )a
Create a key object by reading a private key from a file (or file-like)
object. If the private key is encrypted and ``password`` is not
``None``, the given password will be used to decrypt the key (otherwise
`.PasswordRequiredException` is thrown).
:param file_obj: the file-like object to read from
:param str password:
an optional password to use to decrypt the key, if it's encrypted
:return: a new `.PKey` based on the given private key
:raises: ``IOError`` -- if there was an error reading the key
:raises: `.PasswordRequiredException` --
if the private key file is encrypted, and ``password`` is ``None``
:raises: `.SSHException` -- if the key file is invalid
)file_objr< r )rU r r< rO r r r rI s zPKey.from_private_keyc C s t ddS )a
Write private key contents into a file. If the password is not
``None``, the key is encrypted before writing.
:param str filename: name of the file to write
:param str password:
an optional password to use to encrypt the key file
:raises: ``IOError`` -- if there was an error writing the file
:raises: `.SSHException` -- if the key is invalid
Not implemented in PKeyN Exception)r& r} r< r r r write_private_key_file s zPKey.write_private_key_filec C s t ddS )a
Write private key contents into a file (or file-like) object. If the
password is not ``None``, the key is encrypted before writing.
:param file_obj: the file-like object to write into
:param str password: an optional password to use to encrypt the key
:raises: ``IOError`` -- if there was an error writing to the file
:raises: `.SSHException` -- if the key is invalid
r Nr )r& r r< r r r write_private_key s zPKey.write_private_keyc C s( t |d}| |||}W 5 Q R X |S )a
Read an SSH2-format private key file, looking for a string of the type
``"BEGIN xxx PRIVATE KEY"`` for some ``xxx``, base64-decode the text we
find, and return it as a string. If the private key is encrypted and
``password`` is not ``None``, the given password will be used to
decrypt the key (otherwise `.PasswordRequiredException` is thrown).
:param str tag: ``"RSA"`` or ``"DSA"``, the tag used to mark the
data block.
:param str filename: name of the file to read.
:param str password:
an optional password to use to decrypt the key file, if it's
encrypted.
:return: the `bytes` that make up the private key.
:raises: ``IOError`` -- if there was an error reading the file.
:raises: `.PasswordRequiredException` -- if the private key file is
encrypted, and ``password`` is ``None``.
:raises: `.SSHException` -- if the key file is invalid.
r)rH _read_private_key)r& tagr} r< fr r r r _read_private_key_file s zPKey._read_private_key_filec C s2 | }|std|d}| j|| }t|d }||k r`|s`|d7 }| j|| }q:|d7 }|rv|dnd }|t|ks|d krtd||} | j|| }| |k r|s| d7 } | j|| }q||kr| || |}
| j } n6|dkr|
||| |}
| j } ntd||| |
fS )Nz no lines in {} private key filer r z not a valid {} private key fileZOPENSSHz#encountered {} key, expected {} key) readlinesr format BEGIN_TAGmatchr( groupEND_TAG_read_private_key_pem _PRIVATE_KEY_FORMAT_ORIGINAL_read_private_key_openssh_PRIVATE_KEY_FORMAT_OPENSSH) r& r r r< linesstartm
line_rangekeytypeendr Zpkformatr r r r s8
zPKey._read_private_keyc C s d}t || jj|d S )Nz={}._read_private_key() spat out an unknown key format id '{}')r r rG r+ )r& Zid_errr r r _got_bad_key_format_id% s zPKey._got_bad_key_format_idc
C s d}i }|d7 }|t |k rZ|| d}t |dkr8qZ|d ||d < |d7 }qz ttd||| }W n4 tjj k
r } zt
d |W 5 d }~X Y nX d|kr|S |d } | dkrt
d | z|d d
\}
} W n t
d Y nX |
| j kr t
d |
|d kr0t
d
| j |
d } | j |
d }
| j |
d }tt| }tt|||
}t| |||t d }||| S )Nr r z: rW base64 decoding error: {}z proc-typez 4,ENCRYPTEDz"Unknown private key structure "{}"zdek-info,z(Can't parse DEK-info in private key filez Unknown private key cipher "{}"z Private key file is encryptedr1 r2 r4 )backend)r( rm rt lowerr r joinbase64binasciiErrorr r
_CIPHER_TABLEr r r Zgenerate_key_bytesr r r decryptorupdatefinalize)r& r r r< r headersliner eZ proc_typeZencryption_typeZsaltstrr1 r2 r4 saltrO r r r r r ) sR
zPKey._read_private_key_pemc
C s zt td|}W n4 tjjk
rJ } ztd|W 5 d}~X Y nX |dd }|tkrhtd| |dd d}|\}}} }
} |
dkrtd| | d \} }
|td
kr~|td krt
j }n(|td krt
j }ntd
|
d|dkrtd| | d\}}tjt|t|d|dd}|dd }|dd }tt|||t }||
}|| 7 }n*|tdkr|tdkr|
}ntd| |d}|\}}}}||krtdt|S )z
Read the new OpenSSH SSH2 private key format available
since OpenSSH version 6.5
Reference:
https://github.com/openssh/openssh-portable/blob/master/PROTOCOL.key
rW r Nr z)unexpected OpenSSH key header encounteredZsssurr z.unsupported: private keyfile has multiple keysssbcryptz
aes256-cbcz
aes256-ctrz,unknown cipher `{}` used in private key filezutf-8z private key file is encryptedZsu0 T)Zignore_few_roundsr nonez.unknown cipher or kdf used in private key fileZuusrz/OpenSSH private key file checkints do not match)r r r r r r r r OPENSSH_AUTH_MAGIC_uint32_cstruct_unpackr CBCZCTRdecoder r Zkdfr r
AESr r r r r )r& r r< r r Z
auth_magicZcstructr1 ZkdfnameZ kdf_optionsZ num_pubkeys remainderZpubkeyZ privkey_blobr4 r roundsZkey_ivrO Zivr Zdecrypted_privkeyZ checkint1Z checkint2r Zkeydatar r r r X sr
z PKey._read_private_key_opensshc
C sZ g }d}z|D ]
}|dkrdt d|||d d }|d7 }|||| }||7 }|| |dkrt d|||d d }|d7 }|||| }||7 }t|d}|| q|dkrt d|||d d } |d7 }|| q|dkr||d }|| q qW n0 tk
rP }
ztt|
W 5 d }
~
X Y nX t|S )
a
Used to read new OpenSSH private key format.
Unpacks a c data structure containing a mix of 32-bit uints and
variable length strings prefixed by 32-bit uint size field,
according to the specified format. Returns the unpacked vars
in a tuple.
Format strings:
s - denotes a string
i - denotes a long integer, encoded as a byte string
u - denotes a 32-bit unsigned integer
r - the remainder of the input string, returned as a string
r sz>L r Tr r N) structunpackappendr Z inflate_longr r r? tuple) r& r Z strformatZarridxr Zs_sizer r r r r r r r s8
zPKey._uint32_cstruct_unpackc C sH t t j|t jt jB t jB tdd}| j||||d W 5 Q R X dS )a
Write an SSH2-format private key file in a form that can be read by
paramiko or openssh. If no password is given, the key is written in
a trivially-encoded format (base64) which is completely insecure. If
a password is given, DES-EDE3-CBC is used.
:param str tag:
``"RSA"`` or ``"DSA"``, the tag used to mark the data block.
:param filename: name of the file to write.
:param bytes data: data blob that makes up the private key.
:param str password: an optional password to use to encrypt the file.
:raises: ``IOError`` -- if there was an error writing the file.
)flagsr4 wr= N)osfdopenrH O_WRONLYO_TRUNCO_CREATr _write_private_key)r& r} rO r r< r r r r _write_private_key_file s
z PKey._write_private_key_filec C s@ |d krt }nt t|}||t jj|| d S r" ) r Z NoEncryptionZBestAvailableEncryptionr writeZ
private_bytesZEncodingZPEMr )r& r rO r r< Z
encryptionr r r r s
zPKey._write_private_keyc C s |}|}t |tr|g}t |tr(|g}|dkr8td| | }||krRn<||krv| t| | nd}t| | j
j |dS )a
Perform message type-checking & optional certificate loading.
This includes fast-forwarding cert ``msg`` objects past the nonce, so
that the subsequent fields are the key numbers; thus the caller may
expect to treat the message as key material afterwards either way.
The obtained key type is returned for classes which need to know what
it was (e.g. ECDSA.)
NzKey object may not be emptyz%Invalid key (class: {}, data type: {}) rD r? r rewindget_textrK r ra Z
get_stringr rG r+ )r& rV r$ Z cert_typeZ key_typesZ
cert_typestype_r r r r _check_type_and_load_cert
s"
z PKey._check_type_and_load_certc C sh t |trd}ntj|r"d}nd}tt||}|j| s^d}t
| |j| || _ dS )a5
Supplement the private key contents with data loaded from an OpenSSH
public key (``.pub``) or certificate (``-cert.pub``) file, a string
containing such a file, or a `.Message` object.
The .pub contents adds no real value, since the private key
file includes sufficient information to derive the public
key info. For certificates, however, this can be used on
the client side to offer authentication requests to the server
based on certificate instead of raw public key.
See:
https://github.com/openssh/openssh-portable/blob/master/PROTOCOL.certkeys
Note: very little effort is made to validate the certificate contents,
that is for the server to decide if it is good enough to authenticate
successfully.
from_message from_file from_stringz0PublicBlob type {} incompatible with key type {}N)
rD r r rL isfilegetattr
PublicBlobr$
startswithrj rC r Z public_blob)r& value constructorblobr r r r rK > s
zPKey.load_certificate)N)NN)N)N)N)N)N)N)N)N)N)4r+ r, r- r. r
r r r r r r r recompiler r staticmethodrP rS classmethodrR r' r^ ra rb rf rh propertyrc rj r[ r\ ro rq r] ry r{ r| r~ rI r r r r r r r r r r r rK r r r r r/ [ s
I
%/V1
"
1r/ c @ sV e Zd ZdZdddZedd Zedd Zed d
Zd d Z d
d Z
dd Z dS )r a
OpenSSH plain public key or OpenSSH signed public key (certificate).
Tries to be as dumb as possible and barely cares about specific
per-key-type data.
.. note::
Most of the time you'll want to call `from_file`, `from_string` or
`from_message` for useful instantiation, the main constructor is
basically "I should be using ``attrs`` for this."
Nc C s || _ || _|| _dS )a
Create a new public blob of given type and contents.
:param str type_: Type indicator, eg ``ssh-rsa``.
:param bytes blob: The blob bytes themselves.
:param str comment: A comment, if one was given (e.g. file-based.)
N)r$ key_blobrX )r& r r rX r r r r' r s zPublicBlob.__init__c C s& t |}| }W 5 Q R X | |S )zO
Create a public blob from a ``-cert.pub``-style file on disk.
)rH readr )rU r} r stringr r r r ~ s
zPublicBlob.from_filec
C s | dd}t|dk r*d}t|||d }tt|d }z|d }W n tk
rj d}Y nX t|}| }||krd||} td| | |||dS ) zI
Create a public blob from a ``-cert.pub``-style string.
Nr7 z%Not enough fields for public blob: {}r r z!key type={!r}, but blob type={!r}z Invalid PublicBlob contents: {})r r rX )
rm r( rC r r r rt
IndexErrorr r )
rU r fieldsrV r$ r rX r Z blob_typeZdeetsr r r r s&
zPublicBlob.from_stringc C s | }| || dS )z
Create a public blob from a network `.Message`.
Specifically, a cert-bearing pubkey auth packet, because by definition
OpenSSH-style certificates 'are' their own network representation."
)r r )r ra )rU messager r r r r s zPublicBlob.from_messagec C s& d | j}| jr"|d | j7 }|S )Nz{} public key/certificatez- {})r r$ rX )r& retr r r r* s zPublicBlob.__str__c C s | o|o| j |j kS r" )r rd r r r rf s zPublicBlob.__eq__c C s
| |k S r" r rd r r r __ne__ s zPublicBlob.__ne__)N) r+ r, r- r. r' r r r r r* rf r r r r r r d s
r ).r. r r r r r r pathlibr hashlibr r r r r Z cryptography.hazmat.backendsr Z cryptography.hazmat.primitivesr Z&cryptography.hazmat.primitives.ciphersr
r r r
r> r Z
paramiko.utilr r Zparamiko.commonr Zparamiko.ssh_exceptionr r Zparamiko.messager Z/cryptography.hazmat.decrepit.ciphers.algorithmsr ImportErrorZ1cryptography.hazmat.primitives.ciphers.algorithmsr r r r! r/ r r r r r sB