Instalar o OpenSSL Dynamic Engine para o Client SDK 5 do AWS CloudHSM - AWS CloudHSM

Instalar o OpenSSL Dynamic Engine para o Client SDK 5 do AWS CloudHSM

Use as seções a seguir para instalar o OpenSSL Dynamic Engine para o Client SDK 5 do AWS CloudHSM.

nota

Para executar um único cluster HSM com o Client SDK 5, você deve primeiro gerenciar as configurações de durabilidade da chave do cliente configurando disable_key_availability_check como True. Para obter mais informações, consulte Sincronização de chave e a ferramenta de configuração do Client SDK 5.

Instalar e configurar o mecanismo dinâmico do OpenSSL
  1. Use os seguintes comandos para fazer download e instalar o mecanismo OpenSSL.

    Amazon Linux 2

    Instale o OpenSSL Dynamic Engine para Amazon Linux 2 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-dyn-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el7.x86_64.rpm

    Instale o OpenSSL Dynamic Engine para Amazon Linux 2 na arquitetura ARM64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-dyn-latest.el7.aarch64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el7.aarch64.rpm
    Amazon Linux 2023

    Instale o OpenSSL Dynamic Engine para Amazon Linux 2023 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Amzn2023/cloudhsm-dyn-latest.amzn2023.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.amzn2023.x86_64.rpm

    Instale o OpenSSL Dynamic Engine para Amazon Linux 2023 na arquitetura ARM64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Amzn2023/cloudhsm-dyn-latest.amzn2023.aarch64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.amzn2023.aarch64.rpm
    CentOS 7 (7.8+)

    Instale o OpenSSL Dynamic Engine para CentOS 7 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-dyn-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el7.x86_64.rpm
    RHEL 7 (7.8+)

    Instale o OpenSSL Dynamic Engine para RHEL 7 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-dyn-latest.el7.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el7.x86_64.rpm
    RHEL 8 (8.3+)

    Instale o OpenSSL Dynamic Engine para RHEL 8 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL8/cloudhsm-dyn-latest.el8.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el8.x86_64.rpm
    RHEL 9 (9.2+)

    Instale o OpenSSL Dynamic Engine para RHEL 9 na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL9/cloudhsm-dyn-latest.el9.x86_64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el9.x86_64.rpm

    Instale o OpenSSL Dynamic Engine para RHEL 9 na arquitetura ARM64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL9/cloudhsm-dyn-latest.el9.aarch64.rpm
    $ sudo yum install ./cloudhsm-dyn-latest.el9.aarch64.rpm
    Ubuntu 20.04 LTS

    Instale o OpenSSL Dynamic Engine para Ubuntu 20.04 LTS na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Focal/cloudhsm-dyn_latest_u20.04_amd64.deb
    $ sudo apt install ./cloudhsm-dyn_latest_u20.04_amd64.deb
    Ubuntu 22.04 LTS

    Instale o OpenSSL Dynamic Engine para Ubuntu 22.04 LTS na arquitetura X86_64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Jammy/cloudhsm-dyn_latest_u22.04_amd64.deb
    $ sudo apt install ./cloudhsm-dyn_latest_u22.04_amd64.deb

    Instale o OpenSSL Dynamic Engine para Ubuntu 22.04 LTS na arquitetura ARM64:

    $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Jammy/cloudhsm-dyn_latest_u22.04_arm64.deb
    $ sudo apt install ./cloudhsm-dyn_latest_u22.04_arm64.deb

    Você instalou a biblioteca compartilhada para o mecanismo dinâmico em /opt/cloudhsm/lib/libcloudhsm_openssl_engine.so.

  2. Bootstrap do Client SDK 5. Para obter mais informações sobre ações de bootstrap, consulte Bootstrap o Client SDK.

  3. Defina uma variável de ambiente com as credenciais de um usuário de criptografia (CU). Para obter informações sobre a criação de usuários de criptografia (CUs), consulte Gerenciamento de usuários com o CMU.

    $ export CLOUDHSM_PIN=<HSM user name>:<password>
    nota

    O Client SDK 5 introduz a variável de CLOUDHSM_PIN ambiente para armazenar as credenciais do CU. No Client SDK 3, você armazena as credenciais do CU na variável de n3fips_password ambiente. O Client SDK 5 é compatível com as duas variáveis de ambiente, mas recomendamos o uso de CLOUDHSM_PIN.

  4. Conecte sua instalação do mecanismo dinâmico do OpenSSL ao cluster. Para obter mais informações, consulte Conexão com um cluster.

  5. Bootstrap o Client SDK 5. Para ter mais informações, consulte Bootstrap o Client SDK.

Verifique o mecanismo dinâmico do OpenSSL para Client SDK 5

Use o comando a seguir para verificar sua instalação do mecanismo dinâmico do OpenSSL.

$ openssl engine -t cloudhsm

A saída a seguir verifica sua configuração:

(cloudhsm) CloudHSM OpenSSL Engine [ available ]