OAuth permission requirements

Tags: Flow

Flow only requires read access to your repos. This permission is needed to process the metadata used to generate our reports. Many Git hosts do not offer the ability to narrow permissions down to just read-only access to private profile information and repositories. When connecting to Git hosts like GitHub and Bitbucket, standard Oauth permissions include write plus full admin permissions which are never used by our system. Git hosts may require these access levels in order to utilize their API.

Who can use this?


Import repo permissions

If the repo lives under an organization in your Git host, Flow will need access to that organization. Go to your githost account to apply permissions.

If you are the owner of the organization:

If you are the owner of the organization, you can grant Flow access to the organization and all its associated repos.

If you are a member of the organization:

If you are a member of the organization, send a request to the owner of the organization to grant permissions to Flow.

back to top

Granting organizational access

If you are missing a GitHub organization in Flow, you will need to grant Flow access in GitHub. Follow the steps below to update Flow’s access.

To update Flow's access:

  1. In GitHub, under Settings, click Applications.
  2. Click Authorized OAuth Apps.
  3. Click on the Flow application.
    Here, you can see which organizations Flow has access to. As seen below Flow does not have access to the myorgsname organization.
    Note: If you are a member of the org, not the owner, click the Request button next to the org name. An owner of the organization will receive your request and will be able to grant or deny your request.
  4. To give Flow access to the organization, click the Grant button next to the organization’s name.
  5. Now that you have granted Flow access, head back over to Flow. Under your GitHub integration, select the Repos tab. If you do not see all your GitHub organizations you may need to click the Refresh button for the groups to update.

back to top

I did not see a Grant button next to my organization

If you saw a red x next to your organization rather than the Grant button, you will need to grant permissions at the organization level in GitHub.

  1. Under your GitHub Settings, click on the organization you want to give Flow access to:
  2. Under the organization’s settings, click Third-party access and click the pencil next to the Flow application.
  3. Click the Grant Access button.
    You successfully granted Flow access to your GitHub organization.
    This organization now has a green check mark for Flow under the Authorized OAuth Apps.

back to top

If you need help, please contact Pluralsight Support.