Known Issues

Documentation of known issues in Cloudback, including GitHub organization role changes and their impact on dashboard access, with detailed workarounds.

"Resource protected by organization SAML enforcement. You must grant your OAuth token access to this organization" Error When Restoring Repository

If you see the error message "Resource protected by organization SAML enforcement. You must grant your OAuth token access to this organization." when restoring a repository, please follow the steps below to resolve it.

Why Does This Happen?

This error occurs because your GitHub organization has enabled SAML-based SSO (Single Sign-On) after you originally authorized the Cloudback Restore GitHub Application. When SSO is enforced, you must explicitly grant your OAuth token (used by Cloudback) access to your organization.

Symptoms

• You try to restore a repository into an SSO-enabled GitHub organization.

• You receive the error: "Resource protected by organization SAML enforcement. You must grant your OAuth token access to this organization."

Solution: Re-authorize Cloudback Restore With SAML Access

Follow these steps to resolve the issue:

1. Go to your GitHub Authorized OAuth Apps page.

2. In the list, find Cloudback Restore.

3. Click Revoke next to Cloudback Restore.

4. Return to Cloudback and try restoring your repository again.

5. You will be prompted to re-authorize the Cloudback Restore app. Important: On this prompt, ensure you grant access to your organization with the required SAML permissions.

Additional Notes

• You must complete the re-authorization process for each organization where SAML SSO is enforced.

• This process is necessary whenever your organization enables SAML SSO after your initial Cloudback authorization.

"It is required to install our GitHub Application" Error After Changing Organization Member Role to Owner

If you see the error message "It is required to install our GitHub Application" after changing a member’s role to Owner in your GitHub organization, please follow the steps below to resolve the issue.

Why Does This Happen?

This error can appear right after you promote a user to the Owner role in your GitHub organization. It happens because GitHub does not notify Cloudback of this role change immediately. Cloudback relies on cached data from GitHub, so new Owner permissions may not be recognized right away.

Note: This is a known GitHub limitation and has been confirmed by the GitHub Support Team.

Symptoms

• You have changed a member’s role to Owner in your GitHub organization.

• The member tries to access the Cloudback Dashboard.

• The following error appears: &#xNAN;"It is required to install our GitHub Application"

Workarounds

1. Clear the Cache in Cloudback

1. Go to the Cloudback Dashboard.

2. Open the Contacts menu.

3. Click the Clear cache button.

4. Try accessing the dashboard again.

2. Remove and Re-Add the Member

If clearing the cache does not resolve the issue:

1. Remove the affected member from your GitHub organization.

2. Re-add them to the organization with the Owner role.

3. Have the member try accessing the Cloudback Dashboard again.

Additional Notes

• The Cloudback Dashboard is accessible only to organization owners.

• This issue will persist until GitHub improves how role changes are communicated to installed applications.