Configure connections

Connections link ​ValidMind with the external systems your teams already use.

Each connection enables you to authenticate and keep events flowing between platforms such as Jira, ServiceNow, AWS SageMaker, MLflow, and GitLab.

Prerequisites

• You are logged in to ValidMind.
• You can manage workspace settings.¹
• The integration’s required secrets already exist in integration secrets.²
• You coordinated with the external system owner to obtain the required credentials and configuration details for the connection.

¹ Manage permissions

² Manage secrets

Supported connections

Jira

A project tracking tool that teams use to plan work, track progress, and manage issues across a project lifecycle.

Required configuration details:

jira instance url

The base URL for your Cloud or Server deployment, such as https://yourcompany.atlassian.net.

personal access token

The secret that stores a Jira PAT with read:jira-work and write:jira-work scopes.

jql query (optional)

Limits synced issues by project, status, or labels. Leave blank to sync all tickets.

ServiceNow

An IT service management platform that helps teams handle requests incidents assets and other operational workflows.

Required configuration details:

servicenow instance url

The base URL for your ServiceNow environment.

authentication method

Username and password or another supported method, such as OAuth.

username

The ServiceNow username.

password

The secret that stores the ServiceNow password.

servicenow board

The board or table that receives linked tickets.

Amazon SageMaker

An ML development service that lets teams build train and deploy models at scale.

Required configuration details:

aws region

The primary region where your SageMaker model registry lives, for example us-west-2.

aws access key id

The secret generated by AWS IAM with permissions to read the model registry.

aws secret access key

The secret generated by AWS IAM with permissions to read the model registry.

MLflow

An open-source toolset that tracks experiments packages models and manages their deployment.

Required configuration details:

tracking uri

The tracking server endpoint, such as https://mlflow.example.com:5000.

username

The MLflow username.

password

The secret that stores the MLflow password.

GitLab

A DevOps platform that hosts code, runs pipelines, and manages team collaboration.

Required configuration details:

project id

The GitLab project or group path that contains the ML repository to sync.

gitlab instance url (optional)

Blank for gitlab.com or the self-hosted URL.

personal access token

A PAT secret that includes the api or read_api scope.

Add connections

1. In the left sidebar, click Settings.

2. Under Integrations, select Connections.

3. Click Add Connection.

4. In the modal that opens, select one of the supported connections, such as MLflow or Jira.

5. Enter in the:

   • integration name — How other admins can identify the connection.
   • description (optional) — The intended usage or additional details.
   • Connection-specific fields,³ such as:
     • tracking uri — The identifiers needed for the connection.
     • password — The secret that stores the secret key, password, or token required by the external service.
   • initial status — Set to Operational to enable immediately or Disabled if you plan to finish setup later.

6. Click Save Integration.

³ Supported connections

You can now test the connection to ensure it is working as expected.

View details

1. In the left sidebar, click Settings.

2. Under Integrations, select Connections.

3. Click the connection you want to view.

Edit connections

1. In the left sidebar, click Settings.

2. Under Integrations, select Connections.

3. Click the connection you want to edit.

4. In the modal that appears, click Edit Connection.

5. Make your changes. For example:

   • tracking uri — Change the URI needed for the connection.
   • password — Change the secret that stores the secret key, password, or token required by the external service.

6. Click Update Integration to save your changes.

Test connections

1. In the left sidebar, click Settings.

2. Under Integrations, select Connections.

3. Hover over the connection you want to test.

4. When the menu appears, click on it and select Test Connection.

If the test is successful, the message Connection successful displays.

Delete connections

WarningDeleting a connection is permanent.

1. In the left sidebar, click Settings.

2. Under Integrations, select Connections.

3. Hover over the connection you want to remove.

4. When the menu appears, click on it and select Delete Connection.

5. In the confirmation dialog, select OK to confirm deletion.