Package org.apache.commons.net.smtp

Class SMTPSClient

java.lang.Object
org.apache.commons.net.SocketClient
org.apache.commons.net.smtp.SMTP
org.apache.commons.net.smtp.SMTPClient
org.apache.commons.net.smtp.SMTPSClient
Direct Known Subclasses:
AuthenticatingSMTPClient
public class SMTPSClient extends SMTPClient
SMTP over SSL processing. Copied from FTPSClient.java and modified to suit SMTP. If implicit mode is selected (NOT the default), SSL/TLS negotiation starts right after the connection has been established. In explicit mode (the default), SSL/TLS negotiation starts when the user calls execTLS() and the server accepts the command. Implicit usage: 
 SMTPSClient c = new SMTPSClient(true);
 c.connect("127.0.0.1", 465);
Explicit usage: 
 SMTPSClient c = new SMTPSClient();
 c.connect("127.0.0.1", 25);
 if (c.execTLS()) {
     // Rest of the commands here
 }
Warning: the hostname is not verified against the certificate by default, use setHostnameVerifier(HostnameVerifier) or setEndpointCheckingEnabled(boolean) (on Java 1.7+) to enable verification.
Since:
3.0

  • Field Details

    • DEFAULT_PROTOCOL

      private static final String DEFAULT_PROTOCOL
      Default secure socket protocol name, like TLS
      See Also:

    • isImplicit

      private final boolean isImplicit
      The security mode. True - Implicit Mode / False - Explicit Mode.

    • protocol

      private final String protocol
      The secure socket protocol to be used, like SSL/TLS.

    • context

      private SSLContext context
      The context object.

    • suites

      private String[] suites
      The cipher suites. SSLSockets have a default set of these anyway, so no initialization required.

    • protocols

      private String[] protocols
      The protocol versions.

    • trustManager

      private TrustManager trustManager
      The TrustManager implementation, default null (i.e. use system managers).

    • keyManager

      private KeyManager keyManager
      The KeyManager, default null (i.e. use system managers).

    • hostnameVerifier

      private HostnameVerifier hostnameVerifier
      The HostnameVerifier to use post-TLS, default null (i.e. no verification).

    • tlsEndpointChecking

      private boolean tlsEndpointChecking
      Use Java 1.7+ HTTPS Endpoint Identification Algorithm.

  • Constructor Details

    • SMTPSClient

      public SMTPSClient()
      Constructor for SMTPSClient, using DEFAULT_PROTOCOL i.e. TLS Sets security mode to explicit (isImplicit = false).

    • SMTPSClient

      public SMTPSClient(boolean implicit)
      Constructor for SMTPSClient, using DEFAULT_PROTOCOL i.e. TLS
      Parameters:
      implicit - The security mode, true for implicit, false for explicit

    • SMTPSClient

      public SMTPSClient(boolean implicit, SSLContext ctx)
      Constructor for SMTPSClient, using DEFAULT_PROTOCOL i.e. TLS
      Parameters:
      implicit - The security mode, true for implicit, false for explicit
      ctx - A pre-configured SSL Context.

    • SMTPSClient

      public SMTPSClient(SSLContext context)
      Constructor for SMTPSClient.
      Parameters:
      context - A pre-configured SSL Context.
      See Also:

    • SMTPSClient

      public SMTPSClient(String proto)
      Constructor for SMTPSClient, using explicit security mode.
      Parameters:
      proto - the protocol.

    • SMTPSClient

      public SMTPSClient(String proto, boolean implicit)
      Constructor for SMTPSClient.
      Parameters:
      proto - the protocol.
      implicit - The security mode, true for implicit, false for explicit

    • SMTPSClient

      public SMTPSClient(String proto, boolean implicit, String encoding)
      Constructor for SMTPSClient.
      Parameters:
      proto - the protocol.
      implicit - The security mode, true for implicit, false for explicit
      encoding - the encoding
      Since:
      3.3

  • Method Details

    • _connectAction_

      protected void _connectAction_() throws IOException
      Because there are so many connect() methods, the _connectAction_() method is provided as a means of performing some action immediately after establishing a connection, rather than reimplementing all the connect() methods.
      Overrides:
      _connectAction_ in class SMTP
      Throws:
      IOException - If it is thrown by _connectAction_().
      See Also:

    • execTLS

      public boolean execTLS() throws IOException
      The TLS command execution.
      Returns:
      TRUE if the command and negotiation succeeded.
      Throws:
      IOException - If an I/O error occurs while sending the command or performing the negotiation.

    • getEnabledCipherSuites

      public String[] getEnabledCipherSuites()
      Returns the names of the cipher suites which could be enabled for use on this connection. When the underlying Socket is not an SSLSocket instance, returns null.
      Returns:
      An array of cipher suite names, or null.

    • getEnabledProtocols

      public String[] getEnabledProtocols()
      Returns the names of the protocol versions which are currently enabled for use on this connection. When the underlying Socket is not an SSLSocket instance, returns null.
      Returns:
      An array of protocols, or null.

    • getHostnameVerifier

      public HostnameVerifier getHostnameVerifier()
      Get the currently configured HostnameVerifier.
      Returns:
      A HostnameVerifier instance.
      Since:
      3.4

    • getKeyManager

      public KeyManager getKeyManager()
      Get the KeyManager instance.
      Returns:
      The current KeyManager instance.

    • getTrustManager

      public TrustManager getTrustManager()
      Get the currently configured TrustManager.
      Returns:
      A TrustManager instance.

    • initSSLContext

      private void initSSLContext() throws IOException
      Performs a lazy init of the SSL context.
      Throws:
      IOException - When could not initialize the SSL context.

    • isEndpointCheckingEnabled

      public boolean isEndpointCheckingEnabled()
      Return whether or not endpoint identification using the HTTPS algorithm on Java 1.7+ is enabled. The default behavior is for this to be disabled.
      Returns:
      True if enabled, false if not.
      Since:
      3.4

    • performSSLNegotiation

      private void performSSLNegotiation() throws IOException
      SSL/TLS negotiation. Acquires an SSL socket of a connection and carries out handshake processing.
      Throws:
      IOException - If server negotiation fails.

    • setEnabledCipherSuites

      public void setEnabledCipherSuites(String[] cipherSuites)
      Controls which particular cipher suites are enabled for use on this connection. Called before server negotiation.
      Parameters:
      cipherSuites - The cipher suites.

    • setEnabledProtocols

      public void setEnabledProtocols(String[] protocolVersions)
      Controls which particular protocol versions are enabled for use on this connection. I perform setting before a server negotiation.
      Parameters:
      protocolVersions - The protocol versions.

    • setEndpointCheckingEnabled

      public void setEndpointCheckingEnabled(boolean enable)
      Automatic endpoint identification checking using the HTTPS algorithm is supported on Java 1.7+. The default behavior is for this to be disabled.
      Parameters:
      enable - Enable automatic endpoint identification checking using the HTTPS algorithm on Java 1.7+.
      Since:
      3.4

    • setHostnameVerifier

      public void setHostnameVerifier(HostnameVerifier newHostnameVerifier)
      Override the default HostnameVerifier to use.
      Parameters:
      newHostnameVerifier - The HostnameVerifier implementation to set or null to disable.
      Since:
      3.4

    • setKeyManager

      public void setKeyManager(KeyManager newKeyManager)
      Set a KeyManager to use.
      Parameters:
      newKeyManager - The KeyManager implementation to set.
      See Also:

    • setTrustManager

      public void setTrustManager(TrustManager newTrustManager)
      Override the default TrustManager to use.
      Parameters:
      newTrustManager - The TrustManager implementation to set.
      See Also: