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