Introducing NodeJS SigV4 Connection Example (#18)

* Create project files

* Enable grabbing env variables from .env file

* Remove redundant .npmignore file

* Implement NodeJS plugin functionality

* Provide project instructions and context

* Add MIT-0 file header

Author: zachzhaoamzn

nodejs/datastax-v4/connection-sigv4/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+package-lock.json
+.env

nodejs/datastax-v4/connection-sigv4/README.md

@@ -0,0 +1,21 @@
+## Connecting to Amazon Keyspaces with NodeJS
+
+This sample project shows the use of the DataStax NodeJS Driver for Apache Cassandra using SigV4.
+
+### Prerequisites
+
+You should have NodeJS and NPM installed. This sample used NodeJS 14.x and NPM 6.x.
+
+You should also setup Amazon Keyspaces with an IAM user. See [Accessing Amazon Keyspaces](https://docs.aws.amazon.com/keyspaces/latest/devguide/accessing.html) for more.
+
+### Running the Sample
+
+To run this sample, create a .env file in the same directory as this README.
+In your .env file, define the following environment variables:
+- AWS_REGION (ex: 'us-east-1')
+- AWS_ACCESS_KEY_ID (ex: 'AKIAIOSFODNN7EXAMPLE')
+- AWS_SECRET_ACCESS_KEY (ex: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY')
+
+Install the project's dependencies by running `npm install` in this directory.
+
+Finally, run `node index.js` to start the sample.

nodejs/datastax-v4/connection-sigv4/index.js

@@ -0,0 +1,58 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: MIT-0
+
+// Variables
+const cassandra = require('cassandra-driver');
+const fs = require('fs');
+const sigV4 = require('aws-sigv4-auth-cassandra-plugin');
+require('dotenv').config();
+const region = process.env.AWS_REGION;
+const accessKey = process.env.AWS_ACCESS_KEY_ID;
+const secretKey = process.env.AWS_SECRET_ACCESS_KEY;
+
+// Check that environment variables are not undefined
+if (!region) {
+    console.log("You do not have a region set. Set environment variable AWS_REGION");
+    process.exit(1);
+}
+
+if (!accessKey) {
+    console.log("You do not have an access key set. Set environment variable AWS_ACCESS_KEY_ID");
+    process.exit(1);
+}
+
+if (!secretKey) {
+    console.log("You do not have a secret key set. Set environment variable AWS_SECRET_ACCESS_KEY");
+    process.exit(1);
+}
+
+const auth = new sigV4.SigV4AuthProvider({
+    region: region,
+    accessKeyId: accessKey,
+    secretAccessKey: secretKey
+});
+
+const host = 'cassandra.' + region + '.amazonaws.com'
+const sslOptions = {
+    ca: [
+        fs.readFileSync(__dirname + '/resources/sf-class2-root.crt')
+    ],
+    host: host,
+    rejectUnauthorized: true
+};
+
+const client = new cassandra.Client({
+    contactPoints: [host],
+    localDataCenter: region,
+    authProvider: auth,
+    sslOptions: sslOptions,
+    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}`)
+);

nodejs/datastax-v4/connection-sigv4/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "nodejs-sigv4-example",
+  "version": "1.0.0",
+  "description": "A sigv4 authentication plugin for open-source Datastax NodeJS Driver for Apache Cassandra",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cassandra",
+    "cql",
+    "sigv4",
+    "connection",
+    "driver",
+    "aws"
+  ],
+  "author": "",
+  "license": "MIT-0",
+  "dependencies": {
+    "aws-sigv4-auth-cassandra-plugin": "^1.0.2",
+    "cassandra-driver": "^4.6.3",
+    "dotenv": "^10.0.0",
+    "fs": "0.0.1-security"
+  }
+}

nodejs/datastax-v4/connection-sigv4/resources/sf-class2-root.crt

@@ -0,0 +1,24 @@
+-----BEGIN CERTIFICATE-----
+MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
+MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
+U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
+NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
+ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
+ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
+DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
+8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
++lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
+X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
+K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
+1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
+A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
+zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
+YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
+bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
+DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
+L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
+eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
+xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
+VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
+WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
+-----END CERTIFICATE-----