DOCSP-25572 QE tutorial with KMIP (#1960)

* DOCSP-25572 QE tutorial with KMIP

* restore language-id.rst

* lang

Author: jmd-mongo

source/core/queryable-encryption/tutorials/kmip/kmip-automatic.txt

@@ -46,6 +46,11 @@ Before You Get Started
 
          `Complete Java Application <{+sample-app-url-qe+}/java/kmip/reader/>`__
 
+      .. tab:: Mongosh
+         :tabid: shell
+
+         `Complete Mongosh Application <{+sample-app-url-qe+}/mongosh/kmip/reader/>`__
+
       .. tab:: Node.js
          :tabid: nodejs
 
@@ -71,7 +76,7 @@ Before You Get Started
 Set Up the KMS
 --------------
 
-.. include:: /includes/tutorials/language-id.rst
+.. include:: /includes/tutorials/language-id-qe.rst
 
 .. procedure::
    :style: normal
@@ -111,6 +116,12 @@ your application to see relevant code samples.
                To view the complete code for making a {+dek-long+}, see
                `our Github repository <{+sample-app-url-qe+}/java/kmip/reader/src/main/java/com/mongodb/qe/MakeDataKey.java>`__.
 
+            .. tab::
+               :tabid: shell
+
+               To view the complete code for making a {+dek-long+}, see
+               `our Github repository <{+sample-app-url-qe+}/mongosh/kmip/reader/make_data_key.js>`__.
+
             .. tab::
                :tabid: nodejs
 
@@ -153,6 +164,12 @@ your application to see relevant code samples.
                To view the complete code for inserting an encrypted document, see
                `our Github repository <{+sample-app-url-qe+}/java/kmip/reader/src/main/java/com/mongodb/qe/InsertEncryptedDocument.java>`__.
 
+            .. tab::
+               :tabid: shell
+
+               To view the complete code for inserting an encrypted document, see
+               `our Github repository <{+sample-app-url-qe+}/mongosh/kmip/reader/insert_encrypted_document.js>`__.
+
             .. tab::
                :tabid: nodejs
 
@@ -191,6 +208,12 @@ your application to see relevant code samples.
                To view the complete code for inserting an encrypted document, see
                `our Github repository <{+sample-app-url-qe+}/java/kmip/reader/src/main/java/com/mongodb/qe/InsertEncryptedDocument.java>`__.
 
+            .. tab::
+               :tabid: shell
+
+               To view the complete code for inserting an encrypted document, see
+               `our Github repository <{+sample-app-url-qe+}/mongosh/kmip/reader/insert_encrypted_document.js>`__.
+
             .. tab::
                :tabid: nodejs
 

source/includes/queryable-encryption/tutorials/automatic/kmip/certificates.rst

@@ -21,6 +21,16 @@ a client certificate that your {+kmip-kms+} accepts:
          `kmsProviderSslContextMap <{+java-driver-api+}/mongodb-driver-core/com/mongodb/ClientEncryptionSettings.Builder.html#kmsProviderSslContextMap(java.util.Map)>`__
          method.
 
+   .. tab::
+      :tabid: shell
+
+      .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/make_data_key.js
+         :start-after: start-create-tls
+         :end-before: end-create-tls
+         :language: javascript
+         :dedent:
+         :caption: make_data_key.js
+
    .. tab::
       :tabid: nodejs
 
@@ -75,4 +85,4 @@ a client certificate that your {+kmip-kms+} accepts:
 
          You must use certificates with `ECDSA keys <https://en.wikipedia.org/wiki/Elliptic_Curve_Digital_Signature_Algorithm>`__ 
          when using the Go driver.
-         
+         

source/includes/queryable-encryption/tutorials/automatic/kmip/client.rst

@@ -18,6 +18,16 @@
                :dedent:
                :caption: InsertEncryptedDocument.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+               :start-after: start-key-vault
+               :end-before: end-key-vault
+               :language: javascript
+               :dedent:
+               :caption: insert_encrypted_document.js
+
          .. tab::
             :tabid: nodejs
 
@@ -75,6 +85,16 @@
                :dedent:
                :caption: InsertEncryptedDocument.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+               :start-after: start-kmsproviders
+               :end-before: end-kmsproviders
+               :language: javascript
+               :dedent:
+               :caption: insert_encrypted_document.js
+
          .. tab::
             :tabid: nodejs
 
@@ -120,6 +140,16 @@
 
       .. tabs-drivers::
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+               :start-after: start-schema
+               :end-before: end-schema
+               :language: javascript
+               :dedent:
+               :caption: insert_encrypted_document.js
+
          .. tab::
             :tabid: nodejs
 
@@ -169,12 +199,20 @@
                :language: csharp
                :dedent:
                :caption: InsertEncryptedDocument.cs
+
       .. include:: /includes/quick-start/schema/further-reading-note.rst
 
    .. step:: Specify the Location of the {+shared-library+}
 
       .. tabs-drivers::
 
+         .. tab::
+            :tabid: shell
+
+            .. code-block:: none
+               // mongosh does not require you to specify the
+               // location of the {+shared-library+} 
+
          .. tab::
             :tabid: nodejs
 
@@ -242,6 +280,16 @@
                :dedent:
                :caption: InsertEncryptedDocument.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+               :start-after: start-client
+               :end-before: end-client
+               :language: javascript
+               :dedent:
+               :caption: insert_encrypted_document.js
+
          .. tab::
             :tabid: nodejs
 
@@ -280,4 +328,4 @@
                :end-before: end-client
                :language: go
                :dedent:
-               :caption: insert-encrypted-document.go
+               :caption: insert-encrypted-document.go

source/includes/queryable-encryption/tutorials/automatic/kmip/dek.rst

@@ -17,6 +17,16 @@
                :dedent:
                :caption: MakeDataKey.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/make_data_key.js
+               :start-after: start-kmsproviders
+               :end-before: end-kmsproviders
+               :language: javascript
+               :dedent:
+               :caption: make_data_key.js
+
          .. tab::
             :tabid: nodejs
 
@@ -73,6 +83,16 @@
                :dedent:
                :caption: MakeDataKey.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/make_data_key.js
+               :start-after: start-datakeyopts
+               :end-before: end-datakeyopts
+               :language: javascript
+               :dedent:
+               :caption: make_data_key.js
+
          .. tab::
             :tabid: nodejs
 
@@ -129,6 +149,16 @@
                :dedent:
                :caption: MakeDataKey.java
 
+         .. tab::
+            :tabid: shell
+
+            .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/make_data_key.js
+               :start-after: start-create-dek
+               :end-before: end-create-dek
+               :language: javascript
+               :dedent:
+               :caption: make_data_key.js
+
          .. tab::
             :tabid: nodejs
 
@@ -168,4 +198,4 @@
                :language: go
                :dedent:
                :caption: make-data-key.go
-               
+               

source/includes/queryable-encryption/tutorials/automatic/kmip/find.rst

@@ -18,6 +18,16 @@ a client that is not configured for automatic {+qe-abbr+}.
          :dedent:
          :caption: InsertEncryptedDocument.java
 
+   .. tab::
+      :tabid: shell
+
+      .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+         :start-after: start-find
+         :end-before: end-find
+         :language: javascript
+         :dedent:
+         :caption: insert_encrypted_document.js
+
    .. tab::
       :tabid: nodejs
 
@@ -61,4 +71,4 @@ a client that is not configured for automatic {+qe-abbr+}.
 The output of the preceding code snippet should look like this:
 
 .. literalinclude:: /includes/queryable-encryption/quick-start/find-output.out
-   :language: text
+   :language: text

source/includes/queryable-encryption/tutorials/automatic/kmip/insert.rst

@@ -17,6 +17,15 @@ snippet:
          :dedent:
          :caption: InsertEncryptedDocument.java
 
+   .. tab::
+      :tabid: shell
+
+      .. literalinclude:: /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/insert_encrypted_document.js
+         :start-after: start-insert
+         :end-before: end-insert
+         :language: javascript
+         :dedent:
+
    .. tab::
       :tabid: nodejs
 

source/includes/queryable-encryption/tutorials/automatic/kmip/key-vault-index.rst

@@ -15,6 +15,16 @@ Create a unique index on the ``keyAltNames`` field in your
          :dedent:
          :caption: MakeDataKey.java
 
+   .. tab::
+      :tabid: shell
+
+      .. literalinclude::  /includes/generated/in-use-encryption/queryable-encryption/mongosh/kmip/reader/make_data_key.js
+         :start-after: start-create-index
+         :end-before: end-create-index
+         :caption: make_data_key.js
+         :language: javascript
+         :dedent:
+
    .. tab::
       :tabid: nodejs
 
@@ -54,4 +64,4 @@ Create a unique index on the ``keyAltNames`` field in your
          :language: csharp
          :caption: MakeDataKey.cs
          :dedent:
- 
+ 

source/includes/tutorials/language-id-qe.rst

@@ -0,0 +1,60 @@
+.. tabs-drivers::
+
+   .. tab::
+      :tabid: java-sync
+
+      .. code-block:: java
+
+         // You are viewing the Java synchronous driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: shell
+
+      .. code-block:: javascript
+
+         // You are viewing the Mongosh driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: nodejs
+
+      .. code-block:: javascript
+
+         // You are viewing the Node.js driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: python
+
+      .. code-block:: python
+
+         # You are viewing the Python driver code examples.
+         # Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: csharp
+
+      .. code-block:: csharp
+
+         // You are viewing the C# driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+   .. tab::
+      :tabid: go
+
+      .. code-block:: go
+
+         // You are viewing the Golang driver code examples.
+         // Use the dropdown menu to select a different driver.
+
+      .. important::
+
+         When building or running the Golang code in this guide using 
+         ``go build`` or ``go run``, always include the ``cse`` build 
+         constraint to enable {+csfle-abbrev+}. See the following shell
+         command for an example of including the build constraint:
+
+         .. code-block:: bash 
+
+            go run -tags cse insert-encrypted-document.go