U  W[d1@sdZddlmZmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z dd lmZmZdd lmZdd lmZdd lmZeejGd ddZGdddeZGdddeZGdddejZGdddeZGdddejZGdddejZdS)z Mail protocol support. )absolute_importdivision)pop3)smtp)protocol)defer) longversion)log)CramMD5CredentialsUsernamePassword)UnauthorizedLogin)relay) implementerc@s>eZdZdZdZdZejfddZddZ ddZ d d Z dS) DomainDeliveryBaseaN A base class for message delivery using the domains of a mail service. @ivar service: See L{__init__} @ivar user: See L{__init__} @ivar host: See L{__init__} @type protocolName: L{bytes} @ivar protocolName: The protocol being used to deliver the mail. Sub-classes should set this appropriately. NcCs||_||_||_dS)z @type service: L{MailService} @param service: A mail service. @type user: L{bytes} or L{None} @param user: The authenticated SMTP user. @type host: L{bytes} @param host: The hostname. N)serviceuserhost)selfrrrr8/usr/lib/python3/dist-packages/twisted/mail/protocols.py__init__+s zDomainDeliveryBase.__init__c Csd}}|jrd|jd}|dr2d|d}d|dd|dd ||}d |jd |jd td d}ddtt|dt }d|d|d|S)a Generate a received header string for a message. @type helo: 2-L{tuple} of (L{bytes}, L{bytes}) @param helo: The client's identity as sent in the HELO command and its IP address. @type origin: L{Address} @param origin: The origination address of the message. @type recipients: L{list} of L{User} @param recipients: The destination addresses for the message. @rtype: L{bytes} @return: A received header string. s auth=Zxtextrs helo=sfrom s ([]sby s with s (ascii)sfor < s> s Received: s ) rencoder protocolNamerjoinmapbytesrZ rfc822date) rhelooriginZ recipientsZauthStrZheloStrZfromUserZbyZforUserrrrreceivedHeader;s2 z!DomainDeliveryBase.receivedHeadercCsX|jr:|jjr:|jj|jjd}|dkrJt|jd}n|jj|jj}t |j |S)a9 Validate the address for which a message is destined. @type user: L{User} @param user: The destination address. @rtype: L{Deferred } which successfully fires with no-argument callable which returns L{IMessage } provider. @return: A deferred which successfully fires with a no-argument callable which returns a message receiver for the destination. @raise SMTPBadRcpt: When messages cannot be accepted for the destination address. NT) rrZqueuedomainsgetdestdomainr Z DomainQueuerrZ maybeDeferredexists)rrdrrr validateTo[s zDomainDeliveryBase.validateTocCs8|st|dd|jdkr4|jdkr4t|dd|S)a Validate the address from which a message originates. @type helo: 2-L{tuple} of (L{bytes}, L{bytes}) @param helo: The client's identity as sent in the HELO command and its IP address. @type origin: L{Address} @param origin: The origination address of the message. @rtype: L{Address} @return: The origination address. @raise SMTPBadSender: When messages cannot be accepted from the origination address. izWho are you? Say HELO first.riz#Sender address must contain domain.)rZ SMTPBadSenderZlocalr()rr"r#rrr validateFromuszDomainDeliveryBase.validateFrom) __name__ __module__ __qualname____doc__rrrZDNSNAMErr$r+r,rrrrrs  rc@seZdZdZdZdS)SMTPDomainDeliveryzA A domain delivery base class for use in an SMTP server. ssmtpNr-r.r/r0rrrrrr1sr1c@seZdZdZdZdS)ESMTPDomainDeliveryzB A domain delivery base class for use in an ESMTP server. sesmtpNr2rrrrr3sr3c@s,eZdZdZejZdZdddZddZ dS) SMTPFactorya; An SMTP server protocol factory. @ivar service: See L{__init__} @ivar portal: See L{__init__} @type protocol: no-argument callable which returns a L{Protocol } subclass @ivar protocol: A callable which creates a protocol. The default value is L{SMTP}. NcCstj|||_||_dS)z @type service: L{MailService} @param service: An email service. @type portal: L{Portal } or L{None} @param portal: A portal to use for authentication. N)rr4rrportal)rrr5rrrrs zSMTPFactory.__init__cCs2td|ftj||}|j|_|j|_|S)a Create an instance of an SMTP server protocol. @type addr: L{IAddress } provider @param addr: The address of the SMTP client. @rtype: L{SMTP} @return: An SMTP protocol. zConnection from %s)r msgrr4 buildProtocolrr5rZaddrprrrr7s zSMTPFactory.buildProtocol)N) r-r.r/r0rZSMTPrr5rr7rrrrr4s   r4c@s*eZdZdZejZdZddZddZ dS) ESMTPFactorya An ESMTP server protocol factory. @type protocol: no-argument callable which returns a L{Protocol } subclass @ivar protocol: A callable which creates a protocol. The default value is L{ESMTP}. @type context: L{IOpenSSLContextFactory } or L{None} @ivar context: A factory to generate contexts to be used in negotiating encrypted communication. @type challengers: L{dict} mapping L{bytes} to no-argument callable which returns L{ICredentials } subclass provider. @ivar challengers: A mapping of acceptable authorization mechanism to callable which creates credentials to use for authentication. NcGstj|f|dti|_dS)zk @param args: Arguments for L{SMTPFactory.__init__} @see: L{SMTPFactory.__init__} sCRAM-MD5N)r4rr challengers)rargsrrrrszESMTPFactory.__init__cCs t||}|j|_|j|_|S)a Create an instance of an ESMTP server protocol. @type addr: L{IAddress } provider @param addr: The address of the ESMTP client. @rtype: L{ESMTP} @return: An ESMTP protocol. )r4r7r;contextZctxr8rrrr7s zESMTPFactory.buildProtocol) r-r.r/r0rZESMTPrr=rr7rrrrr:s  r:c@s0eZdZdZdZdZddZddZdd ZdS) VirtualPOP3a[ A virtual hosting POP3 server. @type service: L{MailService} @ivar service: The email service that created this server. This must be set by the service. @type domainSpecifier: L{bytes} @ivar domainSpecifier: The character to use to split an email address into local-part and domain. The default is '@'. N@cCs`||\}}z|j|}Wn tk r>ttYSX|t |j ||dtj SdS)a1 Perform APOP authentication. Override the default lookup scheme to allow virtual domains. @type user: L{bytes} @param user: The name of the user attempting to log in. @type digest: L{bytes} @param digest: The challenge response. @rtype: L{Deferred} which successfully results in 3-L{tuple} of (L{IMailbox }, L{IMailbox } provider, no-argument callable) @return: A deferred which fires when authentication is complete. If successful, it returns an L{IMailbox } interface, a mailbox and a logout function. If authentication fails, the deferred fails with an L{UnauthorizedLogin } error. N) lookupDomainr lookupPortalKeyErrorrfailr loginrZAPOPCredentialsmagicIMailbox)rrZdigestr(r5rrrauthenticateUserAPOPsz VirtualPOP3.authenticateUserAPOPcCsZ||\}}z|j|}Wn tk r>ttYSX|t||dt j SdS)aY Perform authentication for a username/password login. Override the default lookup scheme to allow virtual domains. @type user: L{bytes} @param user: The name of the user attempting to log in. @type password: L{bytes} @param password: The password to authenticate with. @rtype: L{Deferred} which successfully results in 3-L{tuple} of (L{IMailbox }, L{IMailbox } provider, no-argument callable) @return: A deferred which fires when authentication is complete. If successful, it returns an L{IMailbox } interface, a mailbox and a logout function. If authentication fails, the deferred fails with an L{UnauthorizedLogin } error. N) r@rrArBrrCr rDr rrF)rrZpasswordr(r5rrrauthenticateUserPASS7sz VirtualPOP3.authenticateUserPASScCsZz||jd\}}Wntk r.d}YnX||jjkrRtd|d||fS)a Check whether a domain is among the virtual domains supported by the mail service. @type user: L{bytes} @param user: An email address. @rtype: 2-L{tuple} of (L{bytes}, L{bytes}) @return: The local part and the domain part of the email address if the domain is supported. @raise POP3Error: When the domain is not supported by the mail service. rrzno such domain {}zutf-8) splitdomainSpecifier ValueErrorrr%rZ POP3Errorformatdecode)rrr(rrrr@Ys  zVirtualPOP3.lookupDomain) r-r.r/r0rrJrGrHr@rrrrr>s  ""r>c@s(eZdZdZeZdZddZddZdS) POP3Factorya A POP3 server protocol factory. @ivar service: See L{__init__} @type protocol: no-argument callable which returns a L{Protocol } subclass @ivar protocol: A callable which creates a protocol. The default value is L{VirtualPOP3}. NcCs ||_dS)zY @type service: L{MailService} @param service: An email service. N)r)rrrrrrszPOP3Factory.__init__cCstj||}|j|_|S)a Create an instance of a POP3 server protocol. @type addr: L{IAddress } provider @param addr: The address of the POP3 client. @rtype: L{POP3} @return: A POP3 protocol. )r ServerFactoryr7rr8rrrr7s zPOP3Factory.buildProtocol) r-r.r/r0r>rrrr7rrrrrNrs  rNN) r0Z __future__rrZ twisted.mailrrZtwisted.internetrrZtwisted.copyrightrZtwisted.pythonr Ztwisted.cred.credentialsr r Ztwisted.cred.errorr r Zzope.interfacerZIMessageDeliveryrr1r3r4r:ZPOP3r>rOrNrrrrs&         t/4o