Skip to content

Register Repositories

Registering a repository provides ALTR the database’s name, hostname, and port, for use by the sidecar or an agent.

  • A database exists that you want to register as a repository.
  • You plan to connect to this repository through the sidecar or an agent. Neither needs to be installed yet to register the repository itself; contact ALTR Support to get started with either.

To register a database as a repository:

  1. Log in to ALTRNet through your identity provider (IdP).
  2. Select Data Configuration > Data Sources in the navigation menu.
  3. Click Add Data Source.
  4. Locate the data source card for the database and click Select. To register a Snowflake account for agent-based monitoring by Security Intelligence Scout, choose Snowflake Agent Repository rather than the Snowflake card, which connects a Snowflake data source for policy enforcement.
  5. Enter a Repository Name to identify the repository in ALTR’s control plane. The name must be unique, 32 characters or fewer, and use only lowercase letters, numbers, and underscores.
  6. Enter the Hostname. The hostname must be in RFC 1123 format – a URL without http://. For example: 123.dbhost.com. For a Snowflake Agent Repository, this is the account’s hostname, as in xy12345.us-east-1.snowflakecomputing.com.
  7. Enter the Port number of the database’s configured listening port. The sidecar uses this port to connect to the repository. For example: 1521. A Snowflake Agent Repository defaults to port 443.
  8. Click Save. ALTRNet adds the repository to the Data Sources list.

Removing a repository from ALTR prevents any sidecar from accessing it. Before removing a repository, remove all sidecar listener port bindings that tie a sidecar to it – see Bind a Sidecar Listener Port to a Repository.

To remove a repository from ALTR:

  1. Log in to ALTRNet through your IdP.
  2. Select Data Configuration > Data Sources in the navigation menu.
  3. Select Repositories from the Type dropdown.
  4. Click the repository to view its details.
  5. Click Remove Data Source. ALTRNet displays a confirmation modal.
  6. Click Remove Data Source to confirm.