org.glite.voms.contact
Class UserCredentials

java.lang.Object
  extended by org.glite.voms.contact.UserCredentials

public class UserCredentials
extends Object

This class implements parsing and handling of X509 user credentials in PEM or PKCS12 format.

Author:
Andrea Ceccanti, Vincenzo Ciaschini

Method Summary
 X509Certificate getUserCertificate()
          This method returs the user certificate loaded in this UserCredentials.
 X509Certificate[] getUserChain()
          This method returs the user certificate chain loaded in this UserCredentials.
 PrivateKey getUserKey()
          This method returs the user credential openssl private key.
static UserCredentials instance()
          Static instance constructor for a UserCredentials.
static UserCredentials instance(PrivateKey key, X509Certificate[] certs)
           
static UserCredentials instance(String keyPassword)
          Static instance constructor for a UserCredentials.
static UserCredentials instance(String userCertFile, String userKeyFile)
          Static instance constructor for a UserCredentials.
static UserCredentials instance(String userCertFile, String userKeyFile, String keyPassword)
          Static instance constructor for a UserCredentials.
static UserCredentials instance(UserCredentials credentials)
          Static instance constructor for a UserCredentials.
 void save(OutputStream os)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

save

public void save(OutputStream os)
          throws IOException
Throws:
IOException

getUserCertificate

public X509Certificate getUserCertificate()
This method returs the user certificate loaded in this UserCredentials.

Returns:
the X509 user certificate.

getUserChain

public X509Certificate[] getUserChain()
This method returs the user certificate chain loaded in this UserCredentials.

Returns:
the X509 user certificate.

getUserKey

public PrivateKey getUserKey()
This method returs the user credential openssl private key.

Returns:
the user credentials private key.

instance

public static UserCredentials instance()
Static instance constructor for a UserCredentials. This method should be used with credentials whose private key is not encrypted. The current implementation looks for user credentials in the following places (in sequence):

Returns:
the loaded user credentials.
Throws:
VOMSException - if there is an error loading the user credentials.

instance

public static UserCredentials instance(String keyPassword)
Static instance constructor for a UserCredentials. For more info on the user credentials load procedure, see instance().

Parameters:
keyPassword - the password that is to be used to decrypt the user private key.
Returns:
the loaded user credentials.
Throws:
VOMSException - if there is an error loading the user credentials.

instance

public static UserCredentials instance(String userCertFile,
                                       String userKeyFile,
                                       String keyPassword)
Static instance constructor for a UserCredentials. This methods allows a user to bypass the default credentials search procedure (highlighted here), by specifying the path to a PEM X509 user cert and private key.

Parameters:
userCertFile - the path to the PEM X509 user certificate.
userKeyFile - the path to the PEM X509 private key.
keyPassword - the password that is to be used to decrypt the user private key.
Returns:
the loaded user credentials.
Throws:
VOMSException - if there is an error loading the user credentials.

instance

public static UserCredentials instance(String userCertFile,
                                       String userKeyFile)
Static instance constructor for a UserCredentials. This methods allows a user to bypass the default credentials search procedure (highlighted here), by specifying the path to a PEM X509 user cert and private key.

Parameters:
userCertFile - the path to the PEM X509 user certificate.
userKeyFile - the path to the PEM X509 private key.
Returns:
the loaded user credentials.
Throws:
VOMSException - if there is an error loading the user credentials.

instance

public static UserCredentials instance(UserCredentials credentials)
Static instance constructor for a UserCredentials. This methods allows a user to bypass the default credentials search procedure (highlighted here), by specifying the path to a PEM X509 user cert and private key.

Parameters:
credentials - the GlobusCredentials object containing the user's own proxy
Returns:
the loaded user credentials.
Throws:
VOMSException - if there is an error loading the user credentials.

instance

public static UserCredentials instance(PrivateKey key,
                                       X509Certificate[] certs)


Copyright © 2013. All Rights Reserved.