Access control

The DataStore tools in the Administrator Console let administrators with the appropriate privileges manage which users can access the DataStore. Using these tools, administrators can:

  • DataStore Settings: Lets users manage DataStore configurations and user credentials
  • DataStore Secret Generation: Lets users create secrets that allow direct access to the DataStore

The image shows the DataStore Secret Generation tool in the Administrator Console. On the left sidebar, various admin tools are listed, including DataStore Secret Generation and DataStore Settings, both highlighted. The main section displays access information for the RECORDS DataStore, including server, database, and login ID fields. Below, there is a secret generator where users can set the secret's time-to-live in hours. An option to set the secret as never expiring is also available, along with a Generate button to create the secret.

DataStore settings

Users who belong to Groups or teams with the DataStore Management privilege can view the DataStore Settings tool. Using this tool, users can manage the organization's access policy and secret statuses for Axon Records and Axon Standards users.

Access policy

From the Access policy tab in the DataStore Settings tool, you can adjust the following settings:

  • Secret time-to-live configuration
  • Allowed IP addresses for DataStore access

The image shows the DataStore Settings page with the Access Policy tab selected, highlighted by a yellow box in the top left section.

Secret time-to-live configuration

Enter a number in the Maximum secret time-to-live (days) field to indicate the maximum number of days a secret can be available after it is generated.

Note that during secret generation, you can enter a TTL in hours, which allows for more granular control than the days setting in the DataStore Settings tool. However, the number of hours you enter during secret generation must be equal to or fewer than the day duration specified in this field in the DataStore Settings tool.

Select the Allow other users to generate never expires secrets checkbox to allow users to generate secrets that never expire.

After making changes, select Save settings.

Allowed IP addresses for DataStore access

The IP addresses listed in this table are the only addresses from which the DataStore can be accessed.

To add a new IP address:

  1. Select Add IP.
  2. Select the type of address:
    • Single IPaddress: Lets you add one address
    • Range of IP address:Lets you add an IP address range. You must provide a starting IPaddress and an Ending IP address.
  3. Enter either the single IP address or the range.
  4. Select Add.
  5. Select Save settings.

To remove an IP address (either a single IP address or a range):

  1. Select Remove in the row corresponding to the IP address you want to remove.
  2. Select Remove again in the confirmation window that appears.
  3. Select Save Settings.

Secret status

The Secret status tabs in the DataStore Settings tool display a list of all users who have been given access to the DataStore. If your organization is configured for both Axon Records and Axon Standards, you will see two Secret status tabs, one for Axon Records and one for Axon Standards.
The image shows the DataStore Settings page with the Records and Standards DataStore Secret Status tabs selected, highlighted by a yellow box.

These tabs are split into two sections:

  • Default access settings
  • Access profile list

Default access settings

The top section on the Secret status tabs displays the settings for your organization's default access profile. The default access profile is applied whenever you give a new user access to the DataStore and gives users access to a predefined set of accessible views and schemas.

The Default Access Settings section displays the following information:

  • Applied profiles: The number of users who have been given default access
  • Schemas: The number of tables/views out of the total number of tables/views in the entire DataStore that are included in the default access profile.
    • For example, if this section displays 182/189, there are 189 total tables/views in the DataStore but the default access profile only includes 182.
  • Updated date: The last date when the default access settings were updated.

When you edit your DataStore's default access settings, all users who have been given default access will receive the access updates you make. If you only want to adjust access settings for a single user, edit their custom access profile instead.

To edit the default access settings:

  1. Select Edit in the Default Access Settings section at the top of the Secret status tab.The image shows the DataStore Settings page with the Records DataStore Secret Status tab selected. A table displays the default access settings for new users, including applied profiles, schemas, and the updated date. A yellow highlight emphasizes the Edit option on the far right of the row.
  2. Use the checkboxes to set which schemas are included in the default access profile.
    • Use the search bar to find specific tables or views.
    • Hover over the information icon to view more details about that schema. See Concepts and features to learn more about schemas.
    • Select the down arrows to reveal the nested schema levels.
      The image shows the Edit Default Access Settings screen, where schemas can be selected for users with the default access profile. A search bar at the top is highlighted in yellow, along with collapsible section arrows on the right. The Records section under Datastore V2 is expanded, and multiple schema checkboxes are selected.
  3. After adjusting the schemas, select Next.
  4. Use the checkboxes to set which users have the default access profile.
    • All users who have previously been given the default access profile are pre-selected.
    • Use the search box to find specific users.
  5. After adjusting the user list, select Save.
    • It may take several minutes for your updates to save. Do not close the tab during this process.

Access profile list

The table in the Access Profile List section provides detailed information about all user profiles that have access to DataStore, along with their current access status. The following information is included about each profile:

  • Username/email: The username or email associated with the profile
  • Profile type:
    • Agency user: Users who have an Axon Evidence account with the agency and for whom a DataStore secret has been generated.
    • Third party:Users who belong to third-party organizations but can still access the organization's DataStore.
    • Axon: Axon representatives who have been granted access to the organization's DataStore.
  • Time-to-live: Shows the TTL that was specified when the profile's secret was generated
  • Status:
    • Setup Pending: A secret has NOT yet been generated.
    • Active:A secret has been generated and is currently active.
    • Expired: A secret was generated, but the TTL has passed and the secret has expired.
  • Access type: Whether the profile has default or custom access
  • Schemas: The number of tables/views out of the total number of tables/views in the entire DataStore that are included in the default access profile.
    • For example, if this section displays 182/189, there are 189 total tables/views in the DataStore but the default access profile only includes 182.
    • If a profile has default access, this schema count is the same as the count in the Default Access Settings section.
  • Created date: The date the access profile was created

Depending on the profile type and status, various options appear in the More actions [...] menu:

  • Edit access control: Appears for all profiles and statuses
  • Regenerate secret: Appears for third-party profiles that are in Setup Pending or Active status
  • Revoke secret: Appears for all profiles that are in Active status
  • Remove access profile: Appears for all Axon profiles in any status

The image shows the Access Profile List page with user access details displayed in a table format. The row for one user includes information such as profile type, status marked as expired, access type, and schema count. A yellow highlight emphasizes the three-dot menu on the far right of the row.

Create access profile

To grant DataStore access to an agency user, first generate a secret using the DataStore Secret Generation tool. Once the secret has generated, an access profile appears in the Access Profile List where you can edit the access control if you want the profile to have more or less access than is granted by the default access profile.

To create a new access profile for an Axon representative or a third-party user:

  1. Select Add access.
    The image shows the Access Profile List section. A yellow highlight emphasizes the Add Access button.
  2. Specify if the user is an Axon representative or a third-party user.
    • If the user is an Axon representative, enter their email address.
    • If the user is a third party, enter a username.
  3. Select the checkbox to acknowledge that you are a designated administrator responsible for granting DataStore access to users outside your organization.
  4. Select Next.
  5. Set which schemas the profile can access.
    • To grant default access, select Apply default access settings.
    • To grant custom access, use the checkboxes to select specific schemas.
      • Tip: To use the default profile as a starting point, select Apply default access settings then adjust the checkboxes to refine the schemas included in the profile's access.
        The image shows the Add Access Profile screen where schemas can be selected for a specific user. A search field is used to filter schemas by the term incident, and one schema is selected from the Records section under Datastore V2. The Apply Default Access Settings button is highlighted in the top right corner.
  6. Select Add access profile to create the profile.
  7. When you create a profile for a third-party user, you can immediately generate a secret for the profile.
    1. Select a TTL option.
    2. Select Generate.
    3. The secret will generate and appear below the Generate button. This secret must be copied immediately, as it will not be displayed again.
    4. Select Copy secret and close.
    5. Follow your organization's security practices to safely share the secret with the user.
  8. When you create a profile for an Axon representative, they receive an email directing them to log into the internal Axon secured administration portal to generate a secret.
    • Axon representatives can never generate “never expire” secrets. Any secrets they generate will adhere to the maximum TTL setting on the Access policy tab.

Edit access control

You can edit a profile’s access settings at any time. Changing access does not affect the user’s existing secret; it only modifies their ability to SELECT tables or views within a schema. When new access is granted, the user will be able to see the additional tables or views shortly after the update. Conversely, if a user’s access to specific tables or views is revoked, their access to those resources will be removed immediately. All access changes—both granting and revoking—take effect within approximately 30 seconds.

To edit access:

  1. Use the search bar to find a profile.
  2. Select More actions [...] > Edit access control.
  3. Use the checkboxes to set which schemas are included in the profile.
    • If a profile previously had the default access profile and you add or remove access to any schemas, their access type changes to Custom.
    • To return a user to the default access profile, select Apply default access settings.
  4. After making all necessary adjustments, select Save.

Regenerate secret

Regenerating a secret lets you refresh secrets for third-party users outside your organization. Agency users and Axon representatives who have access to the DataStore can generate secrets for themselves as necessary.

To regenerate a secret for a third-party user:

  1. Use the search bar to find a profile.
  2. Select More actions [...] > Regenerate secret.
  3. Select the check box to acknowledge that you are a designated administrator responsible for granting DataStore access to users outside your organization.
  4. Select a TTL option.
  5. Select Generate.
  6. The secret will generate and appear below the Generate button. This secret must be copied immediately, as it will not be displayed again.
  7. Select Copy secret and close.
  8. Follow your organization's security practices to safely share the secret with the user.

Revoke secret

Once a secret is revoked, it immediately changes to an Expired status and can no longer be used to access the DataStore. If the user is currently accessing the DataStore when this occurs, they will no longer be able to perform any queries and will be logged out when their session times out.

Secrets for Axon representatives can't be revoked. Instead, the access profile must be removed.

To revoke a secret:

  1. Use the search bar to find a profile.
  2. Select More actions [...] > Revoke.
  3. Select Revoke in the confirmation window that appears.

Remove access profile

Access profiles for Axon representatives can be removed at any time. Once an access profile is removed, it cannot be restored.

To remove an access profile:

  1. Use the search bar to find a profile.
  2. Select More actions [...] > Remove access profile.
  3. Select Remove in the confirmation window that appears.

Secret generation

Users who belong to Groups or teams with the DataStore Access privilege can view the DataStore Secret Generation tool. Using this tool, users can generate secrets that allow access to the DataStore. If your organization is configured for both Axon Records and Axon Standards, you will see sections on this page: one for generating Axon Records secrets and one for Axon Standards.
The image shows the DataStore Secret Generation tool for two different DataStores: RECORDS DataStore and STANDARDS DataStore. Both sections display access information, including the server, database, and login ID. Below each DataStore's access information, there is a secret generator that allows users to set the secret's time-to-live. A Generate button is present to create the secret for each DataStore.

Each section provides the following information:

  • Server name
  • Database name
  • Login ID: The username of the user who is viewing and using the tool

To generate a new secret:

  1. Go to either the Axon Records or Axon Standards section and enter the time-to-live (TTL) of the secret in hours.
    • You can't enter a longer TTL than the maximum set by administrators.
    • To generate a secret that never expires, select the This secret never expires checkbox.
  2. Select Generate.
  3. The secret will generate and appear on the right side of the gray box. This secret must be copied immediately, as it will not be displayed again.
  4. The secret will be added to the DataStore Settings tool where users with the appropriate privileges can revoke it if necessary.
    The image shows the DataStore Secret Generation page for the RECORDS DataStore. The access information section displays the server, database, and login ID, along with a message indicating the expiration time of the existing secret. Below, the secret generator allows the user to set the secret's time-to-live. A result box on the right shows the secret string (obscured) with a warning to copy it immediately as it will not be shown again.

Privileges

The privileges related to the Axon Records DataStore appear in the DataStore - Records category, and the privileges related to the Axon Standards DataStore appear in the DataStore - Standards category, as shown below:

Name

Description
DataStore - Records
Manage the Records DataStore using the DataStore Settings tool Lets users access the DataStore Settings tool in the Administrator Console and manage configurations for the Axon Records DataStore.
Use the Records DataStore Secret Generation tool to create DataStore secrets Lets users access the DataStore Secret Generation tool in the Administrator Console and generate secrets for the Axon Records DataStore.
DataStore - Standards
Manage the Standards DataStore using the DataStore Settings tool Lets users access the DataStore Settings tool in the Administrator Console and manage configurations for the Axon Standards DataStore.
Use the Standards DataStore Secret Generation tool to create DataStore secrets Lets users access the DataStore Secret Generation tool in the Administrator Console and generate secrets for the Axon Standards DataStore.