DOCSP:13409 aws session token auth (#213)

* DOCSP-13409: added aws session token connection instructions

Author: rustagir

source/code-snippets/authentication/aws.js

@@ -7,24 +7,26 @@ const clusterUrl = "<MongoDB cluster url>";
 
 const authMechanism = "MONGODB-AWS";
 
-// Replace the following with your MongoDB deployment's connection string.
-const uri =
+let uri =
   `mongodb+srv://${accessKeyId}:${secretAccessKey}@${clusterUrl}/?authMechanism=${authMechanism}`;
 
-// Create a new MongoClient
+// Uncomment the following lines if your AWS authentication setup requires a session token.
+// const sessionToken = encodeURIComponent("<AWS_SESSION_TOKEN>");
+// uri = uri.concat(`&authMechanismProperties=${sessionToken}`);
+
+// Create a new MongoClient.
 const client = new MongoClient(uri);
 
-// Function to connect to the server
 async function run() {
   try {
-    // Connect the client to the server
+    // Connect the client to the server.
     await client.connect();
 
-    // Establish and verify connection
+    // Establish and verify connection.
     await client.db("admin").command({ ping: 1 });
-    console.log("Connected successfully to server");
+    console.log("Connected successfully to server.");
   } finally {
-    // Ensures that the client will close when you finish/error
+    // Ensure that the client closes when it finishes/errors.
     await client.close();
   }
 }

source/fundamentals/authentication/mechanisms.txt

@@ -149,20 +149,19 @@ The driver checks the following sources for your credentials in order:
 4. AWS EC2 endpoint. For more information, see `IAM Roles for Tasks
    <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html>`_.
 
-If you do not already have the `aws signature library <https://www.npmjs.com/package/aws4>`__,
+If you do not already have the `AWS signature library <https://www.npmjs.com/package/aws4>`__,
 install it using the following ``npm`` command:
 
 .. code-block:: console
 
    npm install aws4
 
 The following code shows an example of specifying the ``MONGODB-AWS``
-authentication mechanism and credentials in the connection string.
+authentication mechanism and credentials in the connection string:
 
 .. literalinclude:: /code-snippets/authentication/aws.js
    :language: javascript
 
-
 ``X.509``
 ---------