Create an OpenAI connection to an Edge or Collibra Cloud site

Tip You can set up this integration in the unified integrations experience (in preview). This feature is in public preview and applies to metadata, AI, SAP, and lineage integrations. In one guided flow, you select an Edge site, create the connection, add the integration, and configure it. To get started, in the banner on the Integration configuration tab, click Try the new Integrations page. For more information, go to About the unified integrations experience (in preview).

After you install an Edge site or are granted a Collibra Cloud site, you can create an OpenAI connection to link your Edge or Collibra Cloud site to your OpenAI project.

Prerequisites

In your Collibra environment

  • To use the OpenAI integration, you need Collibra Platform 2026.09 or newer.

  • A separate Edge connection is required for each OpenAI project. OpenAI API keys are scoped to a single project, so a key issued in one project cannot access another. Create one connection per project, each using the API key for that specific project.

  • You either created and installed an Edge site or were granted a Collibra Cloud site.
    Note 

    If you have defined an outbound (forward) proxy on your Edge site, the integration will take that configuration into account when connecting to the AI platform. The following proxies are supported, using either a HTTP or HTTPS proxy URL:

    • Pass through (No authentication)
    • Pass through (Basic authentication)
    • No proxy for noProxy hosts defined by Edge

    This integration is not supported on Edge sites installed using a Man-in-the-middle (MITM) proxy.

  • If you want to add connection values from a vault, you have added the vault to your Edge site. If your data source connection requires a file from your vault, the file must be encoded into Base64 and stored as a regular secret in your vault. For more information, go to the Vault documentation.
    Note  Vaults are not supported on Collibra Cloud sites.
  • You have a global role that has the Manage connections and capabilities global permission, for example, Edge integration engineer.

In your OpenAI environment

  • You have created an OpenAI project API key (sk-proj-...) for the OpenAI project you want to integrate, with Read Only access to the /v1/models endpoint.
    Go to the OpenAI API documentation to generate an API key. For more information on API key permissions, go to the OpenAI Assign API Key Permissions documentation.

Steps

  1. Open a site.
    1. On the main toolbar, click Products icon → Cogwheel icon Settings.
      The Settings page opens.
    2. In the tab pane, click Edge.
      The Sites tab opens and shows a table with an overview of your sites.
    3. In the table, click the name of the site whose status is Healthy.
      The site page opens.
  2. In the Connections section, click Create connection.
    The Create connection page appears.
  3. Select the OpenAI connection to connect to OpenAI.
  4. Enter the required information.
    FieldDescriptionRequiredAvailable for vaults?
    Name

    The name of the Edge or Collibra Cloud site OpenAI connection.

    		 Yes No
    Description

    The description of the connection.

    		 No No
    Vault The vault where you store your data source values. No No
    OpenAI API Key

    The OpenAI project API key (sk-proj-...) for the OpenAI project you want to integrate. The secret is encrypted on Edge and cannot be revealed.

    		 Yes Yes
  5. Click Create.
    The connection is added to the Edge or Collibra Cloud site.
    The fields become read-only.

What's next

You can now add the OpenAI capability to an Edge or Collibra Cloud site.