For the complete documentation index, see llms.txt.

Manage applications

Last updated View as Markdown

Some AI tools, such as Gemini Enterprise, don't sign in to Contentsquare on their own. They ask for a Client ID and a Client secret when you set them up. To connect one of these tools, create an application in Contentsquare.

An application belongs to your Contentsquare account, not to an individual. Contentsquare sets the redirect URI and permissions for the tool you pick, so you don't enter anything technical by hand. An account can have up to 100 applications.

  • You're a Customer Admin on the Contentsquare account.
  • You can configure the external tool. For Gemini Enterprise, that means a Google Workspace or team administrator (Business edition), or Google Cloud IAM permissions to create data stores and apps (Vertex edition).
  • You have somewhere safe to store the Client secret, such as your company's password manager. The Client secret is shown only once.
  1. Click your profile and go to Account settings.
  2. Open Connected apps and select the Applications tab.
  3. Click Create application.
  4. Enter a name that helps you identify the application, such as Gemini Enterprise – Marketing team.
  5. In Connect to, select the external tool, such as Gemini Enterprise.
  6. Click Save.
  7. Copy the Client ID and Client secret from Your credentials and store them safely. Click the eye icon to show the secret.
  8. Click I copied my credentials to close the window.

The Client secret is shown only once, immediately after you create the application. If you lose it, rotate the secret.

Complete the setup in the external tool

Section titled Complete the setup in the external tool

Paste the Client ID and Client secret into the external tool, along with the other values it asks for: server URL, authorization URL, token URL, and scopes. For Gemini Enterprise, see Connect Gemini Enterprise.

A Client secret is valid for one year. Rotate it before it expires, if you lose it, or if it may have been shared with someone who should no longer have access. Rotating keeps the same Client ID, permissions, and connections. Only the secret changes.

  1. In the Applications tab, click Rotate secret on the application's row.
  2. Review the confirmation, then click Rotate secret.
  3. In the Your new Client secret window, copy the new secret. Like the first one, it's shown only once.
  4. Click I copied my new secret.
  5. Paste the new secret into the external tool within the hour to avoid losing access.

The old secret stops working as soon as you rotate it. The external tool keeps using its existing access until its next refresh, within one hour, unless you enter the new secret. Users don't need to authorize the tool again after a rotation.

If the secret has already expired, the tool is disconnected. It reconnects once it has the new secret. Users who haven't used the tool in the last 30 days need to authorize it again.

The Status column in the Applications tab shows Expiring soon 30 days before the expiration date, and Expired after the secret expires.

Renaming only changes the name shown in Contentsquare. The Client ID and Client secret stay the same, and the external tool needs no changes.

  1. In the Applications tab, click Rename on the application's row.
  2. Enter the new name.
  3. Click Save.

Deleting an application stops new connections immediately. Existing access stops within one hour.

  1. In the Applications tab, click Delete on the application's row.
  2. Check the application name and Client ID in the confirmation window.
  3. Click Delete.

Deletion can't be undone. To reconnect the tool, create a new application and configure the external tool with the new credentials.