---
sourceDocument: Segurança da plataforma Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-security

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Segurança da plataforma Yokohama

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Encapsule sua chave fornecida pelo cliente

# Encapsule sua chave fornecida pelo cliente {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Encapsule a chave simétrica a ser usada para criptografia com a chave pública baixada.

## Antes de Iniciar

Nota:  
Este procedimento descreve as opções que estão disponíveis com o sistema de base KMF e as opções a serem usadas com a funcionalidade Criptografia de campo Enterprise. A funcionalidade Criptografia de campo Enterprise estará disponível somente quando o plug-in com.glide.now.platform.encryption estiver ativo. Consulte [Ativação da Criptografia de campo](https://servicenow-prod.fluidtopics.net/zCk5nObvjXiZcI8lqUZeQw "Ative a Criptografia de campo Starter ou Criptografia de campo Enterprise") para obter mais informações sobre como obter Criptografia de campo Enterprise.

Algumas das etapas neste documento exigem o uso de uma ferramenta criptográfica instalada no seu dispositivo local. Os exemplos nesta tarefa usam a ferramenta OpenSSL. Para obter mais informações sobre essa ferramenta, consulte <https://www.openssl.org>. Se estiver usando outras ferramentas criptográficas, como LibreSSL ou GnuTLS, consulte a documentação desses produtos para obter etapas semelhantes.  
* Modifique as propriedades opcionais que controlam o tamanho, o algoritmo de preenchimento e o período de validade da chave. Consulte [Configurar propriedades de chaves fornecidas pelo cliente](https://servicenow-prod.fluidtopics.net/pQUGd21tRghyIe0oqAf5IQ "Se o plug-in Criptografia de campo Enterprise estiver habilitado, você poderá usar as propriedades do sistema para definir o preenchimento da chave, o tamanho do par de chaves efêmero e um período de validade para as chaves fornecidas pelo cliente.").
* Você deve ter sua chave simétrica (.BIN) para criptografia.

  Importante:  
  Sua chave deve estar no formato binário. Se outro formato for usado, será `exibida uma mensagem de erro informando. Anexe novamente o token não modificado.`que a validação do token falhou.
* Você deve ter uma ferramenta criptográfica para encapsular sua chave. Este exemplo usa o OpenSSL 1.1.

{#wrap-customer-supplied-key__ul_s43_zmk_snb}

Função necessária: sn_kmf.cryptographic_manager ou sn_kmf.admin

## Procedimento

1. Navegar até TudoEstrutura de gestão de chavesMódulos CriptográficosTudo.
2. Selecione o módulo criptográfico criado para a chave fornecida pelo cliente na lista relacionada Especificações de criptografia.
3. Você será direcionado para a etapa de Criação de chave.
4. Se ainda não tiver baixado a chave de encapsulamento, clique no link para baixar o arquivo token_publickey\<id\>.zip e salve-o no mesmo local de sua chave.  
   Nota:  
   Não renomeie o arquivo token_publickey\<id\> baixado.
5. Descompacte o arquivo em sua rede local.  
   O arquivo zip contém dois arquivos, um token de importação e um certificado `.PEM` de chave pública. Encapsule sua chave simétrica com a chave pública para criptografá-la.
6. Copie o nome do arquivo token_publickey para a área de transferência.
7. Em uma linha de comando, use o nome do arquivo token_publickey copiado para abrir a pasta dos arquivos descompactados como um espaço reservado para a chave encapsulada.
8. Edite este script substituindo os exemplos pelos nomes de seus arquivos de criptografia.  

       "downloads user.name$ cd `token_publickey_<token>`
       openssl pkeyutl -encrypt -pubin -inkey `publickey_<keyname>.PEM`
       -in `<keyname.bin>`
       -out wrapped_key_material -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha<128 or 256> "

   Revise os comandos de encapsulamento de chave na tabela a seguir para obter mais informações.  
   {#wrap-customer-supplied-key__table_azx_3yk_snb__entry__3}

   | Direções | Comando | Exemplo |
   |-|-|-|
   | Abra o diretório do arquivo no qual você baixou o token de encapsulamento. | cd | `cd token_publickey123456789` |
   | Cole o nome do certificado `publickey.PEM`. | openssl pkeyutl -encrypt -pubin -inkey | `publickey_586798643ffff.PEM` |
   | Cole o nome da sua chave aqui. | -in | `mykey.bin` |
   | Insira o comando \<-out\> e especifique se a chave é de 128 bits ou 256 bits. | -out wrapped_key_material -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 | N/D |
   [Tabela 1. Comandos de encapsulamento de chave]

   {#wrap-customer-supplied-key__table_azx_3yk_snb}
9. Execute o comando:  
   Uma mensagem do sistema exibe `token_publickey_<keynumber>`. A chave será gerada e um arquivo wrapped_key_material adicionado ao diretório.
10. Carregue a chave encapsulada.

## O que Fazer Depois

Retorne para [Configure e carregue a chave fornecida pelo cliente](https://servicenow-prod.fluidtopics.net/_FlndpQNlG8Eo6nwjyIxhA "Você pode usar sua própria chave fornecida pelo cliente em vez de usar as chaves geradas pelo sistema ServiceNow.") para carregar sua chave encapsulada.