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

Authorizations page - A bar chart at the top of the page shows permission activity across all your authorizations. Click See all details 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 all details - 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 all details 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:

Go to the Authorizations page.
Click the name of the authorization you want to view.
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 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
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.