GlideCertificateEncryption - Global

APIs available for encrypting certificates.

Use these methods to generate a hash for the certificate, sign data using a private key, and generate a message authentication code.

GlideCertificateEncryption - generateMac(String key, String algorithm, String data)

Generates the Message Authentication Code (MAC), which is used to authenticate a message.

Table 1. Parameters
Name Type Description
key String Key used to sign the message.
algorithm String Algorithm used to generate the MAC: HmacSHA256, HmacSHA1, HmacMD5, and so on.
data String The data to be processed.
Table 2. Returns
Type Description
String MAC in base64 format.

Scoped equivalent

To use the generateMac() method in a scoped application, use the corresponding scoped method: CertificateEncryption - generateMac(String key, String algorithm, String data).

var mac = new GlideCertificateEncryption;
mac.generateMac("sample_key", "HmacSHA256", "sample_data");

GlideCertificateEncryption - getThumbPrint(String certificateID, String algorithm)

Generates a hash (SHA-1, SHA-256, and so on) for the certificate from Trust Store Cert.

Table 3. Parameters
Name Type Description
certificateID String sys_id of the certificate record in the X.509 Certificate [sys_certificate] table.
algorithm String SHA-1, SHA-256, and so on
Table 4. Returns
Type Description
String Thumbprint in base64 format.

Scoped equivalent

To use the getThumbPrint() method in a scoped application, use the corresponding scoped method: CertificateEncryption - getThumbPrint(String certificateID, String algorithm).

GlideCertificateEncryption - getThumbPrintFromKeystore(String certificateID, String alias, String algorithm)

Generates a hash (SHA-1, SHA-256, and so on) for the certificate from the key store entry.

Table 5. Parameters
Name Type Description
certificateID String sys_id of the certificate record in the X.509 Certificate [sys_certificate] table.
alias String Alias name for the certificate.
algorithm String SHA-1, SHA-256, and so on.
Table 6. Returns
Type Description
String Thumbprint in base64 format.

Scoped equivalent

To use the getThumbPrintFromKeystore() method in a scoped application, use the corresponding scoped method: CertificateEncryption - getThumbPrintFromKeystore(String certificateID, String alias, String algorithm).

GlideCertificateEncryption - GlideCertificateEncryption()

Instantiates a GlideCertificateEncryption object.

Table 7. Parameters
Name Type Description
None

Scoped equivalent

To use the GlideCertificateEncryption() constructor in a scoped application, use the corresponding scoped constructor: CertificateEncryption - CertificateEncryption().

GlideCertificateEncryption - sign(String certificateID, String alias, String aliaspassword, String algorithm, String datatosign)

Signs the data using the private key and the given algorithm.

Table 8. Parameters
Name Type Description
certificateID String sys_id of the certificate record in the X.509 Certificate [sys_certificate] table.
alias String Private key name.
aliaspassword String Password for the private key.
datatosign String Data to sign.
algorithm String SHA-1, SHA-256, and so on.
Table 9. Returns
Type Description
String Signed data in base64 format.

Scoped equivalent

To use the sign() method in a scoped application, use the corresponding scoped method: CertificateEncryption - sign(String certificateID, String alias, String aliaspassword, String algorithm, String datatosign).

var gce = new GlideCertificateEncryption;
gce.sign("recordID", "alias", "password", "SHA-1", "sign this data");