View Javadoc
1   /*
2    * Copyright (c) MuleSoft, Inc.  All rights reserved.  http://www.mulesoft.com
3    * The software in this package is published under the terms of the CPAL v1.0
4    * license, a copy of which has been included with this distribution in the
5    * LICENSE.txt file.
6    */
7   package org.mule.api.security;
8   
9   import java.io.IOException;
10  
11  /**
12   * Configure indirect trust stores.
13   * TLS/SSL connections are made to trusted systems - the public certificates of trusted systems are store in 
14   * a keystore (called a trust store) and used to verify that the connection made to a remote system "really
15   * is" the expected identity.
16   * 
17   * <p>The information specified in this interface may be used to configure a trust store directly, as
18   * part of {@link TlsDirectKeyStore}, or it may be stored as property values and used later, or both.  
19   * It may therefore be specific to a single
20   * connector, or global to all connectors made by that protocol, or even (in the case of the SSL transport)
21   * become a global default value.  For more information see the documentation for the connector or protocol in
22   * question.  The comments in {@link org.mule.api.security.tls.TlsConfiguration} may also be useful.</p>
23   */
24  public interface TlsIndirectTrustStore
25  {
26  
27      /**
28       * @return The location (resolved relative to the current classpath and file system, if possible)
29       * of the keystore that contains public certificates of trusted servers.
30       */
31      String getTrustStore();
32  
33      /**
34       * @param name The location of the keystore that contains public certificates of trusted servers.
35       * @throws IOException If the location cannot be resolved via the file system or classpath
36       */
37      void setTrustStore(String name) throws IOException;
38  
39      /**
40       * @return The password used to protected the trust store defined in {@link #getTrustStore()}
41       */
42      String getTrustStorePassword();
43  
44      /**
45       * @param trustStorePassword The password used to protected the trust store defined in 
46       * {@link #setTrustStore(String)}
47       */
48      void setTrustStorePassword(String trustStorePassword);
49  
50  }
51  
52