Package org.hyperledger.fabric.gateway

Class Identities

java.lang.Object

org.hyperledger.fabric.gateway.Identities

public final class Identities
extends Object

This class consists exclusively of static methods used to create and operate on identity information.

Method Summary

Modifier and Type	Method	Description
static X509Identity	newX509Identity(String mspId, X509Certificate certificate, PrivateKey privateKey)	Create a new identity using X.509 credentials.
static X509Identity	newX509Identity(String mspId, org.hyperledger.fabric.sdk.Enrollment enrollment)	Create a new X.509 identity from an enrollment returned from a Certificate Authority.
static PrivateKey	readPrivateKey(Reader pemReader)	Read a PEM format private key.
static PrivateKey	readPrivateKey(String pem)	Read a PEM format private key.
static X509Certificate	readX509Certificate(Reader pemReader)	Read a PEM format X.509 certificate.
static X509Certificate	readX509Certificate(String pem)	Read a PEM format X.509 certificate.
static String	toPemString(Certificate certificate)	Converts the argument to a PEM format string.
static String	toPemString(PrivateKey privateKey)	Converts the argument to a PKCS #8 PEM format string.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

newX509Identity

public static X509Identity newX509Identity(String mspId,
 X509Certificate certificate,
 PrivateKey privateKey)

Create a new identity using X.509 credentials.

Parameters:

mspId - Member Services Provider identifier for the organization to which this identity belongs.

certificate - An X.509 certificate.

privateKey - Private key.

Returns:

An identity.

Throws:

NullPointerException - if any of the arguments are null.

newX509Identity

public static X509Identity newX509Identity(String mspId,
 org.hyperledger.fabric.sdk.Enrollment enrollment)
                                    throws CertificateException

Create a new X.509 identity from an enrollment returned from a Certificate Authority.

Parameters:

mspId - Member Services Provider identifier.

enrollment - Identity credentials.

Returns:

An identity.

Throws:

CertificateException - if the certificate is invalid.

NullPointerException - if any of the arguments are null.

readX509Certificate

public static X509Certificate readX509Certificate(String pem)
                                           throws CertificateException

Read a PEM format X.509 certificate.

Parameters:

pem - PEM data.

Returns:

An X.509 certificate.

Throws:

CertificateException - if the data is not valid X.509 certificate PEM.

readX509Certificate

public static X509Certificate readX509Certificate(Reader pemReader)
                                           throws IOException,
CertificateException

Read a PEM format X.509 certificate.

Parameters:

pemReader - Reader of PEM data.

Returns:

An X.509 certificate.

Throws:

IOException - if an error occurs reading data.

CertificateException - if the data is not valid X.509 certificate PEM.

readPrivateKey

public static PrivateKey readPrivateKey(String pem)
                                 throws InvalidKeyException

Read a PEM format private key.

Parameters:

pem - PEM data.

Returns:

An X.509 certificate.

Throws:

InvalidKeyException - if the data is not valid private key PEM.

readPrivateKey

public static PrivateKey readPrivateKey(Reader pemReader)
                                 throws IOException,
InvalidKeyException

Read a PEM format private key.

Parameters:

pemReader - Reader of PEM data.

Returns:

A private key.

Throws:

IOException - if an error occurs reading data.

InvalidKeyException - if the data is not valid private key PEM.

toPemString

public static String toPemString(Certificate certificate)

Converts the argument to a PEM format string.

Parameters:

certificate - A certificate.

Returns:

A PEM format string.

toPemString

public static String toPemString(PrivateKey privateKey)

Converts the argument to a PKCS #8 PEM format string.

Parameters:

privateKey - A private key.

Returns:

A PEM format string.

Throws:

IllegalArgumentException - if the argument can not be represented in PKCS #8 PEM format.