o G)f6@sdZddlmZddlZddlmZmZmZmZddl m Z m Z m Z ddl m Z ddlmZmZdd lmZmZmZmZmZmZmZmZdd lmZerRdd lmZGd d d ZdS)z5Implementing support for MySQL Authentication Plugins) annotationsN) TYPE_CHECKINGAnyDictOptional)InterfaceErrorNotSupportedError get_exception)logger)MySQLAuthPluginget_auth_plugin)AUTH_SWITCH_STATUSDEFAULT_CHARSET_IDDEFAULT_MAX_ALLOWED_PACKET ERR_STATUSEXCHANGE_FURTHER_STATUS MFA_STATUS OK_STATUS MySQLProtocol) HandShakeType) MySQLSocketc @seZdZdZd:ddZed;ddZedd?d!d"Z d@d%d&Z d@d'd(Z d)d)d)d)ded e dddd*f dAd8d9ZdS)BMySQLAuthenticatorz$Implements the authentication phase.returnNonecCs(d|_i|_i|_d|_d|_d|_dS)z Constructor.FN) _username _passwords_plugin_config _ssl_enabled_auth_strategy_auth_plugin_classselfr$[/var/www/html/flask-app/venv/lib/python3.12/site-packages/mysql/connector/authentication.py__init__:s  zMySQLAuthenticator.__init__boolcC|jS)z&Signals whether or not SSL is enabled.)rr"r$r$r% ssl_enabledCszMySQLAuthenticator.ssl_enabledDict[str, Any]cCr()aCustom arguments that are being provided to the authentication plugin when called. The parameters defined here will override the ones defined in the auth plugin itself. The plugin config is a read-only property - the plugin configuration provided when invoking `authenticate()` is recorded and can be queried by accessing this property. Returns: dict: The latest plugin configuration provided when invoking `authenticate()`. )rr"r$r$r% plugin_configHsz MySQLAuthenticator.plugin_configrsockrhoststr ssl_optionsOptional[Dict[str, Any]]charsetint client_flagsmax_allowed_packetbytesc Cs|duri}tj|||d}||td|j|d|d|d|dd|d d|d |d d }td |||tdd|_|S)aSets up an SSL communication channel. Args: sock: Pointer to the socket connection. host: Server host name. ssl_options: SSL and TLS connection options (see `network.MySQLSocket.build_ssl_context`). charset: Client charset (see [1]), only the lower 8-bits. client_flags: Integer representing client capabilities flags. max_allowed_packet: Maximum packet size. Returns: ssl_request_payload: Payload used to carry out SSL authentication. References: [1]: https://dev.mysql.com/doc/dev/mysql-server/latest/ page_protocol_basic_character_set.html#a_protocol_character_set N)r1r3r4zBuilding SSL contextcacertkey verify_certFverify_identity tls_versionstls_ciphersuites)ssl_cassl_certssl_keyssl_verify_certssl_verify_identityr;tls_cipher_suiteszSwitching to SSLzSSL has been enabledT) r make_auth_sslsendr debugbuild_ssl_contextget switch_to_sslr) r#r,r-r/r1r3r4ssl_request_payload ssl_contextr$r$r% setup_sslYs.      zMySQLAuthenticator.setup_sslNrnew_strategy_namestrategy_class Optional[str]usernamepassword_factorcCsP|dur|j}|dur|j}td|t||d||j|d|jd|_dS)aSwitches the authorization plugin. Args: new_strategy_name: New authorization plugin name to switch to. strategy_class: New authorization plugin class to switch to (has higher precedence than the authorization plugin name). username: Username to be used - if not defined, the username provided when `authentication()` was invoked is used. password_factor: Up to three levels of authentication (MFA) are allowed, hence you can choose the password corresponding to the 1st, 2nd, or 3rd factor - 1st is the default. NzSwitching to strategy %s) plugin_nameauth_plugin_classr)r)) rr!r rEr rrGr)r )r#rLrMrOrPr$r$r%_switch_auth_strategys   z(MySQLAuthenticator._switch_auth_strategypktOptional[bytes]cCsd}|dtkrl||jvrtdt|\}}|j||dtd||jj |jj ||fi|j }|dt krKt |}|jj||fi|j }|dtkrXtd|S|dtkrbt||d7}|dtkstdd S) a Handles MFA (Multi-Factor Authentication) response. Up to three levels of authentication (MFA) are allowed. Args: sock: Pointer to the socket connection. pkt: MFA response. Returns: ok_packet: If last server's response is an OK packet. None: If last server's response isn't an OK packet and no ERROR was raised. Raises: InterfaceError: If got an invalid N factor. errors.ErrorTypes: If got an ERROR response. z5Failed Multi Factor Authentication (invalid N factor))rPzMFA %i factor %szMFA completed succesfullyrz"MFA terminated with a no ok packetN)rrrrparse_auth_next_factorrSr rEr nameauth_switch_responserrparse_auth_more_dataauth_more_responserrr warning)r#r,rTn_factorrL auth_datar$r$r% _mfa_n_factors<        z MySQLAuthenticator._mfa_n_factorcCs|dtkrt|dkrtd|dtkr3tdt|\}}|||jj ||fi|j }|dt krOtdt |}|jj ||fi|j }|dtkr_td|jj|S|dtkrxtdtd|jj|||S|dtkrt|d S) aHandles server's response. Args: sock: Pointer to the socket connection. pkt: Server's response after completing the `HandShakeResponse`. Returns: ok_packet: If last server's response is an OK packet. None: If last server's response isn't an OK packet and no ERROR was raised. Raises: errors.ErrorTypes: If got an ERROR response. NotSupportedError: If got Authentication with old (insecure) passwords. rWzAuthentication with old (insecure) passwords is not supported. For more information, lookup Password Hashing in the latest MySQL manualz+Server's response is an auth switch requestzExchanging further packetsz%s completed succesfullyz$Starting multi-factor authenticationzMFA 1 factor %sN)rlenr r rErparse_auth_switch_requestrSr rZrrr[r\rrYrr`rr )r#r,rTrLr_r$r$r%_handle_server_responses>           z*MySQLAuthenticator._handle_server_responserF handshaker password1 password2 password3database auth_pluginrR conn_attrsOptional[Dict[str, str]]is_change_user_requestr+rcKs||_|||d|_t||_| |_tj|||||| | | | | ||j|j d \}|_ |r.dnd}|j |g|Rt | }|||}|durNtdd|S)aPerforms the authentication phase. During re-authentication you must set `is_change_user_request` to True. Args: sock: Pointer to the socket connection. handshake: Initial handshake. username: Account's username. password1: Account's password factor 1. password2: Account's password factor 2. password3: Account's password factor 3. database: Initial database name for the connection. charset: Client charset (see [1]), only the lower 8-bits. client_flags: Integer representing client capabilities flags. max_allowed_packet: Maximum packet size. auth_plugin: Authorization plugin name. auth_plugin_class: Authorization plugin class (has higher precedence than the authorization plugin name). conn_attrs: Connection attributes. is_change_user_request: Whether is a `change user request` operation or not. plugin_config: Custom configuration to be passed to the auth plugin when invoked. The parameters defined here will override the ones defined in the auth plugin itself. Returns: ok_packet: OK packet. Raises: InterfaceError: If OK packet is NULL. References: [1]: https://dev.mysql.com/doc/dev/mysql-server/latest/ page_protocol_basic_character_set.html#a_protocol_character_set )rrV) rerOpasswordrir1r3r4rjrRrkrmr)r+)rr)NNNzGot a NULL ok_pkt)rrcopydeepcopyrr!r make_authr)r+r rDr5recvrdr)r#r,rerOrfrgrhrir1r3r4rjrRrkrmr+response_payload send_argsrTok_pktr$r$r% authenticate!s45     zMySQLAuthenticator.authenticate)rr)rr')rr*)r,rr-r.r/r0r1r2r3r2r4r2rr5)NNr) rLr.rMrNrOrNrPr2rr)r,rrTr5rrU) r,rrerrOr.rfr.rgr.rhr.rirNr1r2r3r2r4r2rjrNrRrNrkrlrmr'r+rrr5)__name__ __module__ __qualname____doc__r&propertyr)r+rrrKrSr`rdrwr$r$r$r%r7s<    < " 6;r)r{ __future__rrptypingrrrrerrorsrr r r pluginsr r protocolrrrrrrrrtypesrnetworkrrr$r$r$r%s  (