DocumentDB Connector
Overview
- Pod Residency
-
nosql-scanner - Connection Method
-
URL connection via API
Supported Scan Actions
|
Scan Type |
Description |
|---|---|
|
Catalog |
This will fetch the list of shares and folder/files present in those shares. It collects the metadata also for these objects and send back to the main OneTrust app. |
|
Catalog & Scan |
This will fetch the list of Shares and Folder/Files present in those Shares. We collect the metadata and go for content extraction after that. It will return personally identifiable information (PII), data elements (DE), and Terms as per the classification label identified. |
Credentials and System Permissions
OneTrust recommends to adhere to your organization's security and infrastructure policy and include system engineer resources or other qualified subject matter experts to set up credentials on data sources. For specific instructions for how to enable these credentials, refer to your data source's implementation documentation, knowledge base and/or support resources.
The main credential will be a username/password combination with a TLS/SSL protocol specified. Read permissions will need to be applied to grant adequate access to specific database/collection being scanned as set in the scan profile.
Uploading Certificates to Worker Node
-
Download the region specific .pem key. The region is based on where the DocumentDB instance is deployed. The .pem keys can be found here.
-
On the Data Discovery menu, select to choose your desired worker node.
-
In the Worker Details screen, navigate to the Configurations tab then expand the Security section.
-
Enable the setting Client Certificates. A Certificate(s) field appears.
-
Open the downloaded .pem key file in a text editor and copy the contents.
-
Paste this into the Certificate(s) field.
-
Click the Save button.
-
Click the Update to push the updates to the worker node.
-
Review the update status and confirm. This may take a few minutes.
-
Update your credentials in AWS Secret Manager to the following format:
JSON{ "connectionUrl": "mongodb://USERNAME:PASSWORD@documentdb-host.docdb.amazonaws.com:27017/?tls=true" }
Confirming Virtual Peer Connection (VPC)
Navigate to the DocumentDB server and under Connectivity & Security, you will see the associated security group(s) and the respective VPC ID(s). Next, navigate to your Data Discovery EKS cluster and under Networking, check whether the VPC associated with the EKS cluster is the same as seen in the security group.
- If it's the same VPC
-
Allow the inbound access to 27017 on the DocumentDB security group for the EKS cluster.
- If it's not the same VPC
-
Set up a VPC peering between the DocumentDB VPC and the Kubernetes cluster VPC
-
Navigate to the list of VPCs and find the main route table used by the cluster VPC.
-
Click on the associated main route table, then select Edit Routes.
-
For “Destination”, include the CIDR for the DocumentDB VPC. For “Target”, select the VPC Peering.
-
Navigate to the security group associated with the DocumentDB server and add inbound rule to allow the Kubernetes cluster CIDR to port 27017 on DocumentDB.
-
Scan Profile Support
For additional details on scan profile configuration and management, see Setting Up Scan Profiles.
Limits
-
Number of databases
-
Collections per database
-
Documents per collection
Include Path Configuration
-
Database: database name
-
Collection: collection name
Collected Objects and Fields
Objects
|
Object |
Description |
|---|---|
|
Database |
A physical container for collections. Each database has its own set of files on the file system. A single MongoDB server typically has multiple databases. |
|
Collection |
A grouping of MongoDB documents. A collection is the equivalent of an RDBMS table. A collection exists within a single database. Collections do not enforce a schema. Documents within a collection can have different fields. Typically, all documents in a collection have a similar or related purpose. |
|
Document (Row) |
A record in a MongoDB collection and the basic unit of data in MongoDB. Documents are analogous to JSON objects but exist in the database in a more type-rich format known as BSON. |
|
Field (Column) |
A name-value pair in a document. A document can have zero or more fields. Fields are analogous to columns in relational databases. Metadata Collected
Note:
The remaining fields will be unique to each document structure and can be anything defined by the customer. |