Menghubungkan ke beberapa slot dengan PKCS #11

Satu slot di pustaka Client SDK 5 PKCS #11 mewakili satu koneksi ke cluster di. AWS CloudHSM Dengan Client SDK 5, Anda dapat mengonfigurasi pustaka PKCS11 Anda untuk memungkinkan beberapa slot menghubungkan pengguna ke beberapa klaster CloudHSM dari satu aplikasi PKCS #11.

Gunakan petunjuk dalam topik ini untuk membuat aplikasi Anda menggunakan fungsionalitas multi-slot untuk terhubung dengan beberapa cluster.

Prasyarat multi-slot

• Dua atau lebih AWS CloudHSM cluster yang ingin Anda sambungkan, bersama dengan sertifikat klaster mereka (yaitu, file Customerca.crt untuk setiap cluster)

• Instans EC2 dengan Grup Keamanan dikonfigurasi dengan benar untuk terhubung ke semua cluster di atas. Untuk informasi selengkapnya tentang cara menyiapkan cluster dan instance klien, lihat Memulai AWS CloudHSM.

• Untuk mengatur fungsionalitas multi-slot, Anda harus sudah mengunduh dan menginstal pustaka PKCS #11. Jika Anda belum melakukan ini, lihat instruksi diInstal Client SDK 5 untuk pustaka PKCS #11.

Konfigurasikan Perpustakaan PKCS #11 untuk fungsionalitas multi-slot

Untuk mengonfigurasi pustaka PKCS #11 Anda untuk fungsionalitas multi-slot, ikuti langkah-langkah berikut:

1. Identifikasi cluster yang ingin Anda sambungkan menggunakan fungsionalitas multi-slot.

2. Tambahkan klaster ini ke konfigurasi PKCS #11 Anda dengan mengikuti petunjuk di konfigurasi-pkcs11 add-cluster

3. Jalankan aplikasi PKCS #11 Anda untuk mengaktifkan fungsionalitas multi-slot.

konfigurasi-pkcs11 add-cluster

Saat menghubungkan ke beberapa slot dengan PKCS #11, gunakan configure-pkcs11 add-cluster perintah untuk menambahkan cluster ke konfigurasi Anda.

Sintaksis

configure-pkcs11 add-cluster [OPTIONS]
        --cluster-id <CLUSTER ID> 
        [--region <REGION>]
        [--endpoint <ENDPOINT>]
        [--hsm-ca-cert <HSM CA CERTIFICATE FILE>]
        [--server-client-cert-file <CLIENT CERTIFICATE FILE>]
        [--server-client-key-file <CLIENT KEY FILE>]
        [-h, --help]

Contoh

Tambahkan cluster menggunakan cluster-id parameter

Gunakan configure-pkcs11 add-cluster bersama dengan cluster-id parameter untuk menambahkan cluster (dengan ID daricluster-1234567) ke konfigurasi Anda.

Linux

$ sudo /opt/cloudhsm/bin/configure-pkcs11 add-cluster --cluster-id cluster-1234567

Windows

C:\Program Files\Amazon\CloudHSM\> .\configure-pkcs11.exe add-cluster --cluster-id cluster-1234567

Tip

Jika menggunakan configure-pkcs11 add-cluster dengan cluster-id parameter tidak mengakibatkan klaster ditambahkan, lihat contoh berikut untuk versi yang lebih panjang dari perintah ini yang juga memerlukan --region dan endpoint parameter untuk mengidentifikasi cluster yang ditambahkan. Jika, misalnya, wilayah cluster berbeda dari yang dikonfigurasi sebagai default AWS CLI Anda, Anda harus menggunakan --region parameter untuk menggunakan wilayah yang benar. Selain itu, Anda memiliki kemampuan untuk menentukan titik akhir AWS CloudHSM API yang akan digunakan untuk panggilan, yang mungkin diperlukan untuk berbagai pengaturan jaringan, seperti menggunakan titik akhir antarmuka VPC yang tidak menggunakan nama host DNS default untuk. AWS CloudHSM

Tambahkan cluster menggunakancluster-id,endpoint, dan region parameter

Gunakan region parameter configure-pkcs11 add-cluster bersama dengan cluster-idendpoint,, dan untuk menambahkan cluster (dengan IDcluster-1234567) ke konfigurasi Anda.

Linux

        $ sudo /opt/cloudhsm/bin/configure-pkcs11 add-cluster --cluster-id cluster-1234567 --region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com
                    

Windows

        C:\Program Files\Amazon\CloudHSM\> .\configure-pkcs11.exe add-cluster --cluster-id cluster-1234567--region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com
                    

Untuk informasi tentang parameter --cluster-id, --region dan --endpoint, lihat Parameter.

Parameter

--cluster-id <Cluster ID>

Membuat panggilan DescribeClusters untuk menemukan semua alamat IP antarmuka jaringan elastis (ENI) HSM dalam klaster yang terkait dengan ID klaster. Sistem ini menambahkan alamat IP ENI ke file konfigurasi AWS CloudHSM.

catatan

Jika Anda menggunakan parameter --cluster-id dari instans EC2 dalam VPC yang tidak memiliki akses ke internet publik, maka Anda harus membuat VPC endpoint antarmuka untuk terhubung dengan AWS CloudHSM. Untuk informasi lebih lanjut tentang VPC endpoint, lihat AWS CloudHSM dan VPC endpoint.

Wajib: Ya

--endpoint <Endpoint>

Menentukan titik akhir API AWS CloudHSM yang digunakan untuk membuat panggilan DescribeClusters. Anda harus menetapkan pilihan ini dalam kombinasi dengan --cluster-id.

Wajib: Tidak

-- hsm-ca-cert <HsmCA/Certificate/file>

Menentukan file sertifikat CA HSM

Wajib: Tidak

--region <Region>

Tentukan wilayah klaster Anda. Anda harus menetapkan pilihan ini dalam kombinasi dengan --cluster-id.

Jika Anda tidak menyediakan parameter --region, sistem memilih wilayah dengan mencoba untuk membaca variabel lingkungan AWS_DEFAULT_REGION atau AWS_REGION. Jika variabel-variabel tersebut tidak diatur, maka sistem memeriksa wilayah yang terkait dengan profil Anda di file AWS config Anda (biasanya ~/.aws/config) kecuali jika Anda menentukan file yang berbeda di variabel lingkungan AWS_CONFIG_FILE. Jika tidak ada variabel di atas yang diatur, sistem default ke wilayah us-east-1.

Wajib: Tidak

-- server-client-cert-file <Client/certificate/file>

Jalur ke sertifikat klien yang digunakan untuk autentikasi mutual klien-server TLS.

Hanya gunakan opsi ini jika Anda tidak ingin menggunakan kunci default dan sertifikat SSL/TLS yang kami sertakan dengan Klien SDK 5. Anda harus menetapkan pilihan ini dalam kombinasi dengan --server-client-key-file.

Wajib: Tidak

-- server-client-key-file <Client/key/file>

Jalur ke kunci klien yang digunakan untuk autentikasi mutual klien-server TLS.

Hanya gunakan opsi ini jika Anda tidak ingin menggunakan kunci default dan sertifikat SSL/TLS yang kami sertakan dengan Klien SDK 5. Anda harus menetapkan pilihan ini dalam kombinasi dengan --server-client-cert-file.

Wajib: Tidak

konfigurasi-pkcs11 hapus-cluster

Saat menghubungkan ke beberapa slot dengan PKCS #11, gunakan configure-pkcs11 remove-cluster perintah untuk menghapus cluster dari slot PKCS #11 yang tersedia.

Sintaksis

configure-pkcs11 remove-cluster [OPTIONS]
        --cluster-id <CLUSTER ID>
        [-h, --help]

Contoh

Hapus cluster menggunakan cluster-id parameter

Gunakan configure-pkcs11 remove-cluster bersama dengan cluster-id parameter untuk menghapus cluster (dengan ID daricluster-1234567) dari konfigurasi Anda.

Linux

$ sudo /opt/cloudhsm/bin/configure-pkcs11 remove-cluster --cluster-id cluster-1234567
            

Windows

C:\Program Files\Amazon\CloudHSM\> .\configure-pkcs11.exe remove-cluster --cluster-id cluster-1234567
            

Untuk informasi tentang parameter --cluster-id, lihat Parameter.

Parameter

--cluster-id <Cluster ID>

ID cluster untuk menghapus dari konfigurasi

Wajib: Ya