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

# Settings

> You can access your *Settings* page by clicking the Gear Icon in the upper-right corner of the dashboard and selecting **Settings**.

<Frame>
  <img src="https://mintcdn.com/cdata/8B5SN8TlQOoh6rM4/en/images/access_settings.png?fit=max&auto=format&n=8B5SN8TlQOoh6rM4&q=85&s=78b7315b452e5748e535351fb87d6764" alt="Access settings" width="206" height="74" data-path="en/images/access_settings.png" />
</Frame>

The Settings page contains the following tabs (depending on your Connect AI plan):

* [**Profile**](#profile)
* [**Account**](#account)
* [**Security**](#security)
* [**Personal Access Tokens**](#personal-access-tokens)
* [**OAuth Apps**](#oauth-apps)
* [**Keys**](#keys)
* [**Billing**](#billing)

The following sections describe these tabs.

## Profile

The **Profile** tab opens by default when you access Settings. This tab contains settings for the account you are currently signed in with.

<Frame>
  <img src="https://mintcdn.com/cdata/XuhSyq2ZmCUM5zmX/en/images/settings_profile.png?fit=max&auto=format&n=XuhSyq2ZmCUM5zmX&q=85&s=d6e47551dd894ddcb7d9bd4c5b2e670d" alt="Settings profile" width="856" height="901" data-path="en/images/settings_profile.png" />
</Frame>

In the **User Profile** section, you can edit the first name and last name for the current user. Your user role appears in the **Role** text box, but it cannot be edited on this page. See [Users and Roles](/en/Users) for more information about roles.

You can change the email that you use to log in by entering the new email and clicking **Save Changes**. If you want to reset your password, click **Reset Password**. This action sends a password reset email to the email address that appears in **Email**.

<Note>If you are an SSO user, you must contact the administrator in your organization to change your email and/or password.</Note>

In the **Grant Support Access** section, administrators can toggle support access on so that the CData support team can log in and help troubleshoot issues for the users in the administrator's account. Administrators can revoke access at any time by disabling this setting.

Click **Save Changes** to save the selection. Then click **Accept** in the **Grant Support Access** dialog to agree to the terms and conditions of granting support access.

<Note>This feature is enabled for administrators only. Query users can contact their administrator to grant support access to their accounts.</Note>

## Account

The **Account** tab provides access to account-wide settings.

<Frame>
  <img src="https://mintcdn.com/cdata/XuhSyq2ZmCUM5zmX/en/images/settings_account.png?fit=max&auto=format&n=XuhSyq2ZmCUM5zmX&q=85&s=7676f18bcfd39b1ca75d101e2c61f44c" alt="Settings account" width="834" height="1006" data-path="en/images/settings_account.png" />
</Frame>

The sections of this page are described below.

### Details

The **Details** section lists the following global account information:

* Organization Name
* Account Id
* Country

### Primary Contact Information

This section contains the following fields that define the account's primary contact for invoices, announcements, and other communication. These fields can only be edited by administrators.

* First name
* Last name
* Email
* Phone Number
* Country

<Note>
  The email in this section is not the user login email. Change the login email in the **Profile** tab.
</Note>

### Delete Account

If you want to delete your Connect AI account and all of its data, click **Contact Sales** for assistance.

<Note>
  Account deletion is permanent. If you delete your account and later want to use Connect AI again, you must create a new account.
</Note>

## Security

The security settings on this tab are applied globally.

<Frame>
  <img src="https://mintcdn.com/cdata/TNoLsmFzTAGO3RuW/en/images/settings_security.png?fit=max&auto=format&n=TNoLsmFzTAGO3RuW&q=85&s=2a331815fd330cebd0113a7ef8e53793" alt="Settings security" width="870" height="569" data-path="en/images/settings_security.png" />
</Frame>

### Personal Access Token Expiration

This section allows you to set a global Personal Access Token (PAT) expiration (such as **30 Days**, **60 Days**, or **Never Expire**). Shorter durations improve security. When the PAT expires, the PAT displays **Expired** in the **Security** tab of **Settings**, and any authentication using the PAT fails with an `"Invalid personal access token"` error.

To create a PAT, see [Personal Access Tokens](#personal-access-tokens).

### Default Connection & Workspace Permissions

From the drop-down list, select the default permissions granted to new users for all connections and workspaces. Options include **No Permissions** to connections and workspaces by default or **Select Only** permissions to connections and workspaces by default.

<Note>This setting does not affect the connection and workspace access of existing users.</Note>

### Data Copilot Access

Toggle this feature off if you do not want your users to have access to [Data Copilot](/en/Data-Copilot).

### MCP Connectivity

Toggle this feature off if you do not want your users to have access to any MCP-related functionality.

### SSO

**Just-in-Time (JIT) User Provisioning** automatically provisions new users the first time they sign in to an SSO-enabled domain.

<Frame>
  <img src="https://mintcdn.com/cdata/BVI_pWskwfkvIuSe/en/images/settings_sso.png?fit=max&auto=format&n=BVI_pWskwfkvIuSe&q=85&s=b60c22f0afbb495ad9c766a58034d345" alt="Settings SSO" width="1447" height="281" data-path="en/images/settings_sso.png" />
</Frame>

To enable JIT user provisioning:

<Steps>
  <Step>
    Enable the toggle for a domain to turn on JIT provisioning.
  </Step>

  <Step>
    Select the **JIT User Role** for new JIT users.
  </Step>

  <Step>
    Select the **JIT Access Role** for new JIT users.
  </Step>

  <Step>
    Click **Save Changes**.
  </Step>
</Steps>

See [User Provisioning and SSO](/en/SCIM) for more information about JIT. See [Users and Roles](/en/Users) for more information about user roles and access roles.

## Personal Access Tokens

Personal access tokens (PATs) are used when you connect to your data through the [REST API](/en/API/REST-API), the [OData protocol](/en/Data-Sources/OData), or the [Virtual SQL Server](/en/SQL-Server). You can create and manage your PATs on this tab.

<Frame>
  <img src="https://mintcdn.com/cdata/XuhSyq2ZmCUM5zmX/en/images/settings_pat.png?fit=max&auto=format&n=XuhSyq2ZmCUM5zmX&q=85&s=bb0ad57879755bbb97433134713a333d" alt="Settings PAT" width="852" height="171" data-path="en/images/settings_pat.png" />
</Frame>

### Create a PAT

Follow these steps to create a new PAT:

<Steps>
  <Step>
    Click **Create PAT**.
  </Step>

  <Step>
    Enter a name for the PAT in the dialog that appears. It might be useful to enter a name that indicates its purpose.
  </Step>

  <Step>
    Click **Create** and a new dialog appears.
  </Step>

  <Step>
    Click the copy icon in that dialog to copy the PAT to your clipboard. The icon is to the right of the token field.
    <Note>You cannot view the PAT again after you close this dialog.</Note>

    <Frame>
      <img src="https://mintcdn.com/cdata/XuhSyq2ZmCUM5zmX/en/images/pat_created.png?fit=max&auto=format&n=XuhSyq2ZmCUM5zmX&q=85&s=42a64bffb20e08be2b22dcff050be10a" alt="PAT created" width="903" height="273" data-path="en/images/pat_created.png" />
    </Frame>
  </Step>

  <Step>
    Click **Close** to close the dialog. The new PAT appears in the list and includes its **Creation Date** and **Expiration Date**.

    <Note>
      The PAT expiration date is set globally in the **Security** tab.
    </Note>
  </Step>
</Steps>

### Regenerate a PAT

To regenerate a PAT, click the regeneration icon in the PAT list and follow the prompts.

<Frame>
  <img src="https://mintcdn.com/cdata/ObQJe279PZTmgRsQ/en/images/pat_regen.png?fit=max&auto=format&n=ObQJe279PZTmgRsQ&q=85&s=8c45da675d0b0dd46e5e85701bff9cde" alt="Regenerate PAT" width="1499" height="108" data-path="en/images/pat_regen.png" />
</Frame>

<Note>
  Regenerating a PAT revokes access for any applications that use the PAT. Therefore, you must enter the newly generated PAT in any such applications.
</Note>

### Delete a PAT

To delete a PAT that you no longer use, click the delete icon in the PAT list.

<Frame>
  <img src="https://mintcdn.com/cdata/ObQJe279PZTmgRsQ/en/images/pat_delete.png?fit=max&auto=format&n=ObQJe279PZTmgRsQ&q=85&s=21496a82be58820109f1ec7df1d6bfef" alt="Delete PAT" width="1499" height="108" data-path="en/images/pat_delete.png" />
</Frame>

Click **Confirm** in the confirmation dialog that is displayed.

<Note>
  Deleting a PAT revokes access for any applications that use the PAT. Therefore, you must create a new PAT and enter it into those applications to restore this access.
</Note>

## OAuth Apps

The **OAuth Apps** tab allows you to generate a custom OAuth application for client integrations. It contains a list of available OAuth apps, including their application type and creation date.

<Frame>
  <img src="https://mintcdn.com/cdata/z1KLYCWnZisxWQoa/en/images/settings_oauth.png?fit=max&auto=format&n=z1KLYCWnZisxWQoa&q=85&s=11cbbc49801974a8bfd526ff6c415f9e" alt="Settings OAuth" width="1438" height="220" data-path="en/images/settings_oauth.png" />
</Frame>

### Create a Custom OAuth Application

To create a custom OAuth application:

<Steps>
  <Step>
    Click **+ Create App**. The **Create OAuth App** dialog appears.

    <Frame>
      <img src="https://mintcdn.com/cdata/z1KLYCWnZisxWQoa/en/images/settings_oauth_create.png?fit=max&auto=format&n=z1KLYCWnZisxWQoa&q=85&s=4d0614e9d733b6b77510d141cc704f5f" alt="Create OAuth App" width="801" height="703" data-path="en/images/settings_oauth_create.png" />
    </Frame>
  </Step>

  <Step>
    Enter the **Name** of the OAuth app.
  </Step>

  <Step>
    Select the **Application Type** for your OAuth application.

    * **Web Application**–select this option for service-side apps with a client secret Authorization Code grant. A client secret is required.
    * **Single Page App**–select this option for browser-based Authorization Code + PKCE grant. No client secret is required.
    * **CLI/Local Agent**–select this option for command-line tools. No client secret is required.
    * **Service/Machine to Machine**–select this option for backend services where there is no user involvement. A client secret is required. When you select this application type, you must also select the **User** for whom the OAuth app will run. You can create a user name specifically for this purpose.
  </Step>

  <Step>
    Go to your client application and create a new application registration there. The client application will provide a callback URL.
  </Step>

  <Step>
    Return to the **Create OAuth App** dialog in Connect AI and paste the **Callback URL** from the client application. This URL redirects users after login. You can provide up to 10 callback URLs for your OAuth app.
  </Step>

  <Step>
    Click **Confirm**. Connect AI creates the OAuth app and generates a **Client Id** and **Client Secret** for the client application. Copy these values.

    <Frame>
      <img src="https://mintcdn.com/cdata/z1KLYCWnZisxWQoa/en/images/settings_oauth_clientidsecret.png?fit=max&auto=format&n=z1KLYCWnZisxWQoa&q=85&s=ce7c7652ad449cb7ef9bf9cee98fe315" alt="OAuth App Client Id and Secret" width="1460" height="534" data-path="en/images/settings_oauth_clientidsecret.png" />
    </Frame>
  </Step>

  <Step>
    Return to the client application and paste the **Client Id** and **Client Secret** in the appropriate fields. For example, in Gemini Enterprise:

    <Frame>
      <img src="https://mintcdn.com/cdata/4FwGiNFIages-Ark/en/images/gemini_enterprise_datastore_auth.png?fit=max&auto=format&n=4FwGiNFIages-Ark&q=85&s=d90e377953390dc6fe849269195711b2" alt="Client Id and Client Secret" width="3024" height="1724" data-path="en/images/gemini_enterprise_datastore_auth.png" />
    </Frame>
  </Step>

  <Step>
    The new OAuth app appears in the list of apps. Click the edit icon (<Icon icon="pencil" />) to edit the app and add more callback URLs for other client applications, if needed.
  </Step>
</Steps>

Your external system might ask for information about the CData authorization, token, and registration URLs. They are as follows:

| Endpoint                      | Value                                                                                  |
| :---------------------------- | :------------------------------------------------------------------------------------- |
| **Authorization URL**         | [https://cloud-login.cdata.com/authorize](https://cloud-login.cdata.com/authorize)     |
| **Token URL**                 | [https://cloud-login.cdata.com/oauth/token](https://cloud-login.cdata.com/oauth/token) |
| **Registration URL**          | [https://mcp.cloud.cdata.com/register](https://mcp.cloud.cdata.com/register)           |
| **Authorization server base** | [https://mcp.cloud.cdata.com](https://mcp.cloud.cdata.com)                             |
| **Resource**                  | [https://mcp.cloud.cdata.com/mcp](https://mcp.cloud.cdata.com/mcp)                     |

## Keys

Connect AI supports storing data source authentication information in key vaults. Instead of entering authentication information directly in the **Add Connection** page for your data source, you enter the name of the key vault. You can then update the information in the key vault without affecting your data connection.

<Note>
  * Currently supports Azure Key Vault. Support for additional key vault providers is planned.
  * Available for Business tier in Connect AI only.
  * Not available for Connect AI Embed.
</Note>

### Create a New Key Vault

<Steps>
  <Step>
    Click **+ Add Vault**. The **Add Azure Key Vault** dialog appears.
  </Step>

  <Step>
    Enter the **Vault Name** of your Azure key vault.
  </Step>

  <Step>
    Enter the **Vault URI**, which can be found on the **Overview** page of your Azure Portal.
  </Step>

  <Step>
    Enter the **Application Id**, also known as the **Client Id**. This value can be found on the **Overview** page of your Azure Portal.
  </Step>

  <Step>
    Enter the **Directory Id**, also known as the **Tenant Id**. This value can be found on the **Overview** page of your Azure Portal.
  </Step>

  <Step>
    Click **Confirm** to save your credentials. If successfully saved, the new key vault appears in the list of key vaults, along with the **Key Vault URL** and **Creation Date**.
  </Step>
</Steps>

Once you create a new key vault, you can use the key vault as a credential for data source connections.

### Delete a Key Vault

To delete a key vault that you no longer use, click the delete icon in the key vault list.

## Billing

The **Billing** tab provides information and controls for your account plan and usage.

<Frame>
  <img src="https://mintcdn.com/cdata/ObQJe279PZTmgRsQ/en/images/settings_billing.png?fit=max&auto=format&n=ObQJe279PZTmgRsQ&q=85&s=897b9e90dea45617624350633fa523d8" alt="Settings billing" width="888" height="440" data-path="en/images/settings_billing.png" />
</Frame>

This tab consists of the following:

* The **Billing** section displays your plan information and next billing date.
  * Click **Manage Payment Method** to open your account with Stripe. You can manage your billing settings, such as your payment method and billing address. If your subscription has lapsed, you must reactivate your plan to continue using Connect AI.
  * The **Update Plan** section on the right (if applicable) contains information about contacting the Connect AI sales team. You can also email [sales@cdata.com](mailto:sales@cdata.com).
  * If you are on a free trial account, this section displays your trial information.
* The **Additional Usage** section displays what is remaining in your current plan.
