Axonius Documentation
Start typing to search…

MongoDB

MongoDB is a document-oriented NoSQL database.

Asset Types Fetched

  • Devices, Users

Before You Begin

Ports

  • TCP port 80/443

Authentication Method

  • User Name/Password

Permissions

Consult with your vendor for permissions for reading the objects.

Connecting the Adapter in Axonius

To connect the adapter in Axonius, provide the following parameters:

Required Parameters

  1. MongoDB Server - The hostname or IP address of the MongoDB server.
📘

Note

If configuring the adapter to communicate to a MongoDB Atlas cluster, you must configure mongo+srv:// as a prefix in the MongoDB Server name and TLS must be enabled.

  1. Port - The port to be used in the connection.
  2. User Name and Password - The credentials for a user account that has the permissions to fetch assets.
  3. Database - The name of the MongoDB database.
MongoDB(1)

Optional Parameters

  1. Use TLS - Toggle this option to enable Transport Layer Security (TLS).
    • CA Certificate (optional) - The CA certificate MongoDB deployment presents for the application to establish its identity. Click Upload File to upload a CA certificate. For more information, see Specify a CA File.
    • Certificate Key (optional) - The client’s certificate and private key. Your client certificate and private key must be in the same .pem file. If they are stored in different files, you must concatenate them. Click Upload File to upload a certificate key. For more information, see Present a Client Certificate.
    • Certificate Key Password (optional) - The password to the client’s certificate and private key file.
  2. Use LDAP Authorization - Enable this option to use LDAP authorization.
  3. Devices Collection - The name of the devices collection in the MongoDB database.
  4. Users Collection - The name of the users collection in the MongoDB database.
📘

Note

You have to enter a name for either Devices Collection or Users Collection.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

📘

Note

Advanced settings can either apply to all connections for this adapter, or to a specific connection. Refer to ​Advanced Configuration for Adapters.

  1. Sensitive Fields to exclude (default: credentials) - Enter a list of sensitive fields to exclude from the raw data.
  2. Custom Parsing - See Adapter Custom Parsing for more information.
📘

Note

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.

Updated 1 day ago