Skip to content

ALTR refers to databases protected by sidecars as repositories . Repositories must be registered in ALTR so that sidecars can facilitate secure connections between data consumers and databases. Learn more.

To register the database as a repository:

  1. Log into ALTR via Okta.
  2. Select Data ConfigurationData Sources in the Navigation menu.
  3. Click Add Data Source .
  4. Locate the data source card and click Select .
  5. Enter a Repository Name to identify the repository in ALTR’s control plane. The repository name must be unique, use only lowercase letters and contain no spaces.
  6. Enter the Hostname . The hostname must be in RFC 1123 format, which is a URL without http:// . Example: 123.dbhost.com
  7. Enter the Port number of its configured listening port. This port is leveraged when ALTR’s sidecar connects to the repository. Example: 1521
  8. Click Save .

Removing a repository from ALTR prevents sidecars from being able to access the repository. Before removing a repository, remove all bindings that tie sidecars to this repository.

To remove a repository from ALTR:

  1. Log into ALTR via Okta.
  2. Select Data ConfigurationData Sources in the Navigation menu.
  3. Select Repositories from the Type dropdown.
  4. Click the repository to view details.
  5. Click Remove Data Source ; a modal displays to confirm.
  6. Click Remove Data Source .

Registering a repository user enables ALTR’s sidecar to access database credentials, which are used when data consumers access repositories using single sign-on.

To register a repository user:

  1. Log into ALTR via Okta.
  2. Select Data ConfigurationData Sources in the Navigation menu.
  3. Select Repositories from the Type dropdown.
  4. Click the repository.
  5. Click the Users tab.
  6. Click Register Repository User .
  7. Enter the repository username in Username . This is the username for the relevant database credential.
  8. Select the Secret Source . Options are:
  • AWS Secrets Manager
  • Azure Key Vault
  1. Populate applicable fields. These are copied directly from the secret source:
    1. AWS Secrets Manager: Enter the Amazon Resource Name (ARN)
    2. Azure Key Vault: Enter the Secret Name and the Vault URI
  2. Click Register User .

Edit a repository user to update the username or fields specific to the secret source.

To edit a repository user:

  1. Log into ALTR via Okta.
  2. Select Data ConfigurationData Sources in the Navigation menu.
  3. Select Repositories from the Type dropdown.
  4. Click the repository to view details.
  5. Click the Users tab.
  6. Locate the repository user and click Edit .
  7. Update repository user.
  8. Click Save .

Removing a repository user prevents it from being used in impersonation policies. Update relevant policies to exclude a repository user before removing the user.

To remove a repository user from ALTR:

  1. Log into ALTR via Okta.
  2. Select Data ConfigurationData Sources in the Navigation menu.
  3. Select Repositories from the Type dropdown.
  4. Click the repository to view details.
  5. Click the Users tab.
  6. Locate the repository user and click Edit .
  7. Update repository user.
  8. Click Save .