# Setting general connection properties

This section describes how to configure general connection properties. For an explanation of how to configure advanced connection properties, see Setting advanced connection properties.

Information noteReplicate November 2024 Initial Release supports two-way authentication with the x.509 authentication method only. From Replicate November 2024 Service Release 1, you can configure mutual authentication for all authentication methods (except for None). This topic describes the available settings according to your Replicate version.

### Settings for Replicate November 2024 Service Release 1 or later

To add a MongoDB source endpoint to Qlik Replicate:

1. In the Qlik Replicate Console, click Manage Endpoint Connections to open the Manage Endpoints Connections dialog box. Then click the New Endpoint Connection button. For more information on adding an endpoint to Qlik Replicate, see [Defining and managing endpoints](https://help.qlik.com/en-US/replicate/November2024/Content/Global_Common/Content/SharedEMReplicate/Design%20Tasks/Work_with_Endpoints.htm).

2. In the Name field, type a name for your endpoint. This can be any name that will help to identify the database being used.

3. In the Description field, type a description that helps to identify the MongoDB database. This is optional.

4. Select Source as the endpoint role.

5. From the Type drop-down list, select MongoDB.

   Information note

   When this endpoint is used as a duplicated source in a Log Stream Staging setup, select the Read changes from log stream staging folder check box and then select the relevant Log Stream Staging task from the drop-down list.

   For information on setting up and managing Log Stream Staging tasks, see [Using the Log Stream](https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/Log%20Stream%20Staging/intro.htm).

6. Select Standard or MongoDB Atlas for MongoDB deployment.

7. For Standard deployment, configure the settings according to the following table:

   MongoDB Standard settings

   | Option | Description |
   | --- | --- |
   | Hosts | When working with a<br><br><br>MongoDB cluster, you can specify multiple hosts in the following format:<br><br>`host1[:port1][,...hostN[:portN]]`<br><br>Replicate<br>will try to connect to the first host. If it is unable to do so, it will then try to connect to the other hosts in the order they are listed. |
   | Authentication method | Select one of available authentication methods. When using x.509 authentication, you must also enable Use SSL and provide the Certificate Authority and Client Certificate settings described below. For all other authentication methods, Use SSL is optional.<br><br><ul> <li> <p>SCRAM-SHA-256</p> <p>Provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> <li><span>Authentication database name:</span>&nbsp;The name of the authentication database on which the specified user account is defined.</li> </ul> </li> <li> <p>SCRAM-SHA-1                                        </p> <p>Provide  the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> <li><span>Authentication database name:</span>&nbsp;The name of the authentication database on which the specified user account is defined.</li> </ul> </li> <li> <p>x.509</p> <p>When this option is selected, you must enable <span>Use SSL </span>(described below) and provide the <span>Certificate Authority </span>and <span>Client Certificate</span> settings. </p> </li> <li> <p>PLAIN (LDAP SASL)                                        </p> <p>When this authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> </ul> </li> <li><span>None</span> </li> </ul> |
   | Use SSL | Select to transfer data over an encrypted connection.<br><br>When this option is selected, you must also provide the following information:<br><br>Certificate Authority<br><br><ul> <li><span>Truststore file (in JKS format):</span> The full path of the truststore file on the <span>Replicate</span> Server machine. The trustore file should contain the CA certificate for verifying the MongoDB servers' certificates.</li> <li><span>Truststore Password:</span> The password for accessing your truststore.</li> </ul><br><br>Client Certificate<br><br>Information noteThese settings are not available when the authentication method is None.<br><br><ul> <li><span>Certificate subject:</span> The subject of your public key certificate.</li> <li><span>Keystore file (in JKS format):</span> The full path of the keystore file (containing your private key) on the <span>Replicate</span> Server machine.</li> <li><span>Keystore password:</span> The passphrase for accessing your keystore file.</li> </ul> |

   For MongoDB Atlas deployment, configure the settings according to the following table:

   MongoDB Atlas settings

   | Option | Description |
   | --- | --- |
   | Atlas hostname | When working with<br>MongoDB Atlas, you must specify the host in the following format:<br><br>`server.example.com` |
   | Authentication method | Select one of available authentication methods. When using x.509 authentication, you must also specify your client certificate settings. For all other methods, authentication using a client certificate is optional.<br><br><ul> <li> <p><span>SCRAM-SHA-1</span> </p> <p>When this authentication method is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> <li><span>Authentication database name:</span>&nbsp;The name of the authentication database on which the specified user account is defined.</li> </ul> </li> <li> <p><span>x.509</span> </p> <p>When this option is selected, you must provide the <span>Client Certificate</span> settings (described below). </p> </li> <li> <p><span>AWS IAM</span> </p> <p>With this authentication method, you use an <span>IAM credentials source</span> with one of the following options:</p> <ul> <li><span>Key pair:</span> Specify the <span>Access key</span>, the <span>Secret key</span>, and the <span>Session token (optional)</span>.</li> <li><span>Environment variables:</span> Must be set by the user.</li> </ul> </li> <li> <p><span>PLAIN (LDAP SASL)</span> </p> <p>When this authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> </ul> </li> </ul> |
   | Client Certificate | <ul> <li><span>Certificate subject:</span> The subject of your public key certificate.</li> <li><span>Keystore file (in JKS format):</span> The full path of the keystore file (containing your private key) on the <span>Replicate</span> Server machine.</li> <li><span>Keystore password:</span> The passphrase for accessing your keystore file.</li> </ul> |

### Settings for Replicate November 2024 Initial Release

To add a MongoDB source endpoint to Qlik Replicate:

1. In the Qlik Replicate Console, click Manage Endpoint Connections to open the Manage Endpoints Connections dialog box. Then click the New Endpoint Connection button. For more information on adding an endpoint to Qlik Replicate, see [Defining and managing endpoints](https://help.qlik.com/en-US/replicate/November2024/Content/Global_Common/Content/SharedEMReplicate/Design%20Tasks/Work_with_Endpoints.htm).

2. In the Name field, type a name for your endpoint. This can be any name that will help to identify the database being used.

3. In the Description field, type a description that helps to identify the MongoDB database. This is optional.

4. Select Source as the endpoint role.

5. From the Type drop-down list, select MongoDB.

   Information note

   When this endpoint is used as a duplicated source in a Log Stream Staging setup, select the Read changes from log stream staging folder check box and then select the relevant Log Stream Staging task from the drop-down list.

   For information on setting up and managing Log Stream Staging tasks, see [Using the Log Stream](https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/Log%20Stream%20Staging/intro.htm).

6. Select Standard or MongoDB Atlas for MongoDB deployment.

7. For Standard deployment, configure the settings according to the table below:

   Setting configurations

   | Option | Description |
   | --- | --- |
   | Hosts | When working with a<br><br><br>MongoDB cluster, you can specify multiple hosts in the following format:<br><br>`host1[:port1][,...hostN[:portN]]`<br><br>Replicate<br>will try to connect to the first host. If it is unable to do so, it will then try to connect to the other hosts in the order they are listed. |
   | Authentication method | Select one of the following:<br><br><ul> <li><span>SCRAM-SHA-256</span> </li> <li> <p><span>SCRAM-SHA-1</span> </p> <p>When one of the SCRAM authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> <li><span>Authentication database name:</span>&nbsp;The name of the authentication database on which the specified user account is defined.</li> </ul> </li> <li> <p><span>x.509</span> (Certificate) - To make this available for selection, first select the <span>Use SSL</span> option.</p> <p>When this authentication method is selected, you also need to provide the following information:</p> <ul> <li><span>Certificate subject:</span> The subject of your public key certificate.</li> <li><span>Keystore file (in JKS format):</span> The full path of the keystore file (containing your private key) on the <span>Replicate</span> Server machine.</li> <li><span>Keystore password:</span> The passphrase for accessing your keystore file.</li> </ul> </li> <li> <p><span>PLAIN (LDAP SASL)</span> </p> <p>When this authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> </ul> </li> <li><span>None</span> </li> </ul> |
   | Use SSL | Select to transfer data over an encrypted connection.<br><br>When this option is selected, you also need to provide the following information:<br><br><ul> <li><span>Truststore file (in JKS format):</span> The full path of the truststore file on the <span>Replicate</span> Server machine. The trustore file should contain the CA certificate for verifying the MongoDB servers' certificates.</li> <li><span>Truststore Password:</span> The password for accessing your truststore.</li> </ul> |

   For MongoDB Atlas deployment, configure the settings according to the table below:

   Setting configurations

   | Option | Description |
   | --- | --- |
   | Atlas hostname | When working with<br>MongoDB Atlas, you must specify the host in the following format:<br><br>`server.example.com` |
   | Authentication method | Select one of the following:<br><br><ul> <li> <p><span>SCRAM-SHA-1</span> </p> <p>Whenthis authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> <li><span>Authentication database name:</span>&nbsp;The name of the authentication database on which the specified user account is defined.</li> </ul> </li> <li> <p><span>x.509</span> (Certificate) - To make this available for selection, first select the <span>Use SSL</span> option.</p> <p>When this authentication method is selected, you also need to provide the following information:</p> <ul> <li><span>Certificate subject:</span> The subject of your public key certificate.</li> <li><span>Keystore file (in JKS format):</span> The full path of the keystore file (containing your private key) on the <span>Replicate</span> Server machine.</li> <li><span>Keystore password:</span> The passphrase for accessing your keystore file.</li> </ul> </li> <li> <p><span>AWS IAM</span> </p> <p>With this authentication method, you use an <span>IAM credentials source</span> with one of the following options:</p> <ul> <li><span>Key pair:</span> Specify the <span>Access key</span>, the <span>Secret key</span>, and the <span>Session token (optional)</span>.</li> <li><span>Environment variables:</span> Must be set by the user.</li> </ul> </li> <li> <p><span>PLAIN (LDAP SASL)</span> </p> <p>When this authentication methods is selected, you also need to provide the following information:</p> <ul> <li><span>User name:</span> Specify the user name of a user with <a href="https://help.qlik.com/en-US/replicate/November2024/Content/Replicate/Main/MongoDB_Source/mongo_prereq.htm#role">the required role</a>.</li> <li><span>Password:</span> Specify the password of the above user.</li> </ul> </li> </ul> |