Class CertificateCredential

  • All Implemented Interfaces:
    TokenCredential

    public final class CertificateCredential
    extends Credential
    implements TokenCredential
    Represents a digital certificate used to access certificate secured resources. Supports PKCS#12 cryptography archive bundle files. PKCS#12 is an archive file format for storing multiple cryptography objects. It can contain details about a private key, its certificate, and any associated CA certificates. The archive is usually identified by its .pfx or .p12 file extension. The archive itself or objects it contains may be encrypted and signed.
    Since:
    100.2.0
    • Constructor Detail

      • CertificateCredential

        public CertificateCredential​(String certificatePath,
                                     String certificatePassword)
        Instantiates a CertificateCredential.
        Parameters:
        certificatePath - the file path to a PKCS#12 file on disk
        certificatePassword - the password to access and decrypt the provided certificate file
        Throws:
        IllegalArgumentException - if the certificatePath is null or empty
        Since:
        100.2.0
    • Method Detail

      • getAlias

        public String getAlias()
        Gets the alias associated with the certificate.
        Returns:
        the alias associated with the certificate, null if none has been set
        Since:
        100.2.0
      • getPrivateKey

        public PrivateKey getPrivateKey()
        Gets the PrivateKey associated with the credential.
        Returns:
        the private key
        Since:
        100.4.0
      • getCertificateChain

        public Certificate[] getCertificateChain()
        Gets the certificate chain associated with the credential.
        Returns:
        the certificate chain
        Since:
        100.4.0
      • getPassword

        public String getPassword()
        Gets the password used to access the certificate file.
        Returns:
        the password
        Since:
        100.2.0
      • copy

        public CertificateCredential copy()
        Creates a copy of this CertificateCredential instance.
        Specified by:
        copy in class Credential
        Returns:
        a copy of this CertificateCredential instance
        Since:
        100.2.0
      • toJson

        public String toJson()
        CertificateCredential currently does not support JSON serialization. This method throws an UnsupportedOperationException.
        Overrides:
        toJson in class Credential
        Returns:
        a json String representation of this Credential
        Throws:
        UnsupportedOperationException
        Since:
        100.2.0