Cassandra Node.js 클라이언트 드라이버를 사용하여 프로그래밍 방식으로 아마존 키스페이스에 액세스 - Amazon Keyspaces(Apache Cassandra용)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Cassandra Node.js 클라이언트 드라이버를 사용하여 프로그래밍 방식으로 아마존 키스페이스에 액세스

이 단원에서는 Node.js 클라이언트 드라이버를 사용하여 Amazon Keyspaces 연결하는 방법을 설명합니다. 사용자 및 애플리케이션에 Amazon Keyspaces 리소스에 프로그래밍 방식으로 액세스할 수 있는 자격 증명을 제공하려면 다음 중 하나를 수행할 수 있습니다.

  • 특정AWS Identity and Access Management (IAM) 사용자와 연결된 서비스별 자격 증명을 생성합니다.

  • 보안을 강화하려면 모든AWS 서비스에서 사용되는 IAM 사용자 또는 역할을 위한 IAM 액세스 키를 생성하는 것이 좋습니다. 카산드라 클라이언트 드라이버용 Amazon Keyspaces SigV4 인증 플러그인을 사용하면 사용자 이름과 암호 대신 IAM 액세스 키를 사용하여 Amazon 키스페이스에 대한 호출을 인증할 수 있습니다. 자세한 내용은 생성 및 구성 방법AWSAmazon Keyspaces을 참조하세요.

시작하기 전에

시작하려면 먼저 다음 작업을 완료해야 합니다.

Amazon Keyspace에서는 클라이언트와의 연결을 보호하기 위해 전송 계층 보안 (TLS) 을 사용해야 합니다. TLS를 사용하여 Amazon 키스페이스에 연결하려면 Amazon 디지털 인증서를 다운로드하고 TLS를 사용하도록 Python 드라이버를 구성해야 합니다.

다음 명령을 사용하여 Starfield 디지털 인증서를 다운로드하고sf-class2-root.crt 로컬 또는 홈 디렉토리에 저장합니다.

curl https://certs.secureserver.net/repository/sf-class2-root.crt -O
참고

또한 Amazon 디지털 인증서를 사용하여 Amazon 키스페이스에 연결할 수 있으며, 클라이언트가 Amazon Keyspace에 성공적으로 연결되면 계속 연결할 수 있습니다. Starfield 인증서는 이전 인증 기관을 사용하는 클라이언트에 추가 이전 버전과의 호환성을 제공합니다.

curl https://certs.secureserver.net/repository/sf-class2-root.crt -O

아파치 카산드라용 Node.js DataStax 드라이버와 서비스별 자격 증명을 사용하여 아마존 키스페이스에 Connect

TLS용 Starfield 디지털 인증서를 사용하고 서비스별 자격 증명을 사용하여 인증하도록 드라이버를 구성하십시오. 예시:

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/sf-class2-root.crt', '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}`));

사용 시 주의사항:

  1. 첫 번째 단계에서 저장한 인증서의 경로로"path_to_file/sf-class2-root.crt" 바꾸십시오.

  2. 다음 단계에 따라 ServiceUserName및 가 서비스별 자격 증명을 생성할 때 얻은 사용자 이름 및 암호와 ServicePassword일치하는지 확인하십시오서비스별 자격 증명 생성.

  3. 사용 가능한 엔드포인트 목록은 단원을 참조하십시오Amazon 키스페이스의 서비스 엔드포인트.

아파치 카산드라용 DataStax Node.js 드라이버와 SigV4 인증 플러그인을 사용하여 아마존 키스페이스에 Connect.

다음 섹션에서는 아파치 카산드라용 오픈 소스 DataStax Node.js 드라이버용 SigV4 인증 플러그인을 사용하여 아마존 Keyspaces (아파치 카산드라용) 에 액세스하는 방법을 보여줍니다.

의 단계에 따라 IAM 사용자 또는 역할에 대한 자격 증명을 생성합니다생성 및 구성 방법AWSAmazon Keyspaces.

GitHub 리포지토리에서 애플리케이션에 Node.js SigV4 인증 플러그인을 추가합니다. 플러그인은 카산드라용 DataStax Node.js 드라이버 버전 4.x를 지원하며 Node.js 용AWS SDK에 따라 다릅니다. 자격 증명을 얻는AWSCredentialsProvider 데 사용합니다.

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

이 코드 예제는 의 지역별 인스턴스를 인증SigV4AuthProvider 공급자로 설정하는 방법을 보여줍니다.

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_filecassandra/sf-class2-root.crt', '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}`));

사용 시 주의사항:

  1. 첫 번째 단계에서 저장한 인증서의 경로로"path_to_file/sf-class2-root.crt" 바꾸십시오.

  2. accessKeyId사용하여 얻은 액세스 키와 보안 액세스 키가 secretAccessKey일치하는지 확인하십시오AWSCredentialsProvider. 자세한 내용은 Node.js 용AWS SDK의 Node.js 에서 자격 증명 설정을 참조하십시오. JavaScript

  3. 코드 외부에 액세스 키를 저장하려면 에서 모범 사례를 참조하십시오IAM 사용자의 액세스 키를 관리하는 방법.

  4. 사용 가능한 엔드포인트 목록은 단원을 참조하십시오Amazon 키스페이스의 서비스 엔드포인트.