CertificateEncryption - com escopo

A API CertificateEncryption fornece métodos para criptografar certificados em aplicações com escopo.

Use esses métodos para gerar um hash para o certificado, assinar dados usando uma chave privada e gerar um código de autenticação de mensagem.

CertificateEncryption - CertificateEncryption()

Instancia um objeto CertificateEncryption em uma aplicação com escopo.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

CertificateEncryption - generateMac (Chave de cadeia de caracteres, Algoritmo de cadeia de caracteres, Dados de cadeia de caracteres)

Gera o código de autenticação de mensagem (MAC), que é usado para autenticar uma mensagem.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Chave a ser usada para assinar a mensagem. Deve ser codificado em Base64.
algoritmo	Cadeia de caracteres	Algoritmo a ser usado para gerar o MAC: HmacSHA256, HmacSHA1, HmacMD5 e assim por diante.
dados	Cadeia de caracteres	Dados a serem processados.

Tabela 3. Retorna

Tipo	Descrição
Cadeia de caracteres	MAC no formato base64.

Este exemplo mostra como acessar um MAC usando sample_key como os dados e HmacSHA256 como o algoritmo.

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

CertificateEncryption - getThumbprint(cadeia de caracteres certificateID, algoritmo de cadeia de caracteres)

Gera um hash (SHA-1, SHA-256 e assim por diante) para o certificado de Trust Store Cert.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
ID do certificado	Cadeia de caracteres	Sys_id do registro do certificado na tabela Certificado X.509 [sys_certificate].
algoritmo	Cadeia de caracteres	Algoritmo a ser usado para criar o hash, como SHA-1, SHA-256 e assim por diante.

Tabela 5. Retorna

Tipo	Descrição
Cadeia de caracteres	Impressão digital no formato base64.

Este exemplo mostra como gerar a impressão digital (hash) para o certificado AzureAAD.

//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);
}

Saída:

V1X+aguDBTZVVbWMGTXxdzJLmaY=

CertificateEncryption - getThumbprintFromKeyStore (cadeia de caracteres certificateID, alias de cadeia de caracteres, algoritmo de cadeia de caracteres)

Gera um hash (SHA-1, SHA-256 e assim por diante) para o certificado a partir da entrada de armazenamento de chaves.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
ID do certificado	Cadeia de caracteres	Sys_id do registro do certificado na tabela Certificado X.509 [sys_certificate].
alias	Cadeia de caracteres	Nome do alias do certificado.
algoritmo	Cadeia de caracteres	Algoritmo a ser usado para criar o hash, como SHA-1, SHA-256 e assim por diante.

Tabela 7. Retorna

Tipo	Descrição
Cadeia de caracteres	Impressão digital no formato base64.

CertificateEncryption - sign(cadeia de caracteres certificateID, alias de cadeia de caracteres, alias de cadeia de caracterespassword, algoritmo de cadeia de caracteres, cadeia de caracteres datatosign)

Assina os dados usando a chave privada e o algoritmo especificado.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
ID do certificado	Cadeia de caracteres	sys_id do registro do certificado na tabela Certificado X.509 [sys_certificate].
alias	Cadeia de caracteres	Nome da chave privada.
aliassenha	Cadeia de caracteres	Senha da chave privada.
algoritmo	Cadeia de caracteres	Algoritmo a ser usado. Deve ser um dos seguintes valores: NONEcomRSA MD2comRSA MD5comRSA SHA1comRSA SHA224comRSA SHA256comRSA SHA384comRSA SHA512comRSA NONEcomDSA SHA1comDSA SHA224comDSA SHA256comDSA NONEcomECDSA SHA1comECDSA SHA224comECDSA SHA256comECDSA SHA384comECDSA SHA512comECDSA
dadosparaassinar	Cadeia de caracteres	Dados a serem assinados.

Tabela 9. Retorna

Tipo	Descrição
Cadeia de caracteres	Dados assinados no formato base64.

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