o g@sPdZddlZddlmZmZddlmZddlZddlmZddl m Z m Z ddl Z ddl Z ddlZddlmZddlmZmZdd lmZmZmZdd lmZdd lmZdd lmZmZdd lmZddl m!Z!m"Z"ddl#m$Z$zddl%m&Z&Wne'yddl(m&Z&YnwdZ)ddZ*Gddde+Z,GdddZ-GdddZ.dS)z! Common API for all public keys. N) encodebytes decodebytes) unhexlify)Path)md5sha256)default_backend)padding serialization) algorithmsmodesCipher) asymmetric)util)ub)o600) SSHExceptionPasswordRequiredException)Message) TripleDESsopenssh-key-v1cCsh|d}d|krdkr|S|dkrtdt|D]}||||dkr,tdq|d| S)N z Invalid key)rrange)datapadding_lengthir G/var/www/html/api-tag/env/lib/python3.10/site-packages/paramiko/pkey.py_unpad_openssh?s r"c@s"eZdZdZdddZddZdS)UnknownKeyTypezK An unknown public/private key algorithm was attempted to be read. NcCs||_||_dSNkey_type key_bytes)selfr&r'r r r!__init__Ss zUnknownKeyType.__init__cCsd|jdt|jdS)NzUnknownKeyType(type=z , bytes=))r&lenr'r(r r r!__str__WszUnknownKeyType.__str__NN)__name__ __module__ __qualname____doc__r)r,r r r r!r#Ns  r#c@seZdZdZejddejdejddejdeddejddZ dZ d Z e d Ze d ZedOd dZeddZeddZdPddZddZddZddZddZddZedd Zd!d"Zed#d$Zd%d&Zd'd(Z d)d*Z!ed+d,Z"d-d.Z#dOd/d0Z$d1d2Z%edOd3d4Z&edOd5d6Z'dOd7d8Z(dOd9d:Z)dOd;d<Z*dOd=d>Z+d?d@Z,dAdBZ-dCdDZ.dEdFZ/dOdGdHZ0dOdIdJZ1dKdLZ2dMdNZ3d S)QPKeyz 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-CBCrz3^-{5}BEGIN (RSA|DSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$z1^-{5}END (RSA|DSA|EC|OPENSSH) PRIVATE KEY-{5}\s*$NcCs\ddlm}m}m}m}t|}d}t||r%|dt| }|}n|}||}t| }t| }| } z t j | |d} Wnt yTt j| |d} Ynwd} t| tjjra|} n%t| tjjrk|} nt| tjjru|} nt| tjjr|} nt| | jd|} | j| |d} Wdn1swY|r| 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)rpassword)r'r&r?)paramikor;r<r=r>strendswithr*r expanduser read_bytesr load_ssh_private_key ValueErrorload_pem_private_key isinstancerdsa DSAPrivateKeyrsa RSAPrivateKeyed25519Ed25519PrivateKeyecEllipticCurvePrivateKeyr# __class__openfrom_private_keyexistsload_certificate)path passphraser;r<r=r> cert_suffixkey_path cert_pathrloaded key_classfdkeyr r r! from_pathsH      zPKey.from_pathcCs<ddlm}|D]}||vr||dSqt||d)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)rr%)rAra identifiersr#)r&r'rar]r r r!from_type_strings   zPKey.from_type_stringcCs|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)clsr r r!rbs zPKey.identifierscCdS)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(msgrr r r!r)sz PKey.__init__cCsDd}t|dr|jrd|j}d|jd|d|j|dS)Ncommentz , comment=z PKey(alg=z, bits=z, fp=))hasattrrialgorithm_nameget_bits fingerprint)r(rir r r!__repr__s $z PKey.__repr__cCtS)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!asbytessz PKey.asbytescCs|Sr$)rsr+r r r! __bytes__ szPKey.__bytes__cCst|to |j|jkSr$)rIr2_fieldsr(otherr r r!__eq__#sz PKey.__eq__cCs t|jSr$)hashrur+r r r!__hash__& z PKey.__hash__cCstr$)NotImplementedErrorr+r r r!ru)sz PKey._fieldscCrf)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"``). rhr r+r r r!get_name-sz PKey.get_namecCsF|dd}d}||vr||d}|S|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-rhz-cert-v01@openssh.comz-cert-r)r}replacesplitupper)r(rd cert_tailr r r!rl7s  zPKey.algorithm_namecCrf)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 r+r r r!rmKs z PKey.get_bitscCrf)zf Return ``True`` if this key has the private part necessary for signing data. Fr r+r r r!can_signVsz PKey.can_signcCst|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. )rrsdigestr+r r r!get_fingerprint]s zPKey.get_fingerprintcCsBtt|}|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 =:) rrrrdrrrrstriprstrip)r(hashy hash_nameb64edcleanedr r r!rnhs  zPKey.fingerprintcCstt|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.  rh)rrrsrr+r r r! get_base64wszPKey.get_base64cCrp)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. rq)r(r algorithmr r r! sign_ssh_dataszPKey.sign_ssh_datacCrf)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(rrgr r r!verify_ssh_sigs zPKey.verify_ssh_sigcC|||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 )rerr?r_r r r!from_private_key_files zPKey.from_private_key_filecCr)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 )rerr?r_r r r!rTs zPKey.from_private_keycCtd)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 PKey Exception)r(rr?r r r!write_private_key_file zPKey.write_private_key_filecCr)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 rr)r(rr?r r r!write_private_keyrzPKey.write_private_keycCs>t|d}||||}Wd|S1swY|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. rN)rS_read_private_key)r(tagrr?frr r r!_read_private_key_files  zPKey._read_private_key_filec CsH|}|s td|d}|j||}t|d}||kr5|s5|d7}|j||}||kr5|r#|d7}|r@|dnd}|t|ksL|durStd||} |j|| }| |kru|su| d7} |j|| }| |kru|rc||kr||| |} |j } | | fS|dkr| ||| |} |j } | | fStd||)Nzno lines in {} private key filerrznot a valid {} private key fileOPENSSHz#encountered {} key, expected {} key) readlinesrformat BEGIN_TAGmatchr*groupEND_TAG_read_private_key_pem_PRIVATE_KEY_FORMAT_ORIGINAL_read_private_key_openssh_PRIVATE_KEY_FORMAT_OPENSSH) r(rrr?linesstartm line_rangekeytypeendrpkformatr r r!rs>       zPKey._read_private_keycCsd}t||jj|)Nz={}._read_private_key() spat out an unknown key format id '{}')rrrRr.)r(id_errr r r!_got_bad_key_format_id%szPKey._got_bad_key_format_idc Csd}i}|d7}|t|kr2||d}t|dkrn|d||d<|d7}|t|kszttd|||}Wntjj yV}zt d |d}~wwd|vr]|S|d} | dkrlt d | z |d d \} } Wnt d | |j vrt d | |durt d |j | d} |j | d} |j | d}tt| }tt||| }t| |||td}|||}t| j}z |||WStyt dw)Nrrz: rhbase64 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 encryptedr4r5r7)backendz(Bad password or corrupt private key file)r*rrlowerrrjoinbase64binasciiErrorrr _CIPHER_TABLErrrgenerate_key_bytesrr r decryptorupdatefinalizer PKCS7 block_sizeunpadderrG)r(rrr?rheaderslinere proc_typeencryption_typesaltstrr4r5r7saltr_rdecrypted_datarr r r!r)sd      zPKey._read_private_key_pemc Csz ttd|}Wntjjy }ztd|d}~ww|dd}|tkr/td| |ddd}|\}}} } } | dkrHtd| | d \} } |td kr|td kr`t j }n|td krjt j }n td | d|dur|td| | 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 rhrNrz)unexpected OpenSSH key header encounteredsssurrz.unsupported: private keyfile has multiple keysssbcryptz aes256-cbcz aes256-ctrz,unknown cipher `{}` used in private key filezutf-8zprivate key file is encryptedsu0T)ignore_few_roundsrnonez.unknown cipher or kdf used in private key fileuusrz/OpenSSH private key file checkints do not match)rrrrrrrrOPENSSH_AUTH_MAGIC_uint32_cstruct_unpackr CBCCTRdecoderrkdfr r AESrrrrr")r(rr?rr auth_magiccstructr4kdfname kdf_options num_pubkeys remainderpubkey privkey_blobr7rroundskey_ivr_ivrdecrypted_privkey checkint1 checkint2rkeydatar r r!r]sv        zPKey._read_private_key_opensshc CsPg}d}z|D]}|dkr0td|||dd}|d7}||||}||7}|||dkr^td|||dd}|d7}||||}||7}t|d}||q|dkrztd|||dd} |d7}|| q|dkr||d }||nqWt|SWt|Sty} ztt| d } ~ ww) 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>LrTrrN) structunpackappendr inflate_longrrrBtuple) r(r strformatarridxrs_sizerrrrr r r!rsD        zPKey._uint32_cstruct_unpackcCs^ttj|tjtjBtjBtdd}|j||||dWddS1s(wYdS)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. )flagsr7wr@N)osfdopenrSO_WRONLYO_TRUNCO_CREATr_write_private_key)r(rr_rr?rr r r!_write_private_key_files  "zPKey._write_private_key_filecCs@|dur t}ntt|}||tjj||dSr$) r NoEncryptionBestAvailableEncryptionrwrite private_bytesEncodingPEMr)r(rr_rr? encryptionr r r!rs  zPKey._write_private_keycCs|}|}t|tr |g}t|tr|g}|durtd||}||vr*dS||vr=|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: {}) rIrBrrewindget_textrVrrs get_stringrrRr.)r(rgr& cert_type key_types cert_typestype_rr r r!_check_type_and_load_certs"    zPKey._check_type_and_load_certcCsht|trd}n tj|rd}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) rIrrrWisfilegetattr PublicBlobr& startswithr}rGr public_blob)r(value constructorblobrr r r!rVCs   zPKey.load_certificater$r-)4r.r/r0r1r rr rrrrrrecompilerr staticmethodr`rc classmethodrbr)rorsrtrxrzpropertyrur}rlrmrrrnrrrrrTrrrrrrrrrrrrVr r r r!r2[s   I              %4V 1 " 1r2c@sVeZdZdZdddZeddZeddZed d Zd d Z d dZ ddZ dS)ra 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." NcCs||_||_||_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_blobri)r(rrrir r r!r)ws zPublicBlob.__init__cCs:t| }|}Wdn1swY||S)zO Create a public blob from a ``-cert.pub``-style file on disk. N)rSreadr)rerrstringr r r!rs   zPublicBlob.from_filec Cs|dd}t|dkrd}t|||d}tt|d}z|d}Wn ty4d}Ynwt|}| }||krNd||} td| ||||dS) zI Create a public blob from a ``-cert.pub``-style string. Nr:z%Not enough fields for public blob: {}rrz!key type={!r}, but blob type={!r}zInvalid PublicBlob contents: {})rrri) rr*rGrrrr IndexErrorrr ) rer#fieldsrgr&r!rir blob_typedeetsr r r!rs&   zPublicBlob.from_stringcCs|}|||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." )rr)r rs)remessagerr r r!rszPublicBlob.from_messagecCs&d|j}|jr|d|j7}|S)Nz{} public key/certificatez- {})rr&ri)r(retr r r!r,s zPublicBlob.__str__cCs|o |o |j|jkSr$)r!rvr r r!rxszPublicBlob.__eq__cCs ||k Sr$r rvr r r!__ne__r{zPublicBlob.__ne__r$) r.r/r0r1r)rrrrr,rxr*r r r r!ris      r)/r1rrrrrrpathlibrhashlibrrrrrcryptography.hazmat.backendsrcryptography.hazmat.primitivesr r &cryptography.hazmat.primitives.ciphersr r r rrAr paramiko.utilrrparamiko.commonrparamiko.ssh_exceptionrrparamiko.messager/cryptography.hazmat.decrepit.ciphers.algorithmsr ImportError1cryptography.hazmat.primitives.ciphers.algorithmsrr"rr#r2rr r r r!sF