User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

Connect to Ataccama ONE Platform

Connecting ONE Desktop and Ataccama ONE lets you explore and modify metadata through ONE Desktop, combine data into virtual catalog items, or create complex DQ rules. The following guide describes how to connect to your ONE instance.

Prerequisites

  • ONE Desktop is set up and running.

  • ONE is running and can be accessed from the server where ONE Desktop is available.

  • ONE Desktop and ONE are using the same product version.

Create a new connection

  1. Open ONE Desktop.

  2. In ONE Explorer, select Create a new server.

    If you are adding a second ONE server, do this instead: in File Explorer > Servers, right-click Servers and select New > ONE Platform.

    The same option is available on the Servers and Databases tab that is by default part of your workspace.

  3. Provide a meaningful name for the server (Name) and the URL of your Ataccama ONE Platform (URL).

    New Ataccama ONE server
  4. Select an authentication option and configure it:

    • OpenID Connect or Basic

      We do not recommend using Basic authentication as in this case credentials need to be sent with every request, which makes it less secure. If possible, use OpenID Connect.

      With OpenID Connect, users are authenticated and authorized through Keycloak for the duration of their session. User credentials are only used to retrieve the necessary identity and access tokens at the beginning of the session.

      1. Provide your username and password.

    • OpenID Connect via Web Browser

      1. Select Login and confirm when prompted.

      2. Provide your credentials in the browser. If you are already authenticated, no action is required.

      3. Check the status of the connection in ONE Desktop. If the login was successful, the following message is shown: Authentication to ONE Platform through the browser succeeded.

  5. Once you have provided your credentials, test your connection.

  6. If no issues were detected, select Finish.

    If the connection could not be established, check Details for more information. To view the full error, select Show Stacktrace.

    Connection failed - details
  7. The new server now appears in ONE Explorer. To establish a connection to ONE, select Connect.

    Connect to server

    You can now browse your data and metadata through ONE Desktop and use them in ONE plans.

    Connected to server

    To disconnect from your ONE server, in File Explorer > Servers, right-click the server and select Disconnect. The same option is available on the Servers and Databases tab that is by default part of your workspace.

Manual server configuration

In some cases, the server configuration cannot be loaded automatically after providing the ONE URL. When this occurs, in the server configuration dialog, select Next to enter the information yourself.

As this approach is more error-prone and takes more time, it should only be used as a fallback option.
Manual server configuration
Property Description

URL

The URL where ONE is running. For example, https://+`+<CLIENT>.<ENV>.ataccama.online`.

Authentication

Select the authentication option and provide the necessary information.

  • Type: Basic, OpenID Connect, or OpenID Connect via Web Browser. We do not recommend using Basic authentication due to security concerns.

  • Token URL: The Keycloak URL. For example, https://<CLIENT>.<ENV>.ataccama.online/auth.

  • User: The username for ONE. Used for Basic and OpenID Connect authentication options.

  • Password: The user password. Used for Basic and OpenID Connect authentication options.

ONE Metadata Server

The following information needs to be specified for Metadata Management Module (MMM).

  • GraphQL URL: The GraphQL URL for ONE. For example, https://<CLIENT>.<ENV>.ataccama.online/graphql.

ONE Data Processing

The following information needs to be specified for Data Processing Manager (DPM).

Was this page useful?