KeyManagerFactory

KeyManagerFactory

javax.net.ssl

---

Java 1.4

A KeyManagerFactory is responsible for creating KeyManager objects for a specific key management algorithm. Obtain a KeyManagerFactory object by calling one of the getInstance( ) methods and specifying the desired algorithm and, optionally , the desired provider. In Java 1.4, the "SunX509" algorithm is the only one supported by the default "SunJSSE" provider. After calling getInstance( ) , you initialize the factory object with init( ) . For the "SunX509" algorithm, you always use the two-argument version of init( ) passing in a KeyStore object that contains the private keys and certificates required by X509KeyManager objects, and also specifying the password used to protect the private keys in that KeyStore . Once a KeyManagerFactory has been created and initialized , use it to create a KeyManager by calling getKeyManagers( ) . This method returns an array of KeyManager objects because some key management algorithms may handle more than one type of key. The "SunX509" algorithm manages only X509 keys, and always returns an array with an X509KeyManager object as its single element. This returned array is typically passed to the init( ) method of an SSLContext object.

If a KeyStore and password are not passed to the init( ) method of the KeyManagerFactory for the "SunX509" algorithm, then the factory uses attempts to read a KeyStore from the file specified by the javax.net.ssl.keyStore system property using the password specified by the javax.net.ssl.keyStorePassword . The type of the keystore is specified by javax.net.ssl.keyStoreType .

 public class  KeyManagerFactory  {  // Protected Constructors  protected  KeyManagerFactory  (KeyManagerFactorySpi  factorySpi  ,         java.security.Provider  provider  , String  algorithm  );  // Public Class Methods  public static final String  getDefaultAlgorithm  ( );        public static final KeyManagerFactory  getInstance  (String  algorithm  )          throws java.security.NoSuchAlgorithmException;        public static final KeyManagerFactory  getInstance  (String  algorithm  ,          java.security.Provider  provider  )          throws java.security.NoSuchAlgorithmException;        public static final KeyManagerFactory  getInstance  (String  algorithm  ,          String  provider  ) throws java.security.NoSuchAlgorithmException,          java.security.NoSuchProviderException;  // Public Instance Methods  public final String  getAlgorithm  ( );        public final KeyManager[ ]  getKeyManagers  ( );        public final java.security.Provider  getProvider  ( );        public final void  init  (ManagerFactoryParameters  spec  )          throws java.security.InvalidAlgorithmParameterException;        public final void  init  (java.security.KeyStore  ks  , char[ ]  password  )          throws java.security.KeyStoreException,          java.security.NoSuchAlgorithmException,          java.security.UnrecoverableKeyException;   }