֛hOSrSSKJr SSKrSSKrSSKJrJrJ r SSK J r SSK J r SSKJrJrJrJr SSKJr SS KJrJrJr SS KJr SS KJrJrJr SS KJ r SS K!J"r" SSK#J$r$ SSK%J&r& SSK'J(r( SSK)J*r* SSK+J,r, \$"5r-S"Sjr.S#Sjr/"SS5r0\"\5"SS\055r1\"\5"SS55r2S$Sjr3\"\5"SS\0\,55r4"SS5r5"S S!5r6g)%zE An implementation of the OpenSSH known_hosts database. @since: 8.2 ) annotationsN)Error a2b_base64 b2a_base64)closing)sha1)IOCallableIterableLiteral) implementer)HostKeyChanged InvalidEntryUserRejectedKey)IKnownHostEntry) BadKeyErrorFingerprintFormatsKey)defer)Deferred)Logger) nativeString)FilePath) secureRandom) FancyEqMixinc4[U5R5$)z Encode a binary string as base64 with no trailing newline. @param s: The string to encode. @return: The base64-encoded string. )rstrip)ss cC:\Users\psant\Downloads\Noiseback\school\venv\Lib\site-packages\twisted/conch/client/knownhosts.py _b64encoder $s a=    c$URSS5n[U5S:wa [5eUup#nURSS5n[U5S:XaUupgURS5nOUSnSn[R "[ U55nX#X4$)ai Extract common elements of base64 keys from an entry in a hosts file. @param string: A known hosts file entry (a single line). @return: a 4-tuple of hostname data (L{bytes}), ssh key type (L{bytes}), key (L{Key}), and comment (L{bytes} or L{None}). The hostname data is simply the beginning of the line up to the first occurrence of whitespace. N r)splitlenrrstripr fromStringr) stringelements hostnameskeyType keyAndCommentsplitkey keyStringcommentkeys r_extractCommonr4/s||D!$H 8}n(0%I ""4+H 8}% ..'QK  ..I. /C s ++r!c,\rSrSrSrSSjrSSjrSrg) _BaseEntryIa Abstract base of both hashed and non-hashed entry objects, since they represent keys and key types the same way. @ivar keyType: The type of the key; either ssh-dss or ssh-rsa. @type keyType: L{bytes} @ivar publicKey: The server public key indicated by this line. @type publicKey: L{twisted.conch.ssh.keys.Key} @ivar comment: Trailing garbage after the key line. @type comment: L{bytes} or C{None} c(XlX lX0lgN)r. publicKeyr2)selfr.r:r2s r__init___BaseEntry.__init__Xs " r!c$URU:HnU$)z Check to see if this entry matches a given key object. @param keyObject: A public key object to check. @return: C{True} if this entry's key matches C{keyObject}, C{False} otherwise. )r:)r; keyObjectresults r matchesKey_BaseEntry.matchesKey]s9, r!)r2r.r:N)r.bytesr:rr2 bytes | NonereturnNone)r?rrEbool)__name__ __module__ __qualname____firstlineno____doc__r<rA__static_attributes__r!rr6r6Is  r!r6ch^\rSrSrSrSU4Sjjr\S Sj5rS SjrS Sjr Sr U=r $) PlainEntryjz A L{PlainEntry} is a representation of a plain-text entry in a known_hosts file. @ivar _hostnames: the list of all host-names associated with this entry. c2>Xl[TU] X#U5 gr9) _hostnamessuperr<)r;r-r.r:r2 __class__s rr<PlainEntry.__init__ss(1 W5r!cT[U5up#pEU"URS5X4U5nU$)a> Parse a plain-text entry in a known_hosts file, and return a corresponding L{PlainEntry}. @param string: a space-separated string formatted like "hostname key-type base64-key-data comment". @raise DecodeError: if the key is not valid encoded as valid base64. @raise InvalidEntry: if the entry does not have the right number of elements and is therefore invalid. @raise BadKeyError: if the key, once decoded from base64, is not actually an SSH key. @return: an IKnownHostEntry representing the hostname and key in the input line. @rtype: L{PlainEntry} ,)r4r')clsr+r-r.r3r2r;s rr*PlainEntry.fromString}s/,,:&+A( C9??4('@ r!cj[U[5(aURS5nXR;$)z Check to see if this entry matches a given hostname. @param hostname: A hostname or IP address literal to check against this entry. @return: C{True} if this entry is for the given hostname or IP address, C{False} otherwise. utf-8) isinstancestrencoderSr;hostnames r matchesHostPlainEntry.matchesHosts, h $ $w/H??**r!cSRUR5UR[URR 55/nUR bURUR 5 SRU5$)z Implement L{IKnownHostEntry.toString} by recording the comma-separated hostnames, key type, and base-64 encoded key. @return: The string representation of this entry, with unhashed hostname information. rX )joinrSr.r r:blobr2appendr;fieldss rtoStringPlainEntry.toStringsb IIdoo & LL t~~**, -  << # MM$,, 'yy  r!)rS)r-z list[bytes]r.rCr:rr2rD)r+rCrErP)ra bytes | strrErGrErC) rHrIrJrKrLr< classmethodr*rbrkrM __classcell__rUs@rrPrPjsV666 6  62 +!!r!rPcP\rSrSr%SrSrS\S'S SjrS SjrS Sjr SS jr S r g) UnparsedEntryz L{UnparsedEntry} is an entry in a L{KnownHostsFile} which can't actually be parsed; therefore it matches no keys and no hosts. NrFr.cXlg)z^ Create an unparsed entry from a line in a known_hosts file which cannot otherwise be parsed. N_string)r;r+s rr<UnparsedEntry.__init__s  r!cgz Always returns False. FrNr`s rrbUnparsedEntry.matchesHostr!cgrzrN)r;r3s rrAUnparsedEntry.matchesKeyr|r!c8URRS5$)z Returns the input line, without its newline if one was given. @return: The string representation of this entry, almost exactly as was used to initialize this entry but without a trailing newline. @rtype: L{bytes} r&)rwr)r;s rrkUnparsedEntry.toStrings||""5))r!rv)r+rCrErFrarCrErG)r3rrErGrn) rHrIrJrKrLr.__annotations__r<rbrArkrMrNr!rrsrss' GT  *r!rsc[R"U[S9n[U[5(aUR S5nUR U5 UR5$)z Return the SHA-1 HMAC hash of the given key and string. @param key: The HMAC key. @param string: The string to be hashed. @return: The keyed hash value. ) digestmodr\)hmacHMACrr]r^r_updatedigest)r3r+hashs r _hmacedStringrsG 99SD )D&#w'KK ;;=r!cx^\rSrSrSrSrSrS U4Sjjr\S Sj5r S Sjr S Sjr S r U=r $) HashedEntryaq A L{HashedEntry} is a representation of an entry in a known_hosts file where the hostname has been hashed and salted. @ivar _hostSalt: the salt to combine with a hostname for hashing. @ivar _hostHash: the hashed representation of the hostname. @cvar MAGIC: the 'hash magic' string used to identify a hashed line in a known_hosts file as opposed to a plaintext one. s|1|) _hostSalt _hostHashr.r:r2c>>XlX l[TU] X4U5 gr9)rrrTr<)r;hostSalthostHashr.r:r2rUs rr<HashedEntry.__init__s"! W5r!c[U5up#pEU[UR5SRS5n[U5S:wa [ 5eUupxU"[ U5[ U5X4U5n U $)a Load a hashed entry from a string representing a line in a known_hosts file. @param string: A complete single line from a I{known_hosts} file, formatted as defined by OpenSSH. @raise DecodeError: if the key, the hostname, or the is not valid encoded as valid base64 @raise InvalidEntry: if the entry does not have the right number of elements and is therefore invalid, or the host/hash portion contains more items than just the host and hash. @raise BadKeyError: if the key, once decoded from base64, is not actually an SSH key. @return: The newly created L{HashedEntry} instance, initialized with the information from C{string}. N|r#)r4r(MAGICr'rr) rYr+stuffr.r3r2 saltAndHashrrr;s rr*HashedEntry.fromString so,(6f'=$C N,-33D9 { q . (:h'H)=wWU r!cl[R"[URU5UR5$)a= Implement L{IKnownHostEntry.matchesHost} to compare the hash of the input to the stored hash. @param hostname: A hostname or IP address literal to check against this entry. @type hostname: L{bytes} @return: C{True} if this entry is for the given hostname or IP address, C{False} otherwise. @rtype: L{bool} )rcompare_digestrrrr`s rrbHashedEntry.matchesHost+s+"" $..( 3T^^  r!c\URSR[UR5[UR5/5-UR [UR R55/nURbURUR5 SRU5$)z Implement L{IKnownHostEntry.toString} by base64-encoding the salt, host hash, and key. @return: The string representation of this entry, with the hostname part hashed. @rtype: L{bytes} rre) rrfr rrr.r:rgr2rhris rrkHashedEntry.toString<s JJiiDNN3Z5OPQ R LL t~~**, -   << # MM$,, 'yy  r!)rr) rrCrrCr.rCr:rr2rDrErF)r+rCrErrrn)rHrIrJrKrLrcompareAttributesr<ror*rbrkrMrprqs@rrrsw  EU 6 6 6 6  6  6  6: "!!r!rc\rSrSrSrS Sjr\SSj5rSSjrSSjr SSjr SSjr SS jr \ SS j5rS rg )KnownHostsFileiPaN A structured representation of an OpenSSH-format ~/.ssh/known_hosts file. @ivar _added: A list of L{IKnownHostEntry} providers which have been added to this instance in memory but not yet saved. @ivar _clobber: A flag indicating whether the current contents of the save path will be disregarded and potentially overwritten or not. If C{True}, this will be done. If C{False}, entries in the save path will be read and new entries will be saved by appending rather than overwriting. @type _clobber: L{bool} @ivar _savePath: See C{savePath} parameter of L{__init__}. c,/UlXlSUlg)z Create a new, empty KnownHostsFile. Unless you want to erase the current contents of C{savePath}, you want to use L{KnownHostsFile.fromPath} instead. @param savePath: The L{FilePath} to which to save new entries. @type savePath: L{FilePath} TN)_added _savePath_clobber)r;savePaths rr<KnownHostsFile.__init__as.0 ! r!cUR$)z, @see: C{savePath} parameter of L{__init__} )rrs rrKnownHostsFile.savePathos ~~r!c## URHnUv M UR(agURR5nU UHXnUR [ R5(a[ RU5nO[RU5nUv MZ SSS5 g![a gf=f![[[4a [U5nNCf=f!,(df  g=f7f)a Iterate over the host entries in this file. @return: An iterable the elements of which provide L{IKnownHostEntry}. There is an element for each entry in the file as well as an element for each added but not yet saved entry. @rtype: iterable of L{IKnownHostEntry} providers N)rrropenOSError startswithrrr*rP DecodeErrorrrrs)r;entryfplines r iterentriesKnownHostsFile.iterentriesvs[[EK! ==  $$&B0{'8'899 + 6 6t < * 5 5d ; R   $\;?0)$/E0Rsp*C8B1C8 C'9C C' C C'( C81 B>;C8=B>>C8 C$!C'#C$$C'' C51C8c^[UR5[UR5*5H{up4URUR 5:XdM%UR U5(dM=URU5(a gUS:aSnSnOUS-nURn[XFU5e g)an Check for an entry with matching hostname and key. @param hostname: A hostname or IP address literal to check for. @param key: The public key to check for. @return: C{True} if the given hostname and key are present in this file, C{False} if they are not. @raise HostKeyChanged: if the host key found for the given hostname does not match the given key. TrNr%F) enumeraterr(rr.sshTyperbrArr)r;rar3lineidxrrpaths r hasHostKeyKnownHostsFile.hasHostKeys((8(8(:S=MU(aT RTT5(dgSTR5STR5S3nT RUR S55 T R TT5 T R 5 U$SUUUU 4SjjnTR5nUS:XaSnS[T5<S [T5<S U<S TR[RS 9<S 3 nT RUR [R"555nURU5$)NzWarning: Permanently added the z host key for IP address 'z' to the list of known hosts. r\c>U(a6TRTT5 TRTT5 TR5 U$[5er9) addHostKeysaver)responseraipr3r;s rpromptResponseGKnownHostsFile.verifyHostKey..gotHasKey..promptResponses9#6C0 '-//r!ECECDSAzThe authenticity of host 'z (z)' can't be established. z key fingerprint is SHA256:)formatz9. Are you sure you want to continue connecting (yes/no)? )rrGrErG)rtypedecodewarnr_rrr fingerprintr SHA256_BASE64promptsysgetdefaultencoding addCallback) r@ addMessagerkeytyperproceedrarr3r;uis r gotHasKey/KnownHostsFile.verifyHostKey..gotHasKeysr3//9#((*F,,.IIK=9$$ GGJ--g67OOB,IIK 00 #xxzd?%G%X.$R(/A/O/OP ))FMM#2H2H2J$KL**>::r!)r@rGrEzbool | Deferred[bool])rexecuterr)r;rrarr3hhkrs````` r verifyHostKeyKnownHostsFile.verifyHostKeys7,mmDOOXs;) ;) ;Vy))r!c[S5nUR5n[U[X15XBS5nURR U5 U$)a Add a new L{HashedEntry} to the key database. Note that you still need to call L{KnownHostsFile.save} if you wish these changes to be persisted. @param hostname: A hostname or IP address literal to associate with the new entry. @type hostname: L{bytes} @param key: The public key to associate with the new entry. @type key: L{Key} @return: The L{HashedEntry} that was added. @rtype: L{HashedEntry} N)rrrrrrh)r;rar3saltr.rs rrKnownHostsFile.addHostKeysE"B++-D-"?tT 5! r!c URR5nUR5(dUR5 UR(aSOSnURR U5nUR (aRURSRUR Vs/sHoDR5PM sn5S-5 /UlSSS5 SUlgs snf!,(df  N=f)z= Save this L{KnownHostsFile} to the path it was loaded from. war&NF) rparentisdirmakedirsrrrwriterfrk)r;pmode hostsFileObjrs rrKnownHostsFile.saves NN ! ! #wwyy JJL)-#C ^^  &,{{""JJdkkJkU 0kJKeS! '   K' &s06C)&C$?C)$C)) C7c$U"U5nSUlU$)au Create a new L{KnownHostsFile}, potentially reading existing known hosts information from the given file. @param path: A path object to use for both reading contents from and later saving to. If no file exists at this path, it is not an error; a L{KnownHostsFile} with no entries is returned. @return: A L{KnownHostsFile} initialized with entries from C{path}. F)r)rYr knownHostss rfromPathKnownHostsFile.fromPath sY # r!)rrrN)r FilePath[str]rErF)rEr)rEzIterable[IKnownHostEntry])rarCr3rrErG) r ConsoleUIrarCrrCr3rrEDeferred[bool])rarCr3rrEr)rErF)rrrEr)rHrIrJrKrLr<propertyrrrrrrrorrMrNr!rrrPs|  >AC* C*J."  r!rc6\rSrSrSrSSjrS SjrS SjrSrg) ri1zz A UI object that can ask true/false questions and post notifications on the console, to be used during key verification. cXlg)a @param opener: A no-argument callable which should open a console binary-mode file-like object to be used for reading and writing. This initializes the C{opener} attribute. @type opener: callable taking no arguments and returning a read/write file-like object Nopener)r;rs rr<ConsoleUI.__init__7s  r!cb^^[R"S5nUU4SjnURU5$)aw Write the given text as a prompt to the console output, then read a result from the console input. @param text: Something to present to a user to solicit a yes or no response. @type text: L{bytes} @return: a L{Deferred} which fires with L{True} when the user answers 'yes' and L{False} when the user answers 'no'. It may errback if there were any I/O errors. Nc<>[TR55nURT5 UR5R 5R 5nUS:Xa SSS5 gUS;a SSS5 gURS5 M_!,(df  g=f)NTsyes>r!noFsPlease type 'yes' or 'no': )rrrreadlinerlower)ignoredfanswerr;texts rbodyConsoleUI.prompt..bodyPs'1 ZZ\//1779F'# ('  </$(' >?('sAB *B :B  B)rsucceedr)r;rdrs`` rrConsoleUI.promptAs* MM$  @}}T""r!c[UR55nURU5 SSS5 g!,(df  g=f![a [R S5 gf=f)z Notify the user (non-interactively) of the provided text, by writing it to the console. @param text: Some information the user is to be made aware of. NzFailed to write to console)rrr Exceptionlogfailure)r;rrs rrConsoleUI.warn^sI 6'1 ('' 6 KK4 5 6s+A6A AAAA)(A)rN)rzCallable[[], IO[bytes]]rErF)rrCrEr)rrCrErF) rHrIrJrKrLr<rrrMrNr!rrr1s #: 6r!r)rrCrErC)r+rCrEz&tuple[bytes, bytes, Key, bytes | None])r3rCr+rmrErC)7rL __future__rrrbinasciirrrr contextlibrhashlibrtypingr r r r zope.interfacer twisted.conch.errorrrrtwisted.conch.interfacesrtwisted.conch.ssh.keysrrrtwisted.internetrtwisted.internet.deferrtwisted.loggerrtwisted.python.compatrtwisted.python.filepathrtwisted.python.randbytesrtwisted.python.utilrrr r4r6rPrsrrrrrNr!rrs  # AA22&MM4GG"+!.,1, h!,4B _I!I!I!X _#*#*#*L" _]!*l]!]!@^^B8686r!