CertificateEncryption : Bereichsbezogen

Die CertificateEncryption- API bietet Methoden zum Verschlüsseln von Zertifikaten in bereichsbezogenen Anwendungen.

Verwenden Sie diese Methoden, um einen Hash für das Zertifikat zu generieren, Daten mit einem privaten Schlüssel zu signieren und einen Nachrichtenauthentifizierungscode zu generieren.

CertificateEncryption – CertificateEncryption()

Instantiiert ein CertificateEncryption-Objekt in einer bereichsbezogenen Anwendung.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

CertificateEncryption – generateMac(String key, String algorithm, String data)

Erzeugt den Message Authentication Code (MAC), mit dem eine Nachricht authentifiziert wird.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Schlüssel zum Signieren der Nachricht. Muss Base64-codiert sein.
Algorithmus	Zeichenfolge	Algorithmus für die MAC-Generierung: HmacSHA256, HmacSHA1, HmacMD5 usw.
Daten	Zeichenfolge	Zu verarbeitende Daten

Tabelle : 3. Rückgaben

Typ	Beschreibung
Zeichenfolge	MAC im base64-Format.

Dieses Beispiel zeigt die Verwendung eines MAC mit „sample_key“ als Daten und „HmacSHA256“ als Algorithmus.

var mac = new CertificateEncryption;
var key = "sample_key"; 
key = gs.base64Encode(key);
mac.generateMac(key, "HmacSHA256", "sample_data");

CertificateEncryption – getThumbPrint(String certificateID, String algorithm)

Erzeugt einen Hash (SHA-1, SHA-256 usw.) für das Zertifikat von Trust Store Cert.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
certificateID	Zeichenfolge	Sys_id des Zertifikatdatensatzes in der Tabelle „X.509-Zertifikat“ [sys_certificate].
Algorithmus	Zeichenfolge	Algorithmus, der zum Erstellen des Hashs verwendet wird, z. B. SHA-1, SHA-256 usw.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Zeichenfolge	Fingerabdruck im base64-Format.

In diesem Beispiel wird gezeigt, wie der Fingerabdruck (Hash) für das AzureAAD-Zertifikat generiert wird.

//Create a GlideRecord to the certificate table
var x509GR = new GlideRecord('sys_certificate');

//If there is a certificate of a name of AzureAAD, get the certificate thumbprint
if(x509GR.get('name', 'AzureAAD')){

//Use the sys_id and algorithm we want to create a thumbprint
var thumbPrint = CertificateEncryption.getThumbPrint(x509GR.getUniqueValue(), "SHA-1");

//Print the created thumbprint
gs.print("Thumbprint for " + x509GR.getDisplayValue() + " is " + thumbPrint);
}

Ausgabe:

V1X+aguDBTZVVbWMGTXxdzJLmaY=

CertificateEncryption - getThumbprintFromKeyStore(String CertificateID, Zeichenfolgenalias, Zeichenfolgenalgorithmus)

Erzeugt einen Hash (SHA-1, SHA-256 usw.) für das Zertifikat aus dem Keystore-Eintrag.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
certificateID	Zeichenfolge	Sys_id des Zertifikatdatensatzes in der Tabelle „X.509-Zertifikat“ [sys_certificate].
alias	Zeichenfolge	Aliasname für das Zertifikat.
algorithm	Zeichenfolge	Algorithmus, der zum Erstellen des Hashs verwendet wird, z. B. SHA-1, SHA-256 usw.

Tabelle : 7. Rückgaben

Typ	Beschreibung
Zeichenfolge	Fingerabdruck im base64-Format.

CertificateEncryption – sign(String certificateID, String alias, String aliaspassword, String algorithm, String datatosign)

Signiert die Daten mit dem privaten Schlüssel und dem angegebenen Algorithmus.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
certificateID	Zeichenfolge	sys_id des Zertifikatdatensatzes in der Tabelle „X.509-Zertifikat“ [sys_certificate].
alias	Zeichenfolge	Privater Schlüsselname.
aliaspassword	Zeichenfolge	Passwort für den privaten Schlüssel.
Algorithmus	Zeichenfolge	Zu verwendender Algorithmus. Muss einer der folgenden Werte sein: KEINERmitRSA MD2withRSA MD5withRSA SHA1mitRSA SHA224mitRSA SHA256mitRSA SHA384mitRSA SHA512mitRSA KEINEmit DSA SHA1mitDSA SHA224mitDSA SHA256mitDSA KEINEmitECDSA SHA1mitECDSA SHA224mitECDSA SHA256mitECDSA SHA384mitECDSA SHA512mitECDSA
datatosign	Zeichenfolge	Daten, die signiert werden sollen.

Tabelle : 9. Rückgaben

Typ	Beschreibung
Zeichenfolge	Signierte Daten im base64-Format.

var ce = new CertificateEncryption;
ce.sign("recordID", "alias", "password", "SHA1withRSA", "sign this data");