> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cassandra

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        For more information about interactions between {siteName} and {datasource}, see{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a>.
      </p>
    </>;
};

export const CommonAuthSchemeKerberos = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with Kerberos, specify these settings:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>Kerberos</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your {datasource} account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your {datasource} account.</li>
        <li><strong>Kerberos KDC:</strong> Enter the host name or IP address of your Kerberos Key Distribution Center (KDC) machine.</li>
        <li><strong>Kerberos Realm:</strong> Enter the Kerberos realm that you use to authenticate to Kerberos.</li>
        <li><strong>Kerberos SPN:</strong> Enter the service principal name (SPN) for the Kerberos domain controller.</li>
        <li><strong>Kerberos User:</strong> Enter the principal name for the Kerberos Domain Controller. The name should be in the form <strong><em>Host</em>/<em>User</em>@<em>Realm</em></strong>.</li>
        <li>(Optional) <strong>Kerberos Keytab File:</strong> Enter the full file path to your Kerberos keytab file.</li>
        <li>(Optional) <strong>Kerberos Ticket Cache:</strong> Enter the full file path to an MIT Kerberos credential cache file.</li>
      </ul>
    </>;
};

export const CommonAuthSchemeBasic = ({siteName = "CData Sync", siteNameShort = "Sync", datasource = "the data source"}) => {
  return <>
      <p>To connect with your user credentials, set the following properties:</p>
      <ul>
        <li><strong>Auth Scheme:</strong> Select <strong>Basic</strong>.</li>
        <li><strong>User:</strong> Enter the username that you use to authenticate to your {datasource} account.</li>
        <li><strong>Password:</strong> Enter the password that you use to authenticate to your {datasource} account.</li>
      </ul>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        To enable {siteNameShort} to use data from {datasource}, you first must add the
        connector, as follows:
      </p>
      <ol>
        <li>Open the <strong>Connections</strong> page of the {siteNameShort} dashboard.</li>
        <li>Click <strong>Add Connection</strong> to open the <strong>Select Connectors</strong> page.</li>
        <li>
          Click the <strong>{destination ? "Destinations" : "Sources"}</strong> tab and locate
          the <strong>{title}</strong> row.
        </li>
        <li>
          Click the <strong>Configure Connection</strong> icon at the end of that row to open
          the <strong>New Connection</strong> page. This action opens the{' '}
          <strong>Add Connection</strong> dialog box.
          <br />
          <strong>Note:</strong> If the <strong>Configure Connection</strong> icon is not
          available, click the <strong>Download Connector</strong> icon to install
          the {title} connector.
        </li>
        <li>Enter a name for your connection in the <strong>Add Connection</strong> dialog box.</li>
        <li>Click <strong>Add</strong> to open the <strong>Settings</strong> tab for your connector.</li>
      </ol>
      <p>
        For more information about installing new connectors, see{' '}
        <a href="../connections">Connections</a>.
      </p>
    </>;
};

export const CommonDatasourceIntroDestination = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      You can use the {datasource} connector from the {siteName} application to move data
      from any supported source to the {datasource} destination. To do so, you need to add
      the connector, authenticate to the connector, and complete your connection.
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

<CommonDatasourceIntroDestination datasource="Cassandra" siteName={siteName} />

## Add the Cassandra Connector

<CommonDatasourceAddConnector datasource="Cassandra" title="Cassandra" destination={true} siteNameShort={siteNameShort} />

## Authenticate to Cassandra

After you add the connector, you need to set the required properties.

* **Server:** Enter the host name or the IP address of the server that hosts the Cassandra database. The default host name is **localhost**.
* **Port:** Enter the port number of the server that hosts the Cassandra database. The default port value is **9042**.

{siteName} supports authenticating to Cassandra in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**Basic**](#basic) (default)
* [**DataStax Enterprise**](#datastax-enterprise)
* [**Kerberos**](#kerberos)
* [**LDAP**](#ldap)

### Basic

<CommonAuthSchemeBasic siteName={siteName} datasource="Cassandra" />

**Note:** In the cassandra.yaml file, you also need to set the **authenticator** property to **PasswordAuthenticator**.

### DataStax Enterprise

To connect with DataStax Enterprise credentials, specify the following properties:

* **Auth Scheme:** Select **DSE**.
* **User:** Enter the username that you use to authenticate to the Cassandra database.
* **Password:** Enter the password that you use to authenticate to the Cassandra database.

**Note:** In the cassandra.yaml file, you also need to set the **authenticator** property to **com.datastax.bdp.cassandra.auth.DseAuthenticator**.

### Kerberos

<CommonAuthSchemeKerberos siteName={siteName} datasource="Cassandra" />

**Note:** In the cassandra.yaml file, you also need to set the **authenticator** property to **com.datastax.bdp.cassandra.auth.DseAuthenticator**.

### LDAP

To connect with LDAP credentials, specify the following properties:

* **Auth Scheme:** Select **LDAP**.

* **LDAP Server:** Enter the host name or the IP address of your LDAP server.

* **User:** Enter the username that you use to authenticate to the Cassandra database.

* **Password:** Enter the password that you use to authenticate to the Cassandra database.

* **LDAP Password:** Enter the password of the default LDAP user.

  **Note:** You must set the password if the LDAP server does not allow anonymous bind.

* **LDAP Port:** Enter the port for your LDAP server. The default port is **389**.

* **Default LDAP User:** Enter the default LDAP user used to connect to and communicate with the server, it must be set if the LDAP server do not allow anonymous bind.

* **Search Base:** Enter the user-lookup search base for your LDAP server.

* **Search Filter:** Enter the search filter that you want to use to look up usernames in LDAP. The default setting is **(uid=)**

**Note:** In the cassandra.yaml file, you also need to set the **authenticator** property to **com.datastax.bdp.cassandra.auth.DseAuthenticator**.

## Complete Your Connection

To complete your connection:

1. Specify the following properties:
   * (Optional) **Database:** Enter the name of the Cassandra keyspace that contains your tables.
   * **Use SSL** Select whether you want to enable Secure Sockets Layer (SSL). By default, the **Enable** checkbox is not selected.
   * **Consistency Level:** Select the level that determines the number of the replicas from which you want to enforce a response before queries are considered a success. The default level is **ONE**.
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. Click **Create & Test** to create your connection.

## More Information

<CommonDatasourceMoreInformation datasource="Cassandra" advancedurl="RC" siteName={siteName} driverVersion={driverVersion} />