/*******************************************************************************
 *******************************************************************************/
package at.gv.egiz.eaaf.core.api.idp;

import java.io.Serializable;
import java.util.List;
import java.util.Map;

import at.gv.egiz.eaaf.core.api.data.EAAFConstants;

public interface ISPConfiguration extends Serializable {

	public static final String CONFIG_KEY_RESTRICTIONS_BASEID_INTERNAL = "configuration.restrictions.baseID.idpProcessing";
	public static final String CONFIG_KEY_RESTRICTIONS_BASEID_TRANSMISSION = "configuration.restrictions.baseID.spTransmission";
	
	/**
	 * Get the full key/value configuration for this Service Provider
	 * 
	 * @return an unmodifiable map of key/value pairs
	 */
	public Map<String, String> getFullConfiguration();
	
	  /**
	   * Get a configuration value from Service Provider key/value configuration
	   * 
	   * @param key The key identifier of a configuration value 
	   * @return The configuration value {String} or null if the key does not exist
	   */  
	public String getConfigurationValue(String key);

	  /**
	   * Get a configuration value from Service Provider key/value configuration
	   * 
	   * @param key The key identifier of a configuration value 
	   * @param defaultValue Default value if key does not exist
	   * @return The configuration value {String} or defaultValue if the key does not exist
	   */  
	public String getConfigurationValue(String key, String defaultValue);
	
	/**
	 * Get a boolean configuration value from Service Provider key/value configuration
	 * 
	 * @param key The key identifier of a configuration value 
	 * @return true / false, or null if the key does not exist
	 */
	public Boolean isConfigurationValue(String key);
	
	
	/**
	 * Get a boolean configuration value from Service Provider key/value configuration
	 * 
	 * @param key The key identifier of a configuration value 
	 * @param defaultValue Default value if key does not exist
	 * @return true / false, or defaultValue if the key does not exist
	 */
	public boolean isConfigurationValue(String key, boolean defaultValue);
	
	/**
	 * Check if a configuration key is available in this Service Provider configuration 
	 * 
	 * @param key The key identifier of a configuration value
	 * @return true if the configuration key exists, otherwise false
	 */
	boolean containsConfigurationKey(String key);
	
	/**
	 * Return the unique identifier of this Service Provider
	 * 
	 * @return
	 */
	public String getUniqueIdentifier();
	
	/**
	 * Return the unique identifier of this Service Provider
	 * 
	 * @return
	 */
	public String getFriendlyName();
	
	/**
	 * Indicates if this service provider has private area restrictions that disallow baseId processing in general
	 * 	 * 
	 * @return true if there is a restriction, otherwise false
	 */
	public boolean hasBaseIdInternalProcessingRestriction();
	
	
	/**
	 * Indicates if this service provider has private area restrictions that disallow baseId transfer to SP
	 *  
	 * @return true if there is a restriction, otherwise false
	 */
	public boolean hasBaseIdTransferRestriction();
	
	/**
	 * Get the {@link List} of identifier's that indicates no baseID processing restriction exists.<br>  
	 * This list can be configured by key: "configuration.restrictions.baseID.idpProcessing"
	 * 
	 * @return
	 */
	public List<String> getTargetsWithNoBaseIdInternalProcessingRestriction();
	
	/**
	 * Get the {@link List} of identifier's that indicates no baseID transfer restriction exists.<br>  
	 * This list can be configured by key: "configuration.restrictions.baseID.spTransmission"
	 * 
	 * @return
	 */
	public List<String> getTargetsWithNoBaseIdTransferRestriction();
	
	/**
	 * Get the minimum eIDAS LoA that is required by this service provider
	 * 
	 * {@link EAAFConstants.EIDAS_QAA_LOW}
	 * {@link EAAFConstants.EIDAS_QAA_SUBSTANTIAL}
	 * {@link EAAFConstants.EIDAS_QAA_HIGH}
	 * 
	 * @return return eIDAS LoA
	 */
	public String getMinimumLevelOfAssurence();
	
	/**
	 * Get the full area-identifier for this service provider to calculate the 
	 * area-specific unique person identifier (bPK, wbPK, eIDAS unique identifier, ...). 
	 * This identifier always contains the full prefix 
	 * 
	 * @return area identifier with prefix  
	 */
	public String getAreaSpecificTargetIdentifier();

}