package at.knowcenter.wag.egov.egiz.sig;

import at.knowcenter.wag.egov.egiz.ldap.api.LDAPAPIException;
import at.knowcenter.wag.egov.egiz.ldap.client.LDAPIssuerNameFilter;

/**
 * @author <a href="mailto:thomas.knall@iaik.tugraz.at">Thomas Knall</a>
 */
public interface LDAPAPI {

	public static final String SYS_PROP_IMPLEMENTATION = "pdfas.ldapapi.impl";
	
	/**
	 * Returns the url of the ldap server.
	 * @param issuer The issuer name.
	 * @return The ldap url.
	 */
	public String getURL(String issuer);

	/**
	 * Retrieves an certificate from the ldap server identified by serial number and issuer name. 
	 * @param serialNumber The serial number.
	 * @param issuer The issuer name.
	 * @return BASE64 encoded certificate
	 */
	public byte[] loadBase64CertificateFromLDAP(String serialNumber, String issuer);
	
	/**
	 * Sets the filter that has to be applied before trying to match the issuer name.
	 * @param filter The filter.
	 */
	public void setIssuerNameFilter(LDAPIssuerNameFilter filter) throws LDAPAPIException;

}