Introduction to the Authorizations page#
Introduction#
The Authorizations page is where you manage the authorizations that allow you to collect data from your chosen data sources.
- What is an authorization?
An authorization gives Adverity access to a data source or a destination. You need to create an authorization to collect data and load it into external destinations. You can use one authorization to create multiple datastreams and destinations.
- What are authorization permissions?
Most authorizations give Adverity access to multiple items that are linked to the authorization, such as accounts or profiles. When you create an authorization, you set permissions that define which items Adverity can access.
If an authorization does not ask you to select the permissions for items you want to give Adverity access to, this means that the authorization only grants Adverity access to a single item, for example a single account.
Permission changes#
This section, available as part of the Data Quality Suite, provides an overview of the permission changes across your authorizations.
The visualization shows a stacked bar chart representing permissions added or removed within the selected date range. Use the date range selector to filter by a specific time period (maximum: 60 days). 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.
To export permission changes, select one or more authorizations and click Export CSV. In the modal, select the date range and the types of changes to include (Added, Removed, or both), then click Export as CSV.
For more information, see Monitoring permission changes.
Authorizations overview#
After you have created at least one authorization, the Authorizations page provides an overview of your authorizations.
Use these filters to view your authorizations according to different properties. See below for more information about these filters.
Click here to create an authorization.
Click here to search for an authorization by Name.
Click here for more options. The options available here depend on your role and permissions. For more information, see Managing user permissions.
Select authorizations and click here to clone them to another workspace. For more information, see cloning-authorizations.
The table in the middle of the Authorizations page contains important information about your authorization s in the following columns:
Type - the data source to which this authorization applies
Name - the name of this authorization
Workspace - the workspace in which this authorization was created
Updated - the date and time at which this authorization was updated
Created - the date and time at which this authorization was created
Last used - the date and time at which this authorization was most recently used
Permissions - the number of items this authorization has permissions for
Datastreams - the number of datastreams that use this authorization
Status - the authorization’s access status
The filters above the table allow you to view specific authorization s in the table. You can apply more than one filter at the same time to view specific authorization s:
Workspace - displays all authorizations that are used in the selected workspace
Data source - displays all authorizations for the selected data source
Status - displays all authorizations with the selected access status
You can also use the search bar to search for authorizations by the Name column in the table. You can use the search function with or without filters applied.
Click 
Select an action in a specific authorization‘s
row in the table to perform additional actions with this
authorization . The actions you can perform are:
Sync metadata - manually update metadata - for more information, see Synchronizing metadata
Validate authorization - verify that the authorization is valid
Export permissions as CSV - export a CSV file containing a list of the permissions assigned to this authorization
Rename - rename the authorization
Permission changes - export a CSV file containing permission changes for this authorization in the selected date range. For more information, see Monitoring permission changes.
Clone - clone the authorization
Delete - review the list of objects that will be affected if you delete this authorization, and delete this authorization
These actions can also be performed in bulk. To perform an action on multiple authorizations at the same time, follow these steps:
Select the authorizations you want to perform an action on.
Above the table the actions menu will appear. Select the action you want to apply.