Menggunakan driver Node.js klien Cassandra untuk mengakses Amazon Keyspaces secara terprogram

Bagian ini menunjukkan cara menyambung ke Amazon Keyspaces dengan menggunakan driver Node.js klien. Untuk memberikan kredentif kepada pengguna dan aplikasi untuk akses terprogram ke sumber daya Amazon Keyspaces, Anda dapat melakukan salah satu dari hal berikut:

• Buat kredentif khusus layanan yang terkait dengan pengguna AWS Identity and Access Management (IAM) tertentu.

• Untuk keamanan yang ditingkatkan, sebaiknya buat kunci akses IAM untuk pengguna atau peran IAM yang digunakan di semua AWS layanan. Plugin otentikasi SigV4 Amazon Keyspaces untuk driver klien Cassandra memungkinkan Anda mengotentikasi panggilan ke Amazon Keyspaces menggunakan kunci akses IAM alih-alih nama pengguna dan kata sandi. Untuk informasi selengkapnya, lihat Membuat dan mengonfigurasi AWS kredensional untuk Amazon Keyspaces.

Sebelum kamu memulai

Anda harus menyelesaikan tugas berikut sebelum Anda dapat memulai.

Amazon Keyspaces memerlukan penggunaan Transport Layer Security (TLS) untuk membantu mengamankan koneksi dengan klien. Untuk terhubung ke Amazon Keyspaces menggunakan TLS, Anda perlu mengunduh sertifikat digital Amazon dan mengonfigurasi driver Python untuk menggunakan TLS.

Unduh sertifikat digital berikut dan simpan file secara lokal atau di direktori home Anda.

1. AmazonRootCA1

2. AmazonRootCA2

3. AmazonRootCA3

4. AmazonRootCA4

5. Starfield Class 2 Root (opsional - untuk kompatibilitas mundur)

Untuk mengunduh sertifikat, Anda dapat menggunakan perintah berikut.

curl -O https://www.amazontrust.com/repository/AmazonRootCA1.pem
curl -O https://www.amazontrust.com/repository/AmazonRootCA2.pem
curl -O https://www.amazontrust.com/repository/AmazonRootCA3.pem
curl -O https://www.amazontrust.com/repository/AmazonRootCA4.pem
curl -O https://certs.secureserver.net/repository/sf-class2-root.crt

catatan

Amazon Keyspaces sebelumnya menggunakan sertifikat TLS yang ditambatkan ke Starfield Class 2 CA. AWS memigrasikan semua Wilayah AWS ke sertifikat yang dikeluarkan di bawah Amazon Trust Services (Amazon Root CA 1—4). Selama transisi ini, konfigurasikan klien untuk mempercayai Amazon Root CA 1—4 dan root Starfield untuk memastikan kompatibilitas di semua Wilayah.

Gabungkan semua sertifikat yang diunduh ke dalam satu pem file dengan nama keyspaces-bundle.pem dalam contoh kami. Anda dapat melakukan ini dengan menjalankan perintah berikut. Catat jalur ke file, Anda perlu ini nanti.

cat AmazonRootCA1.pem \
 AmazonRootCA2.pem \
 AmazonRootCA3.pem \
 AmazonRootCA4.pem \
 sf-class2-root.crt \
 > keyspaces-bundle.pem

Hubungkan ke Amazon Keyspaces menggunakan Node.js DataStax driver untuk Apache Cassandra dan kredenSIAL khusus layanan

Konfigurasikan driver Anda untuk menggunakan file sertifikat gabungan keyspaces-bundle.pem untuk TLS dan otentikasi menggunakan kredentif khusus layanan. Contoh:

const cassandra = require('cassandra-driver');
const fs = require('fs');
const auth = new cassandra.auth.PlainTextAuthProvider('ServiceUserName', 'ServicePassword');
const sslOptions1 = {
         ca: [
                    fs.readFileSync('path_to_file/keyspaces-bundle.pem', 'utf-8')],      
                    host: 'cassandra.us-west-2.amazonaws.com',
                    rejectUnauthorized: true
        };
const client = new cassandra.Client({
                   contactPoints: ['cassandra.us-west-2.amazonaws.com'],
                   localDataCenter: 'us-west-2',
                   authProvider: auth,
                   sslOptions: sslOptions1,
                   protocolOptions: { port: 9142 }
        });
const query = 'SELECT * FROM system_schema.keyspaces';
 
client.execute(query)
                    .then( result => console.log('Row from Keyspaces %s', result.rows[0]))
                    .catch( e=> console.log(`${e}`));

Catatan penggunaan:

1. Ganti "path_to_file/keyspaces-bundle.pem" dengan jalur ke file sertifikat gabungan yang disimpan pada langkah pertama.

2. Pastikan ServiceUserName dan ServicePassword cocok dengan nama pengguna dan kata sandi yang Anda peroleh saat membuat kredenSIAL khusus layanan dengan mengikuti langkah-langkah untuk. Buat kredensil khusus layanan untuk akses terprogram ke Amazon Keyspaces

3. Untuk daftar titik akhir yang tersedia, lihatTitik akhir layanan untuk Amazon Keyspaces.

Hubungkan ke Amazon Keyspaces menggunakan DataStax Node.js driver untuk Apache Cassandra dan plugin otentikasi SIGv4

Bagian berikut menunjukkan cara menggunakan plugin otentikasi SIGv4 untuk DataStax Node.js driver open-source untuk Apache Cassandra untuk mengakses Amazon Keyspaces (untuk Apache Cassandra).

Jika Anda belum melakukannya, buat kredensional untuk pengguna atau peran IAM Anda mengikuti langkah-langkah diMembuat dan mengonfigurasi AWS kredensional untuk Amazon Keyspaces.

Tambahkan plugin otentikasi Node.js SIGv4 ke aplikasi Anda dari GitHub repositori. Plugin mendukung versi 4.x DataStax Node.js driver untuk Cassandra dan tergantung pada AWS SDK untuk. Node.js Ini digunakan AWSCredentialsProvider untuk mendapatkan kredenSIAL.

$ npm install aws-sigv4-auth-cassandra-plugin --save

Contoh kode ini menunjukkan cara mengatur Region-specific instance SigV4AuthProvider sebagai penyedia otentikasi.

const cassandra = require('cassandra-driver');
const fs = require('fs');
const sigV4 = require('aws-sigv4-auth-cassandra-plugin');

const auth = new sigV4.SigV4AuthProvider({
    region: 'us-west-2', 
    accessKeyId:'AKIAIOSFODNN7EXAMPLE',
    secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY'});

const sslOptions1 = {
  ca: [
      fs.readFileSync('path_to_file/keyspaces-bundle.pem', 'utf-8')],
  host: 'cassandra.us-west-2.amazonaws.com',
  rejectUnauthorized: true
};


const client = new cassandra.Client({
  contactPoints: ['cassandra.us-west-2.amazonaws.com'],
  localDataCenter: 'us-west-2',
  authProvider: auth,
  sslOptions: sslOptions1,
  protocolOptions: { port: 9142 }
});


const query = 'SELECT * FROM system_schema.keyspaces';

client.execute(query).then(
    result => console.log('Row from Keyspaces %s', result.rows[0]))
    .catch( e=> console.log(`${e}`));

Catatan penggunaan:

1. Ganti "path_to_file/keyspaces-bundle.pem" dengan jalur ke sertifikat yang disimpan pada langkah pertama.

2. Pastikan bahwa accessKeyId dan secretAccessKey cocok dengan Kunci Akses dan Kunci Akses Rahasia yang Anda peroleh menggunakanAWSCredentialsProvider. Untuk informasi selengkapnya, lihat Mengatur Kredentif Node.js di AWS SDK untuk JavaScript in Node.js.

3. Untuk menyimpan kunci akses di luar kode, lihat praktik terbaik diSimpan kunci akses untuk akses terprogram.

4. Untuk daftar titik akhir yang tersedia, lihatTitik akhir layanan untuk Amazon Keyspaces.