---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CertificateEncryption - com escopo

# CertificateEncryption - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

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() {#ariaid-title2}

Instancia um objeto CertificateEncryption em uma aplicação com escopo.
{#r-SCE-CE__table_e1m_npx_vz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#r-SCE-CE__table_e1m_npx_vz}

## CertificateEncryption - generateMac (Chave de cadeia de caracteres, Algoritmo de cadeia de caracteres, Dados de cadeia de caracteres) {#ariaid-title3}

Gera o código de autenticação de mensagem (MAC), que é usado para autenticar uma mensagem.
{#r_SCE-generateMac_S_S_S__table_nm3_gcc_ks__entry__3}

| 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 2. Parâmetros]

{#r_SCE-generateMac_S_S_S__table_nm3_gcc_ks} {#r_SCE-generateMac_S_S_S__table_om3_gcc_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | MAC no formato base64. |
[Tabela 3. Retorna]

{#r_SCE-generateMac_S_S_S__table_om3_gcc_ks}  
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) {#ariaid-title4}

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

| 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 4. Parâmetros]

{#r_SCE-getThumbPrint_S_S__table_edb_rmv_js} {#r_SCE-getThumbPrint_S_S__table_fdb_rmv_js__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Impressão digital no formato base64. |
[Tabela 5. Retorna]

{#r_SCE-getThumbPrint_S_S__table_fdb_rmv_js}  
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) {#ariaid-title5}

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

| 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 6. Parâmetros]

{#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_edb_rmv_js} {#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_fdb_rmv_js__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Impressão digital no formato base64. |
[Tabela 7. Retorna]

{#r_SCE-getThumbPrintFromKeyStore_S_S_S__table_fdb_rmv_js}

## 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) {#ariaid-title6}

Assina os dados usando a chave privada e o algoritmo especificado.
{#r_SCE-sign_certificateID_S_S_S_S__table_edb_rmv_js__entry__3}

| 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 {#r_SCE-sign_certificateID_S_S_S_S__ul_pr3_nvv_pkb} |
| dadosparaassinar | Cadeia de caracteres | Dados a serem assinados. |
[Tabela 8. Parâmetros]

{#r_SCE-sign_certificateID_S_S_S_S__table_edb_rmv_js} {#r_SCE-sign_certificateID_S_S_S_S__table_r3m_jcb_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Dados assinados no formato base64. |
[Tabela 9. Retorna]

{#r_SCE-sign_certificateID_S_S_S_S__table_r3m_jcb_ks}  

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