Monitoring permission changes

Monitoring permission changes#

This guide explains how to monitor permission changes for your authorizations using the Permission Changes monitor. This feature is available as part of the Data Quality Suite.

Introduction#

The Permission Changes monitor allows you to track which permissions (such as ad accounts or profiles) have been added to or removed from your authorizations over time. This visibility helps you:

  • Quickly identify when access to data sources changes

  • Address missing data that needs to be fetched

  • Ensure complete data coverage for reporting

  • Make confident, data-driven decisions based on accurate information

What are permission changes?

Permissions define which items (such as accounts or profiles) an authorization allows Adverity to access. Permission changes occur when:

  • New items become available and are added to the authorization

  • Existing items are removed or access is revoked

  • You manually update the permissions for an authorization

How often are permission changes detected?

Permission changes are detected when metadata for an authorization is synchronized. This happens:

  • Automatically once per day

  • Manually when you trigger a metadata sync from the authorization details page

The maximum delay between a permission change occurring upstream and being detected by Adverity is 24 hours.

Where can I view permission changes?

You can view permission changes in two places:

  • Authorizations page - See a visualization of permission changes across all authorizations and export changes for multiple authorizations at once.

  • Single authorization’s details - View the complete permission change history for a specific authorization, with filtering and search options.

Permission changes visualization#

The Authorizations page displays a stacked bar chart showing permission changes across all your authorizations.

  • Date range selector - Filter the visualization by a specific time period. The default range is 14 days, with a maximum of 60 days.

  • Bar chart - Each bar represents a day, with different colors showing permissions added and removed.

  • Tooltips - Hover over a bar to see the count of additions and removals grouped by data source.

Note

The date range filter affects only the bar chart visualization. It does not filter the authorizations listed in the table below.

Viewing permission change history#

Permissions changes overview#

To view which authorizations have had permission changes, look at the bar chart visualization at the top of the Authorizations page. The chart shows the total number of permissions added or removed each day across all your authorizations.

Permissions changes of a single authorization#

To view the permission change history for a specific authorization, follow these steps:

  1. Go to the Authorizations page.

  2. Click the name of the authorization you want to view.

  3. In the Provides access to… section, click View changes.

    Note

    The View changes button appears when there are recent permission changes for this authorization.

As a result, a panel opens showing the permission changes history for this authorization.

The permission changes panel displays a table with the following information:

  • Date and time - When the change was detected

  • Action - Whether the permission was added or removed

  • Permission name - The name of the affected permission

  • Permission ID - The unique identifier of the permission

  • Used in - A list of datastreams that use this permission

When viewing the permission change history for a single authorization, you can filter and search the results:

  • Date range - Filter changes by a specific time period

  • Action filter - Show only additions, only removals, or both

  • Search - Search by permission name, permission ID, or datastream name

Exporting permission changes#

You can export permission changes as a CSV file. There are two ways to export, depending on whether you want to export changes for multiple authorizations or a single one.

Exporting changes for multiple authorizations#

To export permission changes for multiple authorizations at once, follow these steps:

  1. Go to the Authorizations page.

  2. Select the authorizations for which you want to export permission changes.

  3. Above the table, in Export permissions, click Permission changes.

  4. In the export modal, configure your export:

    • Date range - Select the time period for which you want to export changes. By default, this matches the date range selected in the bar chart.

    • Include actions - Select which types of changes to include: Added, Removed, or both.

  5. Click Export as CSV.

Exporting changes for a single authorization#

To export the permission change history for a single authorization, follow these steps:

  1. Open the permission changes panel for the authorization.

  2. (Optional) Apply filters to narrow down the changes you want to export.

  3. Click Export as CSV.

Exported data#

The exported CSV file includes the following columns:

  • Workspace

  • Data source

  • Authorization

  • Permission name

  • Permission ID

  • Action (Added or Removed)

  • Date and time of the change

  • Datastreams using this permission

Getting notified about permission changes#

You can set up notifications to be alerted when permissions change for your authorizations. This allows you to react promptly to changes without manually checking the Permission Changes monitor.

To receive permission change notifications, subscribe to the Authentication topic in your notification settings. You will be notified when an authorization gains or loses access to accounts or profiles.

For more information about setting up notifications, see Managing user notifications.

Contents