Gerenciando credenciais HSM

Na página Gerenciamento de armazenamento confiável, é possível gerenciar as credenciais do Módulo de segurança de hardware (HSM). Um HSM é um dispositivo PKCS#11 de terceiros que pode ser usado para gerar e armazenar com segurança chaves privadas. O HSM protege fisicamente o acesso e o uso das chaves privadas.

O software cliente é necessário para se comunicar com o HSM. O software cliente HSM deve ser instalado e configurado no mesmo computador que os formulários AEM.

AEM formulários O Digital Signatures pode usar credenciais armazenadas em um HSM para aplicar assinaturas digitais do lado do servidor. Siga as instruções nesta seção para criar um alias para cada credencial HSM que o Digital Signatures usará. O alias contém todos os parâmetros exigidos pelo HSM.

OBSERVAÇÃO

Após alterar a configuração do HSM, reinicie o servidor de formulários AEM.

Crie um alias para uma credencial HSM quando o dispositivo HSM estiver on-line

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM e clique em Adicionar.

  2. Na caixa Nome do Perfil, digite uma string usada para identificar o alias. Esse valor é usado como uma propriedade para algumas operações do Digital Signatures, como a operação Assinar campo de assinatura.

  3. Na caixa Biblioteca PKCS11, digite o caminho totalmente qualificado da biblioteca do cliente HSM no servidor. Por exemplo, c:\Program Files\LunaSA\cryptoki.dll. Em um ambiente clusterizado, esse caminho deve ser idêntico para todos os servidores do cluster.

  4. Clique em Testar conectividade HSM. Se AEM formulários puderem se conectar ao dispositivo HSM, será exibida uma mensagem informando que o HSM está disponível. Clique em Avançar.

  5. Use o Nome do token, a ID do slot ou o Índice de Lista do slot para identificar onde as credenciais são armazenadas no HSM.

    • Nome do token: corresponde ao nome da partição HSM a ser usada (por exemplo, HSMPART1).
    • ID do slot: a ID do slot é um identificador de slot do tipo de dados.
    • Índice de Lista de slot: Se você selecionar Índice de Lista de slot, defina as Informações do slot para um número inteiro que corresponda ao slot. Este é um índice baseado em 0, o que significa que se o cliente for registrado com a partição HSMPART1 primeiro, HSMPART1 será referenciado usando o valor 0 de SlotListIndex.
  6. Na caixa Pino do token, digite a senha necessária para acessar a chave HSM e clique em Avançar.

  7. Na caixa Credenciais, selecione uma credencial. Clique em Salvar.

Crie um alias para uma credencial HSM quando o dispositivo HSM estiver offline

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM e clique em Adicionar.

  2. Na caixa Nome do Perfil, digite uma string usada para identificar o alias. Esse valor é usado como uma propriedade para algumas operações do Digital Signatures, como a operação Assinar campo de assinatura.

  3. Na caixa Biblioteca PKCS11, digite o caminho totalmente qualificado da biblioteca do cliente HSM no servidor. Por exemplo, c:\Program Files\LunaSA\cryptoki.dll. Em um ambiente clusterizado, esse caminho deve ser idêntico para todos os servidores do cluster.

  4. Marque a caixa de seleção Criação de Perfis offline. Clique em Avançar.

  5. Na lista de dispositivo HSM, selecione o fabricante do dispositivo HSM no qual a credencial está armazenada.

  6. Na lista Tipo de slot, selecione Id do slot, Índice de slot ou Nome do token e especifique um valor na caixa Informações do slot. AEM formulários usam essas configurações para determinar onde as credenciais são armazenadas no HSM.

    • Nome do token: corresponde a um nome de partição (por exemplo, HSMPART1).

    • ID do slot: a ID do slot é um número inteiro que corresponde ao slot, que por sua vez corresponde a uma partição. Por exemplo, o cliente (servidor de formulários) registrado com a partição HSMPART1 primeiro. Isso mapeia o slot 1 para a partição HSMPART1, para este cliente. Como HSMPART1 é a primeira partição registrada, a ID do slot é 1 e você definiria Informações do slot como 1.

      A ID do slot é definida cliente a cliente. Se você registrou um segundo computador em uma partição diferente (por exemplo, HSMPART2 no mesmo dispositivo HSM), então o slot 1 seria associado à partição HSMPART2 para esse cliente.

    • Índice de slot: se você selecionar Índice de slot, defina as Informações do slot para um número inteiro que corresponda ao slot. Este é um índice baseado em 0, o que significa que se o cliente for registrado com a partição HSMPART1 primeiro, o slot 1 será mapeado para o HSMPART1 desse cliente. Como HSMPART1 é a primeira partição registrada, o Índice de Slot é 0.

  7. Selecione uma destas opções e forneça o caminho:

    • Certificado: (Não é necessário se estiver usando SHA1) Clique em Procurar e localize o caminho para a chave pública para a credencial que você está usando.
    • Certificado SHA1: (Não é necessário se estiver usando um certificado físico) Digite o valor SHA1 (impressão digital) do arquivo de chave pública (.cer) para a credencial que você está usando. Verifique se não há espaços usados no valor SHA1.
  8. Na caixa Password (Senha), digite a senha necessária para acessar a chave HSM para obter as informações do slot e clique em Save (Salvar).

Propriedades de alias de credenciais HSM de visualização

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM.
  2. Clique no nome do alias do alias de credencial para visualização nas propriedades e clique em OK.

Verifique o status de uma credencial HSM

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM.
  2. Clique na caixa de seleção ao lado da credencial que deseja marcar e clique em Verificar status.

A coluna Status reflete o status atual da credencial. Em caso de falha, um X vermelho é exibido na coluna Status. Passe o mouse sobre o X para exibir uma dica de ferramenta contendo o motivo da falha.

Atualizar propriedades de alias de credenciais HSM

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM.
  2. Clique no nome do alias do alias de credencial.
  3. Clique em Atualizar credencial e atualize as configurações conforme necessário.

Redefinir todas as conexões HSM

Redefina as conexões abertas com um dispositivo HSM após qualquer interrupção na sessão de rede entre o servidor de formulários e o dispositivo HSM. Por exemplo, as interrupções podem ocorrer devido a uma interrupção de rede ou o dispositivo HSM sendo colocado offline para uma atualização de software. Após uma interrupção, as conexões existentes são obsoletas e todas as solicitações de assinatura contra essas conexões falham. Usar a opção Redefinir todas as conexões HSM limpa as conexões antigas.

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM.
  2. Clique em Redefinir todas as conexões HSM.

Excluir um alias de credencial HSM

  1. No console de administração, clique em Configurações > Gerenciamento de armazenamento de confiança > Credenciais HSM.
  2. Marque as caixas de seleção das credenciais HSM que deseja excluir, clique em Excluir e, em seguida, clique em OK.

Configurar suporte remoto a HSM

AEM formulários usam um mecanismo IPC/RPC baseado em Serviços da Web. Esse mecanismo permite que AEM formulários usem um HSM instalado em um computador remoto. Para usar essa funcionalidade, instale o serviço da Web no computador remoto onde o HSM está instalado. Consulte Configurando o suporte HSM para formulários AEM ES usando o Sun JDK na plataforma Windows 64-bitpara obter mais informações.

Este mecanismo não oferece suporte à criação on-line de perfis HSM ou às verificações de status. No entanto, há duas maneiras de criar perfis HSM e executar verificações de status:

  • Crie uma credencial de cliente para formulários AEM transmitindo-a para o Certificado do assinante. Siga as etapas em Configurar o suporte a HSM para formulários AEM ES usando o Sun JDK na plataforma Windows 64 bits. O local do serviço da Web é passado como uma propriedade de Credencial. Perfis HSM off-line criados usando o certificado der ou o certificado SHA-1 hex também é suportado. No entanto, se você tiver atualizado para AEM formulários de uma versão anterior dos formulários AEM, faça alterações no cliente porque a credencial continha informações de certificado e serviço da Web.
  • O local do serviço Web é especificado no console de administração do serviço de assinatura. (Consulte Configurações do serviço de assinatura.) Aqui, o cliente carregava somente o alias do perfil HSM na loja confiável. É possível usar essa opção sem alterações do cliente, mesmo se você tiver atualizado para AEM formulários de uma versão anterior dos formulários AEM. Esta opção não suporta perfis HSM usando o certificado SHA-1.

Nesta página