Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Monitoring permission changes

On this page

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 the following places:

  • Authorizations page - A bar chart at the top of the page shows permission activity across all your authorizations. Click See more to open the Permission Changes page, where you can view and filter the full history of permission changes.

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

Permission changes on the Authorizations page

At the top of the Authorizations page, the Permission changes chart shows permission activity across all your authorizations. Each bar represents one day, with added and removed permissions shown as separate bars. The chart covers up to a month in the past.

  • Hover over a bar to see the count of permissions added and removed for that day, along with the connector name.

  • See more - Click this link to open the Permission Changes page for a full view with date range selection and filtering.

Permission Changes page

To open the Permission Changes page, click See more in the Permission changes chart on the Authorizations page.

The page displays a bar chart and a table of permission changes. Use the date range selector to filter both the chart and the table by time period. Added and removed permissions are shown as separate bars in the chart. To export the filtered table as a CSV file, click Export filtered table at the top of the page.

The table lists permission changes ordered by date, with the most recent changes at the top. You can filter the table by:

  • Workspaces - Filter by workspace

  • Datasources - Filter by data source

  • Date range - Filter changes by time period

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

The table includes the following information for each change:

  • Workspace - The workspace the authorization belongs to

  • Datasource - The connector associated with the authorization

  • Authorization - The name of the authorization

  • Permission - The name of the affected permission

  • Permission ID - The unique identifier of the permission

  • Action - Whether the permission was added or removed

  • Date, time - When the change was detected

  • Used in datastreams - datastreams that use this permission

Click an authorization name in the table to go directly to its details page.

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.

As a result, a panel opens showing the permission changes history for this authorization. The records are ordered by date, with the most recent changes shown first, so you can quickly identify the latest incidents.

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

To export the displayed permission changes as a CSV file, click Export filtered table at the top of the Permission Changes page. The export includes all changes currently shown based on your active filters.

Exported data

The exported CSV file includes the following columns:

  • Workspace

  • Data source

  • Authorization

  • Permission name

  • Permission ID

  • Added timestamp

  • Updated timestamp

  • Status (access granted/not granted)

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.