--- 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 --- # Importação de uma chave do serviço web # Importação de uma chave do serviço web {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura Carregue com segurança uma chave de cliente externa em sua instância usando a importação de uma chave de um serviço web (por exemplo, a REST API chave). As chaves públicas simétricas e assimétricas podem ser importadas para um módulo criptográfico de destino do KMF. A chave a ser importada (a chave de destino) deve ser criptografada com uma chave de encapsulamento antes de ser carregada no módulo criptográfico de destino da instância. Essa chave de encapsulamento é o componente público de um par de chaves pública/privada, que precisa estar presente na instância. A chave é um pré-requisito antes que a chave de destino encapsulada possa ser carregada por meio de Importar de serviços da Web. Esses dois procedimentos separados (importar o par de chaves agrupadas e importar a chave de destino agrupada do serviço web) são detalhados na documentação abaixo. Esse par de chaves deve ser gerado e carregado para ficar disponível no módulo criptográfico de Importar chave interno da instância. Nota: Esse exemplo usa o OpenSSL para a geração de chave e certificado e a ferramenta de teste Postman API para mostrar o uso da API REST. Substitua-os por outras ferramentas comparáveis com base nos requisitos da sua empresa. ## Importação do par de chaves de encapsulamento/desencapsulamento {#ariaid-title2} Defina as configurações de importação do Estrutura de gestão principal antes de importar uma chave. ### Antes de Iniciar Função necessária: sn_kmf.cryptographic_manager ### Por Que e Quando Desempenhar Esta Tarefa Este exemplo usa o OpenSSL para geração da chave e do certificado. Substitua-os por outras ferramentas comparáveis com base nos requisitos da sua empresa. ### Procedimento 1. Em seu ambiente local, use o terminal para criar um certificado. Por exemplo: `openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:4096 -keyout wrapping_private.key -out wrapping_public.crt` Este certificado é um componente público que contém uma chave. O certificado é usado para encapsular a chave simétrica do AES. 2. Em seu ambiente local, use o terminal para criar um armazenamento de chaves contendo o certificado público (com a chave de encapsulamento) e a chave de desencapsulamento privada. Por exemplo: `openssl pkcs12 -export -in wrapping_public.crt -inkey wrapping_private.key -name "wrapping_key_alias" -out wrapping_keystore.p12` 3. Em sua instância, navegue até TudoGestão de chaveConfigurações de importaçãoConfigurações de importação de chave. 4. Na seção Definição de algoritmo, verifique se a Finalidade da criptografia está definida como Desencapsulamento de chave assimétrica. 5. Selecione um algoritmo apropriado que se alinhe com o material da chave assimétrica do armazenamento de chaves importado. Consulte [Especificação criptográfica](https://servicenow-prod.fluidtopics.net/1tJljuQLB5qzYEEQumq8sg "A especificação criptográfica é o componente que define aspectos do seu módulo criptográfico, incluindo sua finalidade criptográfica e qual algoritmo de criptografia usar.") para obter informações adicionais. 6. Selecione Avançar. 7. Na seção Definição do ciclo de vida, clique em Avançar para continuar. 8. Na seção Origem da chave, selecione Importar do PKCS12 ou Importar do BCFKS no campo Origem. Nota: Se estiver usando o armazenamento de chaves de exemplo da etapa 1, selecione Importar de PKCS12. 9. Insira um Alias de chave para identificar a chave. Esse alias deve corresponder ao alias de chave (ou "nome amigável") que foi especificado ao gerar o certificado ou o armazenamento de chaves a ser carregado. Continuando o exemplo acima, seria `wrap_key_alias`. 10. Selecione Avançar. A seção Criação de chave inclui um link Importar chave, que exibe uma caixa de diálogo para carregar o armazenamento de chaves. Continuando o exemplo, seria `wrapping_keystore.p12`. ## Importar uma chave encapsulada do serviço da Web {#ariaid-title3} Carregue sua chave encapsulada em um módulo criptográfico usando a chave de importação da funcionalidade de Serviço da web. O exemplo usa uma chave simétrica. Etapas semelhantes podem ser usadas para importar uma chave assimétrica. ### Antes de Iniciar Funções necessárias: sn_kmf.cryptographic_manager (configuração do módulo), sn_kmf.cryptographic_operator (autenticação básica da operação REST) ### Por Que e Quando Desempenhar Esta Tarefa KMF A importação do acesso de endpoint da chave é necessária para concluir o processo de importação da chave. Este exemplo usa o OpenSSL para gerar chaves e certificados. Você pode substitui-lo por outras ferramentas comparáveis com base nos seus requisitos. ### Procedimento 1. Usando o terminal no seu dispositivo local, encapsule sua chave simétrica usando a chave de encapsulamento de chave pública do módulo Importação de chave. Por exemplo: `openssl pkeyutl -encrypt -pubin -inkey public_wrapping_key.pem -in symmetric_key.bin -pkeyopt rsa_padding_mode:oaep -pkeyopt rsa_oaep_md:sha256 -out wrapped_symmetric_key.txt` Este exemplo cria um arquivo de chave encapsulado chamado `wrapped_symmetric_key.txt`. 2. Crie um módulo criptográfico para ser vinculado à API. Consulte ou para obter informações adicionais. 3. Adicione uma especificação criptográfica com as seguintes seleções. * Objetivo da criptografia: Criptografia/descriptografia simétrica de dados. * Origem da chave: Importar do serviço web Consulte ou para mais informações. {#import-publickey-web__choices_rkr_jgb_fqb} 4. Execute uma solicitação HTTP POST para a importação do endpoint REST do serviço web. | Opção | Valor/formato | | URL do endpoint | https://\/api/sn_kmf/key/import?cryptoSpecSysID=\. | | Parâmetro CryptoSpecSysID | O sys_id da especificação de criptografia recém-criada. Dica: Clique com o botão direito do mouse no cabeçalho da especificação criptográfica para copiar o sys_id. | | Tipo de conteúdo do cabeçalho | Aplicação/fluxo de octeto. | | Corpo | Deve conter um arquivo anexo-binário e a chave pública a ser importada (wrapped_sensitive_key.txt). | | Importar do endpoint REST do serviço web | Usa autenticação básica de \ Nota: Certifique-se de que o usuário designado tenha a função sn_kmf_cryptographic_operator. | |-|-| {#import-publickey-web__choicetable_wgh_zgb_fqb} A importação bem-sucedida da chave pública resulta em uma mensagem de resposta HTTP com Status 200. 5. Verifique se a chave foi importada com sucesso para o módulo criptográfico de destino.