Migrar a biblioteca PKCS #11 do AWS CloudHSM do Client SDK 3 para o Client SDK 5 - AWS CloudHSM
Preparar-se abordando as mudanças mais importantesMigrar para o Client SDK 5Tópicos relacionados

Migrar a biblioteca PKCS #11 do AWS CloudHSM do Client SDK 3 para o Client SDK 5

Use este tópico para migrar a biblioteca PKCS #11 do AWS CloudHSM do Client SDK 3 para o Client SDK 5. Para conhecer os benefícios da migração, consulte Benefícios do Client SDK 5 do AWS CloudHSM.

No AWS CloudHSM, as aplicações do cliente realizam operações criptográficas usando o Kit de Desenvolvimento de Software (SDK) do cliente AWS CloudHSM. O Client SDK 5 é o SDK principal que sempre recebe novos recursos e suporte de plataforma.

Para revisar as instruções de migração para todos os provedores, consulte Migrar do Client SDK 3 do AWS CloudHSM para o Client SDK 5.

Preparar-se abordando as mudanças mais importantes

Revise essas alterações importantes e atualize a aplicação em seu ambiente de desenvolvimento adequadamente.

Os mecanismos de encapsulamento foram alterados

Mecanismo do Client SDK 3 Mecanismo equivalente do Client SDK 5

CKM_AES_KEY_WRAP

CKM_CLOUDHSM_AES_KEY_WRAP_PKCS5_PAD

CKM_AES_KEY_WRAP_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_ZERO_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_PKCS5_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_PKCS5_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_NO_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_NO_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_ZERO_PAD

CKM_CLOUDHSM_AES_KEY_WRAP_ZERO_PAD

ECDH

No Client SDK 3, você pode usar o ECDH e especificar um KDF. No momento, essa funcionalidade não está disponível no Client SDK 5. Se sua aplicação precisar dessa funcionalidade, entre em contato com o suporte.

Os manipuladores de chaves agora são específicos da sessão

Para usar com sucesso os identificadores de chave no Client SDK 5, você deve obter identificadores de chave sempre que executar um aplicativo. Se você tiver aplicações existentes que usarão os mesmos identificadores de chave em diferentes execuções, você deve modificar seu código para obter o identificador de chave sempre que executar a aplicação. Para obter informações sobre como recuperar manipuladores de chaves, consulte este exemplo da PKCS #11 do AWS CloudHSM. Essa alteração está em conformidade com a especificação PKCS #11 2.40.

Migrar para o Client SDK 5

Siga as instruções nesta seção para migrar do Client SDK 3 para o Client SDK 5.

nota

No momento, o Amazon Linux, o Ubuntu 16.04, o Ubuntu 18.04, o CentOS 6, o CentOS 8 e o RHEL 6 não são compatíveis com o Client SDK 5. Se você estiver usando uma dessas plataformas com o Client SDK 3, precisará escolher uma plataforma diferente ao migrar para o Client SDK 5.

  1. Desinstale a biblioteca PKCS #11 para Client SDK 3.

    Amazon Linux 2
    $ sudo yum remove cloudhsm-client-pkcs11
    CentOS 7
    $ sudo yum remove cloudhsm-client-pkcs11
    RHEL 7
    $ sudo yum remove cloudhsm-client-pkcs11
    RHEL 8
    $ sudo yum remove cloudhsm-client-pkcs11
    Ubuntu 16.04 LTS
    $ sudo apt remove cloudhsm-client-pkcs11
    Ubuntu 18.04 LTS
    $ sudo apt remove cloudhsm-client-pkcs11

  2. Pare o Client Daemon para o Client SDK 3.

    Amazon Linux 2
    $ sudo service cloudhsm-client stop
    CentOS 7
    $ sudo service cloudhsm-client stop
    RHEL 7
    $ sudo service cloudhsm-client stop
    RHEL 8
    $ sudo service cloudhsm-client stop
    Ubuntu 16.04 LTS
    $ sudo systemctl stop cloudhsm-client
    Ubuntu 18.04 LTS
    $ sudo systemctl stop cloudhsm-client

  3. Desinstale o Client Daemon do Client SDK 3.

    Amazon Linux 2
    $ sudo yum remove cloudhsm-client
    CentOS 7
    $ sudo yum remove cloudhsm-client
    RHEL 7
    $ sudo yum remove cloudhsm-client
    RHEL 8
    $ sudo yum remove cloudhsm-client
    Ubuntu 16.04 LTS
    $ sudo apt remove cloudhsm-client
    Ubuntu 18.04 LTS
    $ sudo apt remove cloudhsm-client
    nota

    As configurações personalizadas precisam ser habilitadas novamente.

  4. Instale a biblioteca PKCS #11 do Client SDK seguindo as etapas em Instalar a biblioteca PKCS #11 para o Client SDK 5 do AWS CloudHSM.

  5. O Client SDK 5 apresenta um novo formato de arquivo de configuração e uma ferramenta de inicialização de linha de comando. Para inicializar sua biblioteca PKCS #11 do Client SDK 5, siga as instruções listadas no guia do usuário em Bootstrap o Client SDK.

  6. Teste sua aplicação em seu ambiente de desenvolvimento. Faça atualizações no código existente para resolver as alterações importantes antes da migração final.

Tópicos relacionados