3xjƕhdZddlZddlZddlZddlZddlmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZmZmZddlZdd lmZdd lmZmZmZdd lmZdd lmZdd lm Z ddl!m"Z"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,m-Z-ddl.m/Z/m0Z0 ddl1m2Z2n#e3$r ddl4m2Z2YnwxYwdZ5dZ6Gdde7Z8GddeZ9ee eefZ:e9ej;j<ej=j>Z>e9ej;j?ej=j>Z@GddZAGddZBdS) z! Common API for all public keys. N) decodebytes encodebytes) unhexlify)md5sha256) RawIOBase)Path) NamedTupleOptionalUnion)default_backend) asymmetricpadding serialization)EllipticCurvePrivateKey)Ed25519PrivateKey) RSAPrivateKey)Cipher algorithmsmodes)util)o600)Message)PasswordRequiredException SSHException)bu) TripleDESsopenssh-key-v1c|d}d|cxkrdkrnn|S|dkrtdt|D]#}|||z |dzkrtd$|d| S)N z Invalid key)rrange)datapadding_lengthis >C:\Projects\Historical\venv\Lib\site-packages\paramiko/pkey.py_unpad_opensshr*Cs"XN ~$$$$$$$$$ =))) > " ".. N" #q1u , ,}-- - -  . !!c eZdZdZddZdZdS)UnknownKeyTypezK An unknown public/private key algorithm was attempted to be read. Nc"||_||_dSNkey_type key_bytes)selfr1r2s r)__init__zUnknownKeyType.__init__Ws  "r+cBd|jdt|jdS)NzUnknownKeyType(type=z , bytes=))r1lenr2r3s r)__str__zUnknownKeyType.__str__[s'WdmWWDN@S@SWWWWr+NN)__name__ __module__ __qualname____doc__r4r8r+r)r-r-RsF####XXXXXr+r-c8eZdZUejed<ejed<dS) FileFormatformatencodingN)r:r;r<r PrivateFormat__annotations__Encodingr>r+r)r@r@_s0  ''''$$$$$$r+r@)rArBc eZdZdZejddejdejddejdeddejddZ dZ d Z e j d Ze j d Zed6d eefdZe d6deded eefdZedZd7dZdZdZdZdZdZedZdZ edZ!dZ"dZ#dZ$edZ%d Z&d6d!Z'd"Z(ed6d#Z)ed6d$Z*d e+fd%ed eed&e,fd'Z-d e+fd(e.d eed&e,fd)Z/d6d*Z0d6d+Z1d,Z2d-Z3d.Z4d/Z5 d6d%ed0e6d&e,d eefd1Z7 d6d2e.d0e6d&e,d eefd3Z8d4Z9d5Z:d S)8PKeyz 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$z/^-{5}BEGIN (RSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$z-^-{5}END (RSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$Npasswordcddlm}m}m}t |}d}t ||r|dt | }|}n|}||z}t|}t|}| } tj ||} n&#t$rtj ||} YnwxYwd} t| tjjr|} nZt| tjjr|} n8t| tjjr|} nt-|| j|5} | | |} dddn #1swxYwY|r"| t || S)a% Attempt to instantiate appropriate key subclass from given file path. :param pathlib.Path path: The path to load (may also be a `str`). :param str password: Optional decryption password. :returns: A `PKey` subclass instance. :raises: `UnknownKeyType`, if our crypto backend doesn't know this key type. .. versionadded:: 3.2 .. versionchanged:: 5.0 Renamed ``passphrase`` argument to ``password`` for consistency with older methods. r)ECDSAKey Ed25519KeyRSAKeyz -cert.pubNr&rP)r2r1rP)paramikorRrSrTstrendswithr6r expanduser read_bytesrload_ssh_private_key ValueErrorload_pem_private_key isinstancerrsared25519recrr- __class__openfrom_private_keyexistsload_certificate) pathrPrRrSrT cert_suffixkey_path cert_pathr&loaded key_classfdkeys r) from_pathzPKey.from_pathsX* :9999999994yy" t99  k * * +/s;////0HIIH{*I>>,,..OO..00 ""$$ "7HFF   "7HFFF  fjn: ; ; LII  2 D E E L"II  E F F L II 4&:JKKK K ]]__ D,,R(,CCC D D D D D D D D D D D D D D D      1  Y 0 0 0 s$7C C10C1F**F.1F.r1r2cddlm}|D]'}||vr|||cS(t||)a 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. :param str password: Optional password used to decrypt ``key_bytes``. :returns: A `PKey` subclass instance. :raises: `UnknownKeyType`, if no registered classes knew about this type. .. versionadded:: 3.2 .. versionchanged:: 5.0 Added the ``password`` kwarg. r) key_classesrUr0)rWrr identifiersr-)r1r2rPrrrms r)from_type_stringzPKey.from_type_stringsq8 )((((($ D DI9002222 yi(CCCCCC3h)DDDDr+c|jgS)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)clss r)rszPKey.identifiersszr+cdS)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>)r3msgr&s r)r4z PKey.__init__s r+cd}t|dr|jr d|j}d|jd|d|j|dS)Ncommentz , comment=z PKey(alg=z, bits=z, fp=))hasattrr|algorithm_nameget_bits fingerprint)r3r|s r)__repr__z PKey.__repr__/sf 4 # # 4  434<33Gi4.iit}}iiTM]i_fiiiir+ctS)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. bytesr7s r)asbytesz PKey.asbytes7s wwr+c*|Sr/)rr7s r) __bytes__zPKey.__bytes__?s||~~r+cLt|to|j|jkSr/)r_rG_fieldsr3others r)__eq__z PKey.__eq__Bs %&&H4<5=+HHr+c*t|jSr/)hashrr7s r)__hash__z PKey.__hash__EsDL!!!r+ctr/)NotImplementedErrorr7s r)rz PKey._fieldsHs!!r+cdS)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"``). r{r>r7s r)get_namez PKey.get_nameLs rr+c|dd}d}||vr||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-r{z-cert-v01@openssh.comz-cert-r)rreplacesplitupper)r3rv cert_tails r)rzPKey.algorithm_nameVsj}}&&vr22+   << 733DD::c??1%Dzz||r+cdS)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`) rr>r7s r)rz PKey.get_bitsjs qr+cdS)zf Return ``True`` if this key has the private part necessary for signing data. Fr>r7s r)can_signz PKey.can_signvs ur+cht|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. )rrdigestr7s r)get_fingerprintzPKey.get_fingerprint}s&4<<>>""))+++r+c$tt|}|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 =:) rrrvrrrrstriprstrip)r3hashy hash_nameb64edcleaneds r)rzPKey.fingerprintsvuT{{##J$$&& ELLNN++E((..""))#..''g'''r+ctt|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.  r{)rrrrr7s r) get_base64zPKey.get_base64s2T\\^^,,--55dB???r+ctS)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)r3r& algorithms r) sign_ssh_datazPKey.sign_ssh_datas wwr+cdS)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>)r3r&rys r)verify_ssh_sigzPKey.verify_ssh_sigs ur+c |||}|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`), 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 )filenamerPr>)rwrrPros r)from_private_key_filezPKey.from_private_key_files*c8h777 r+c |||}|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_objrPr>)rwrrPros r)rezPKey.from_private_keys$c8h777 r+r file_formatcB|||j||dS)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 :param FileFormat file_format: what format+encoding pair to use; defaults to the original behavior, namely PEM. :raises: ``IOError`` -- if there was an error writing the file :raises: `.SSHException` -- if the key is invalid rrPN)_write_private_key_file private_key)r3rrPrs r)write_private_key_filezPKey.write_private_key_files:( $$   # %     r+rcB|||j||dS)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 :param FileFormat file_format: what format+encoding pair to use; defaults to the original behavior, namely PEM. :raises: ``IOError`` -- if there was an error writing to the file :raises: `.SSHException` -- if the key is invalid rN)_write_private_keyr)r3rrPrs r)write_private_keyzPKey.write_private_keys:&    #      r+ct|d5}||||}dddn #1swxYwY|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 etc), 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. rN)rd_read_private_key)r3tagrrPfr&s r)_read_private_key_filezPKey._read_private_key_file s.(C  >--eS(CCD8HH  ! !11%c 2BHMMD7HH5<#tjj $r'}td |d}~wwxYwd|vr|S|d} | dkr"td |  |d d \} } n#td xYw| |j vr"td | |td |j | d} |j | d} |j | d}tt | }tjt"||| }t%| |||t'}|||z}t/j| j} |||zS#t6$rtdwxYw)Nrr$z: r{base64 decoding error: {}z proc-typez 4,ENCRYPTEDz"Unknown private key structure "{}"zdek-info,z(Can't parse DEK-info in private key filezUnknown private key cipher "{}"zPrivate key file is encryptedrIrJrL)backendz(Bad password or corrupt private key file)r6rrlowerrrjoinbase64binasciiErrorrrA _CIPHER_TABLErrrgenerate_key_bytesrrr decryptorupdatefinalizerPKCS7 block_sizeunpadderr])r3rrrPrheadersliner&e proc_typeencryption_typesaltstrrIrJrLsaltrordecrypted_datars r)rzPKey._read_private_key_pemds   c%jj  <%%d++D4yyA~~'+Aw}}GDGMMOO $ QJE c%jj   FquSy)9!:!:;;<$_5i@!/26:7$$%c47CC F3KKd_->->   )++ #))$//)2D2D2F2FF=!233<<>> K??>22X5F5F5H5HH H K K KIJJ J Ks07CD &"DD E&&E7?)K))Lc ttd|}n>#tjj$r'}t d|d}~wwxYw|dd}|tkrt d| |ddd}|\}}} } } | dkrt d| | d \} } |td kr]|td kr tj }nU|td kr tj }n5t d | d|td| | d\}}tjt|t|d|d}|dd}|dd}t#t%j|||t)}|| }||z }n8|tdkr|tdkr| }nt d| |d}|\}}}}||krt dt1|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 r{rNr#z)unexpected OpenSSH key header encounteredsssurr$z.unsupported: private keyfile has multiple keysssbcryptz aes256-cbcz aes256-ctrz,unknown cipher `{}` used in private key filezutf-8zprivate key file is encryptedsu0T)ignore_few_roundsr!nonez.unknown cipher or kdf used in private key fileuusrz/OpenSSH private key file checkints do not match)rrrrrrrrAOPENSSH_AUTH_MAGIC_uint32_cstruct_unpackrCBCCTRdecoderrkdfrrAESr rrrr*)r3rrPr&r auth_magiccstructrIkdfname kdf_options num_pubkeys remainderpubkey privkey_blobrLrroundskey_ivroivrdecrypted_privkey checkint1 checkint2rkeydatas r)rzPKey._read_private_key_opensshs Fq0011DD$ F F F:AA!DDEE E F#2#Y + + +JKK K--d233iAA?F<k9 ??@  $::9dKK akk ! !<((y1\??**y"BII g../3  66{DIILD&Z( $#'F"+CBs##TT"XX/@/@ikk !* 0 0 > >  !3!3!5!5 5   qyy W& %9%9 ,  @  --.?HH18. 9gw  ! !A g&&&s/2A-"A((A-cg}d} |D]8}|dkrRtjd|||dzd}|dz }||||z}||z }|||dkrhtjd|||dzd}|dz }||||z}||z }tj|d}|||dkrBtjd|||dzd} |dz }|| |dkr!||d }||n:n.#t $r!} t t| d } ~ wwxYwt|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 rsz>Lr(TrrN) structunpackappendr inflate_long ExceptionrrXtuple) r3r& strformatarridxrs_sizerr(rrs r)rzPKey._uint32_cstruct_unpacks '  88#]4cC!Gm1DEEaHF1HCS3</0A6MCJJqMMM88#]4cC!Gm1DEEaHF1HCS3</0A6MC)!T22AJJqMMMM#XX dDsQw,?@@CA1HCJJqMMMM#XXSTT AJJqMMME   ' ' 's1vv&& &  ' SzzsDq{{KKJ    $k&8*  fhh     r+c|}|}t|tr|g}t|tr|g}|td||}||vrdS||vrJ|t ||dSd}t| |j j |)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: {}) r_rXrrewindget_textrgrr get_stringrArcr:)r3ryr1 cert_type key_types cert_typestype_rs r)_check_type_and_load_certzPKey._check_type_and_load_certKs  h $ $ $" I j# & & &$J ;<== =   I   Dj   ! !'#++--"8"8 9 9 9 NN     9Cszz$.*A5IIJJ Jr+ct|trd}n$tj|rd}nd}t t ||}|j| sr+r)rGrGvs`!nI   !nI    I   M($% "# MNNIbjIJJGHH(3-HHH\HTCG E E E"' E3;C= E E E\ ED[     0jjjIII"""""X"X&    , , , ( (X (@@@"   [.[.#'"%    3-      <#'"%    3-      46####JEEE2K2K2KhT'T'T'l///l#' LLLL L 3- LLLL>#'       3-     $/K/K/Kb     r+rGcneZdZdZd dZedZedZedZdZ dZ d 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." Nc0||_||_||_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)r1key_blobr|)r3r6rCr|s r)r4zPublicBlob.__init__s   r+ct|5}|}dddn #1swxYwY||S)zO Create a public blob from a ``-cert.pub``-style file on disk. N)rdreadr;)rwrrstrings r)r:zPublicBlob.from_files (^^ qVVXXF               v&&&s 155c*|dd}t|dkr$d}t|||d}t t |d} |d}n#t$rd}YnwxYwt|}| }||kr8d||} td| ||||S) zI Create a public blob from a ``-cert.pub``-style string. NrOz%Not enough fields for public blob: {}rr$z!key type={!r}, but blob type={!r}zInvalid PublicBlob contents: {})r6rCr|) rr6r]rArrr IndexErrorrr1) rwrPfieldsryr1rMr|r blob_typedeetss r)r;zPublicBlob.from_strings dA&& v;;??9CSZZ//00 0!9q||,, Qioo''GG   GGG  H  JJLL  7>>)E>EEeLLMM Ms'BBBBs9B B#"B#ch|}|||S)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." )r6rC)r1r)rwmessager6s r)r9zPublicBlob.from_messages4  ""sW__%6%67777r+cd|j}|jr|d|jz }|S)Nz{} public key/certificatez- {})rAr1r|)r3rets r)r8zPublicBlob.__str__s>)00?? < / 6==.. .C r+c*|o|o|j|jkSr/)rMrs r)rzPublicBlob.__eq__sAA$-5>"AAr+c||k Sr/r>rs r)__ne__zPublicBlob.__ne__s5=  r+r/) r:r;r<r=r4rGr:r;r9r8rr\r>r+r)r>r>s      ''['CC[C488[8 BBB!!!!!r+r>)Cr=rr$rDrrrrrhashlibrriorpathlibr typingr r r rcryptography.hazmat.backendsr cryptography.hazmat.primitivesrrr,cryptography.hazmat.primitives.asymmetric.ecr1cryptography.hazmat.primitives.asymmetric.ed25519r-cryptography.hazmat.primitives.asymmetric.rsar&cryptography.hazmat.primitives.ciphersrrrrWrparamiko.commonrparamiko.messagerparamiko.ssh_exceptionrr paramiko.utilrr/cryptography.hazmat.decrepit.ciphers.algorithmsr ImportError1cryptography.hazmat.primitives.ciphers.algorithmsrr*rr-r@rJrCTraditionalOpenSSLrErIOpenSSHrrGr>r>r+r)rpsV& ++++++++.......... 888888MMMMMMMMMMPOOOOOGGGGGGLLLLLLLLLL $$$$$$JJJJJJJJLIIIIIIILLLKKKKKKKKL+ " " " X X X X XY X X X%%%%%%%%="9;LL M j  & 9  # ' *  & .  # '   c  c  c  c  c  c  c  c  XT!T!T!T!T!T!T!T!T!T!sB B'&B'