For the complete documentation index, see llms.txt. This page is also available as Markdown.

Required permissions

Required permissions for integrating GitHub with Xopero ONE and protecting its resources.

Connecting GitHub with Xopero ONE requires appropriate permissions to access and protect repositories and their associated metadata. The required permissions depend on the authorization method used, such as a GitHub App or personal access token (PAT), and on the type of data that needs to be protected.


Account permissions

Integrating GitHub with Xopero ONE to back up and restore repositories, projects, and associated metadata requires an account with full administrative privileges.

Exact roles and permission levels may vary depending on individual repository settings, project configurations, or organization-level security policies. Below are examples of different roles, along with the corresponding permissions and the capabilities they provide in Xopero ONE.

GITHUB ROLES AND PERMISSIONS
Organization role
Repository role
Capabilities

Owner

Default

Full backup and restore.

Admin

Full backup and restore.

Write

Full backup and restore.

Read

Full backup. Restore only to the user's own account.

Member

Admin

Full backup. Restore only to the user's own account.

Maintain

Full backup. Restore only to the user's own account.

Write

Full backup. Restore only to the user's own account.

Triage

Backup excluding collaborators. Restore only to the user's own account.

Collaborator

Read

Backup excluding collaborators. Restore only to the user's own account.

Outside collaborator

Default

Backup excluding collaborators. Restore only to the user's own account.


Permissions for the OAuth app

To ensure seamless integration and correct operation, the Xopero ONE OAuth application* requires the following permissions:

*The Xopero ONE OAuth application for GitHub is called GitProtect.


Permissions for the GitHub App

Xopero ONE GitHub App* installation requires the following permissions:

*The Xopero ONE GitHub App is called GitProtect.


Permissions for personal access tokens (PAT)

Personal access tokens are generated in GitHub account settings under Settings > Developer settings > Personal access tokens and can be assigned different permissions.

Registering the Xopero ONE application and executing full repository backup and restore tasks requires a token configured with at least repo and workflow permissions.

The following list outlines the permissions required to back up repository metadata within an organization:


Last updated

Was this helpful?