File: //usr/lib/python3/dist-packages/twisted/words/protocols/jabber/__pycache__/sasl.cpython-310.pyc
o
�b� � @ s� d Z ddlZddlmZmZ ddlmZ ddlmZm Z ddl
m Z dZ dd � Z
G d
d � d e�ZG d d
� d
e�ZG dd� de�ZG dd� de�Ze�d�Zdd� ZG dd� de j�ZdS )z
XMPP-specific SASL profile.
� N)� b64decode� b64encode)�defer)�sasl_mechanisms� xmlstream)�domishz urn:ietf:params:xml:ns:xmpp-saslc C s8 g }| j tdf �� D ]}|jdkr|�t|�� q |S )zJ
Parse the SASL feature to extract the available mechanism names.
�
mechanisms� mechanism)�features� NS_XMPP_SASL�elements�name�append�str)�xsr �element� r �E/usr/lib/python3/dist-packages/twisted/words/protocols/jabber/sasl.py�get_mechanisms s
�r c @ � e Zd ZdZdS )� SASLErrorz
SASL base exception.
N��__name__�
__module__� __qualname__�__doc__r r r r r � r c @ r )�SASLNoAcceptableMechanismzB
The server did not present an acceptable SASL mechanism.
Nr r r r r r % r r c @ s( e Zd ZdZddd�Zdefdd�ZdS ) �
SASLAuthErrorz%
SASL Authentication failed.
Nc C s
|| _ d S �N�� condition)�selfr! r r r �__init__0 �
zSASLAuthError.__init__�returnc C s
d| j S )Nz SASLAuthError with condition %rr �r" r r r �__str__3 r$ zSASLAuthError.__str__r )r r r r r# r r' r r r r r + s
r c @ r )�SASLIncorrectEncodingErrora
SASL base64 encoding was incorrect.
RFC 3920 specifies that any characters not in the base64 alphabet
and padding characters present elsewhere than at the end of the string
MUST be rejected. See also L{fromBase64}.
This exception is raised whenever the encoded string does not adhere
to these additional restrictions or when the decoding itself fails.
The recommended behaviour for so-called receiving entities (like servers in
client-to-server connections, see RFC 3920 for terminology) is to fail the
SASL negotiation with a C{'incorrect-encoding'} condition. For initiating
entities, one should assume the receiving entity to be either buggy or
malevolent. The stream should be terminated and reconnecting is not
advised.
Nr r r r r r( 7 r r( z"^[0-9A-Za-z+/]*[0-9A-Za-z+/=]{,2}$c
C sD t �| �du r
t� �zt| �W S ty! } ztt|���d}~ww )a�
Decode base64 encoded string.
This helper performs regular decoding of a base64 encoded string, but also
rejects any characters that are not in the base64 alphabet and padding
occurring elsewhere from the last or last two characters, as specified in
section 14.9 of RFC 3920. This safeguards against various attack vectors
among which the creation of a covert channel that "leaks" information.
N)�
base64Pattern�matchr( r � Exceptionr )�s�er r r �
fromBase64N s
��r. c @ sX e Zd ZdZedfZdZdd� Zdd� Zddd �Z dd d �Z
d
d� Z dd� Z dd� Z
dS )�SASLInitiatingInitializera�
Stream initializer that performs SASL authentication.
The supported mechanisms by this initializer are C{DIGEST-MD5}, C{PLAIN}
and C{ANONYMOUS}. The C{ANONYMOUS} SASL mechanism is used when the JID, set
on the authenticator, does not have a localpart (username), requesting an
anonymous session where the username is generated by the server.
Otherwise, C{DIGEST-MD5} and C{PLAIN} are attempted, in that order.
r Nc C s� | j jj}| j jj}t| j �}|jdur8d|v r&t�d|jd|j|�| _ dS d|v r5t�
d|j|�| _ dS t � �d|v rCt� � | _ dS t � �)aP
Select and setup authentication mechanism.
Uses the authenticator's C{jid} and C{password} attribute for the
authentication credentials. If no supported SASL mechanisms are
advertized by the receiving party, a failing deferred is returned with
a L{SASLNoAcceptableMechanism} exception.
Nz
DIGEST-MD5�xmpp�PLAIN� ANONYMOUS)
r �
authenticator�jid�passwordr �userr � DigestMD5�hostr �Plainr � Anonymous)r" r4 r5 r r r r � setMechanismp s
�z&SASLInitiatingInitializer.setMechanismc C sX | � � t�� | _| j�d| j� | j�d| j� | j�d| j � | �
| j � � � | jS )z5
Start SASL authentication exchange.
�
/challenge�/success�/failure)
r; r �Deferred� _deferredr � addObserver� onChallenge�addOnetimeObserver� onSuccess� onFailure�sendAuthr �getInitialResponser& r r r �start� s
z SASLInitiatingInitializer.startc C sJ t �tdf�}| jj|d< |dur |�t|��d�pd� | j� |� dS )z�
Initiate authentication protocol exchange.
If an initial client response is given in C{data}, it will be
sent along.
@param data: initial client response.
@type data: C{str} or L{None}.
�authr N�ascii�=)
r �Elementr r r
�
addContentr �decoder �send)r" �datarI r r r rF � s
z"SASLInitiatingInitializer.sendAuth� c C s6 t �tdf�}|r|�t|��d�� | j�|� dS )zt
Send response to a challenge.
@param data: client response.
@type data: L{bytes}.
�responserJ N)r rL r rM r rN r rO )r" rP rR r r r � sendResponse� s z&SASLInitiatingInitializer.sendResponsec C sF zt t|��}W n ty | j�� Y dS w | �| j�|�� dS )z�
Parse challenge and send response from the mechanism.
@param element: the challenge protocol element.
@type element: L{domish.Element}.
N)r. r r( r@ �errbackrS r � getResponse)r" r � challenger r r rB � s �z%SASLInitiatingInitializer.onChallengec C sF | j �d| j� | j �d| j� | j �� | j �� | j�t j� dS )z�
Clean up observers, reset the XML stream and send a new header.
@param success: the success protocol element. For now unused, but
could hold additional data.
@type success: L{domish.Element}
r< r> N) r �removeObserverrB rE �reset�
sendHeaderr@ �callback�Reset)r" �successr r r rD � s
z#SASLInitiatingInitializer.onSuccessc C sZ | j �d| j� | j �d| j� z|�� j}W n ty" d}Y nw | j�t |�� dS )z�
Clean up observers, parse the failure and errback the deferred.
@param failure: the failure protocol element. Holds details on
the error condition.
@type failure: L{domish.Element}
r< r= N)
r rW rB rD �firstChildElementr
�AttributeErrorr@ rT r )r" �failurer! r r r rE � s �z#SASLInitiatingInitializer.onFailurer )rQ )r r r r r �featurer@ r; rH rF rS rB rD rE r r r r r/ b s
r/ )r �re�base64r r �twisted.internetr � twisted.words.protocols.jabberr r �twisted.words.xishr r r r+ r r r r( �compiler) r. � BaseFeatureInitiatingInitializerr/ r r r r �<module> s