tyGraph

Refer to the table below for the apps that you can use for tyGraph and the requirements to consent to app permissions.

CategoryApp type in AOSApp setup methodFeature/ModuleApp name in Entra IDNew or updated?Consent
Service apptyGraph SuiteModern modeAll reports. View details in the tyGraph Suite permission table.AvePoint tyGraphNo changesCreate or re-authorize an app profile in AOS > Management > App management.
Service apptyGraph for Viva EngageModern modeViva Engage reportAvePoint tyGraph for Viva EngageNo changesCreate or re-authorize an app profile in AOS > Management > App management.
Service apptyGraph for SharePointModern modeSharePoint reportAvePoint tyGraph for SharePointNo changesCreate or re-authorize an app profile in AOS > Management > App management.
Service apptyGraph for Copilot Adoption / TrialsModern modeCopilot adoption reportAvePoint tyGraph for Copilot AdoptionNo changesCreate or re-authorize an app profile in AOS > Management > App management.
Service apptyGraph Pages (Only)Modern modePages report dataAvePoint tyGraph for Pages (only)No changesCreate or re-authorize an app profile in AOS > Management > App management.

Permissions Required by tyGraph Suite

When you create the tyGraph Suite app profile in AvePoint Online Services, the AvePoint tyGraph app will be automatically set up in your Microsoft Entra ID.

NOTE

The tyGraph Suite option includes all modules in tyGraph.

The tyGraph data initialization will start after you sign into tyGraph interface once the app profile is set up. To ensure smooth data collection and reporting, confirm that the required roles and settings are properly configured.

  • For Viva Engage reports, the account used for app consent must hold the Viva Engage Verified Administrator role. Confirm this role assignment in the Viva Engage admin center or Microsoft Entra ID.

  • Auditing in your tenant is enabled. Turn on auditing in the Microsoft 365 Security & Compliance Center.

  • Usage reports are not anonymized. Go to the Microsoft 365 admin center > Settings > Org settings > Services > Reports and ensure the Display concealed user, group, and site names in all reports option is deselected.

  • To enable the data collection on SharePoint pages, you must install the Page Engine app in your SharePoint environment.

NOTE

The tyGraph interface offers a Scan status tab on Home page tracking the data collection status and a Quick check page through Settings > Scan to verify the prerequisites condition. For more details, refer to Scan Job Status in tyGraph User Guide.

The table below lists the permissions that should be accepted when you authorize AvePoint tyGraph app.

Feature/ModuleAPIPermissionPermission typePurposeIs newly required?
Calling reportMicrosoft GraphCallRecords.Read.All
(Read all call records)
ApplicationRead call records for all calls and online meetings.No
Teams reportMicrosoft GraphChannel.ReadBasic.All
(Read the names and descriptions of all channels)
ApplicationRead channel names and descriptions of Teams reporting.No
Teams reportMicrosoft GraphChannelMember.Read.All
(Read the members of all channels)
ApplicationRead all channel messages of the Teams reporting.No
Teams reportMicrosoft GraphChannelMessage.Read.All
(Read all channel messages)
ApplicationRead all channel messages of the Teams reporting.No
Teams reportMicrosoft GraphTeam.ReadBasic.All
(Get a list of all teams)
ApplicationRead Teams basic information of Teams reporting.No
Teams reportMicrosoft GraphTeamsTab.Read.All
(Read tabs in Microsoft Teams)
ApplicationRead Teams tabs of Teams reporting.No
SharePoint reportMicrosoft GraphFiles.Read.All
(Read files in all site collections)
ApplicationRead files in all site collections of the SharePoint reporting.No
SharePoint reportMicrosoft GraphSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections of the SharePoint reporting.No
Copilot adoption reportMicrosoft GraphInformationProtectionPolicy.Read.All
(Read all published labels and label policies for an organization.)
ApplicationRetrieve tenant sensitive labels that will be displayed in the Copilot report.No
Copilot adoption reportMicrosoft GraphAiEnterpriseInteraction.Read.All
(Read all AI enterprise interactions)
ApplicationRetrieve Microsoft 365 Copilot interaction data.No
Harvest job basicMicrosoft GraphDirectory.Read.All
(Read directory data)
ApplicationRetrieve information from your organization’s Active Directory.No
Harvest job basicMicrosoft GraphGroup.Read.All
(Read all groups)
ApplicationInventory the groups for reporting purposes.No
Harvest job basicMicrosoft GraphGroupMember.Read.All
(Read all group memberships)
ApplicationRead group memberships of Pulse and Teams reporting.No
Harvest job basicMicrosoft GraphReports.Read.All
(Read all usage reports)
ApplicationRead usage report data of all reporting.No
Harvest job basicMicrosoft GraphUser.Read
(Sign in and read user profile)
DelegatedRetrieve your Microsoft 365 tenant information.No
Harvest job basicMicrosoft GraphUser.Read.All
(Read all users' full profiles)
ApplicationRead user properties.No
Harvest job basicOffice 365 Management APIsActivityFeed.Read
(Read activity data for your organization)
ApplicationAn aggregation of actions and events for specified content types such as Microsoft Entra, SharePoint, OneDrive, Teams, or Viva Engage.No
SharePoint reportSharePoint/Office 365 SharePoint OnlineSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections of the SharePoint reporting.No
SharePoint reportSharePoint/Office 365 SharePoint OnlineSites.FullControl.All
(Have full control of all site collections)
ApplicationUsed in Sites that I own report to retrieve site owners and users with full control of sites.
*Note: It can be removed in a custom app registration, but the Sites that I own report will not function.
No
Viva Engage reportYammeraccess_as_user
(Read and write to the Yammer platform [preview])
DelegatedTo access the Viva Engage platform on behalf of the signed-in user.No
Viva Engage reportYammeruser_impersonation
(Read and write to the Yammer platform [preview])
DelegatedTo access the Viva Engage platform on behalf of the signed-in user.No

Permissions Required by tyGraph for Viva Engage

When you create the tyGraph for Viva Engage app profile in AvePoint Online Services, the AvePoint tyGraph for Viva Engage app will be automatically set up in your Microsoft Entra ID.

The tyGraph data initialization will start after you sign into tyGraph interface once the app profile is set up. To ensure smooth data collection and reporting, confirm that the required roles and settings are properly configured.

  • For Viva Engage reports, the account used for app consent must hold the Viva Engage Verified Administrator role. Confirm this role assignment in the Viva Engage admin center or Microsoft Entra ID.

  • Auditing in your tenant is enabled. Turn on auditing in the Microsoft 365 Security & Compliance Center.

  • Usage reports are not anonymized. Go to the Microsoft 365 admin center > Settings > Org settings > Services > Reports and ensure the Display concealed user, group, and site names in all reports option is deselected.

  • To enable the data collection on SharePoint pages, you must install the Page Engine app in your SharePoint environment.

NOTE

The tyGraph interface offers a Scan status page for tracking the data collection status and a Precheck page to verify the prerequisites condition through Settings > Scan. For more details, refer to Scan Job Status in tyGraph User Guide.

The table below lists the permissions that should be accepted when you authorize AvePoint tyGraph for Viva Engage app.

APIPermissionTypePurposeIs newly required?
Microsoft GraphDirectory.Read.All
(Read directory data)
ApplicationRetrieve information from your organization’s Active Directory.No
Microsoft GraphReports.Read.All
(Read all usage reports)
ApplicationRead usage report data of all reporting.No
Microsoft GraphUser.Read.All
(Read all users' full profiles)
ApplicationRead user properties.No
Microsoft GraphGroup.Read.All
(Read all groups)
ApplicationInventory the groups for reporting purposes.No
Office 365 Management APIsActivityFeed.Read
(Read activity data for your organization)
ApplicationAn aggregation of actions and events for specified content types such as Microsoft Entra, SharePoint, OneDrive, Teams, or Viva Engage.No
Yammeraccess_as_user
(Read and write to the Yammer platform [preview])
DelegatedTo access the Viva Engage platform on behalf of the signed-in user.No
Yammeruser_impersonation
(Read and write to the Yammer platform [preview])
DelegatedTo access the Viva Engage platform on behalf of the signed-in user.No

Permissions Required by tyGraph for SharePoint

When you create the tyGraph for SharePoint app profile in AvePoint Online Services, the AvePoint tyGraph for SharePoint app will be automatically set up in your Microsoft Entra ID.

The table below lists the permissions that should be accepted when you authorize AvePoint tyGraph for SharePoint app.

APIPermissionTypePurposeIs newly required?
Microsoft GraphDirectory.Read.All
(Read directory data)
ApplicationRetrieve information from your organization’s Active Directory.No
Microsoft GraphFiles.Read.All
(Read files in all site collections)
ApplicationRead files in all site collections of the SharePoint reporting.No
Microsoft GraphGroup.Read.All
(Read all groups)
ApplicationInventory the groups for reporting purposes.No
Microsoft GraphReports.Read.All
(Read all usage reports)
ApplicationRead usage report data of all reporting.No
Microsoft GraphSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections of the SharePoint reporting.No
Microsoft GraphUser.Read.All
(Read all users' full profiles)
ApplicationRead user properties.No
Office 365 Management APIsActivityFeed.Read
(Read activity data for your organization)
ApplicationAn aggregation of actions and events for specified content types such as Microsoft Entra, SharePoint, OneDrive, Teams, or Viva Engage.No
SharePoint/Office 365 SharePoint OnlineSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections of the SharePoint reporting.No
SharePoint/Office 365 SharePoint OnlineSites.FullControl.All
(Have full control of all site collections)
ApplicationUsed in Sites that I own report to retrieve site owners and users with full control of sites.
*Note: It can be removed in a custom app registration, but the Sites that I own report will not function.
No

Permissions Required by tyGraph for Copilot Adoption / Trials

When you create the tyGraph for Copilot Adoption / Trials app profile in AvePoint Online Services, the AvePoint tyGraph for Copilot Adoption app will be automatically set up in your Microsoft Entra ID.

The table below lists the permissions that should be accepted when you authorize AvePoint tyGraph for Copilot Adoption app.

APIPermissionTypePurposeIs newly required?
Microsoft GraphDirectory.Read.All
(Read directory data)
ApplicationRetrieve information from your organization’s Active Directory.No
Microsoft GraphReports.Read.All
(Read all usage reports)
ApplicationRead usage report data of all reporting.No
Microsoft GraphGroup.Read.All
(Read all groups)
ApplicationInventory the groups for reporting purposes.No
Microsoft GraphUser.Read.All
(Read all users' full profiles)
ApplicationRetrieve your Microsoft 365 tenant user information.No
Microsoft GraphSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections for the Copilot report.No
Microsoft GraphInformationProtectionPolicy.Read.All
(Read all published labels and label policies for an organization.)
ApplicationRetrieve tenant sensitive labels that will be displayed in the Copilot report.No
Microsoft GraphAiEnterpriseInteraction.Read.All
(Read all AI enterprise interactions)
ApplicationRetrieve Microsoft 365 Copilot interaction data.No
Office 365 Management APIsActivityFeed.Read
(Read activity data for your organization)
ApplicationAn aggregation of actions and events for specified content types such as Microsoft Entra, SharePoint, OneDrive, Teams, or Viva Engage.No
SharePoint/Office 365 SharePoint OnlineSites.Read.All
(Read items in all site collections)
ApplicationRead items in all site collections for the Copilot report.No

Permissions Required by tyGraph Pages (Only)

When you create the tyGraph Pages (only) app profile in AvePoint Online Services, the AvePoint tyGraph for Pages (only) app will be automatically set up in your Microsoft Entra ID.

The table below lists the permissions that should be accepted when you authorize AvePoint tyGraph for Pages (only) app.

APIPermissionTypePurposeIs newly required?
Microsoft GraphDirectory.Read.All
(Read directory data)
ApplicationRetrieve information from your organization’s Active Directory.No
Microsoft GraphUser.Read.All
(Read all users' full profiles)
ApplicationRead user properties.No
Microsoft GraphUser.Read
(Sign in and read user profile)
DelegatedSign in and read the user profile.No