# Known Issues

## "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**](https://github.com/settings/applications) **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: **"It is required to install our GitHub Application"**

### Workarounds

#### 1. Clear the Cache in Cloudback

1. Go to the Cloudback Dashboard.
2. Open the [**Contact us**](https://app.cloudback.it/contactus) 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudback.it/troubleshooting-and-support/known-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.