View Javadoc

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