Register Flow Enterprise Server with GitHub Cloud

To integrate Flow Enterprise Server with GitHub Cloud, you must configure an OAuth integration in GitHub. Consider configuring the OAuth integration using a service account with access to all teams and repositories in the organizations you want to show data for in Flow.

1. Create an OAuth App for the organization you want to integrate with Flow Enterprise Server according to the steps in the GitHub documentation (external site, opens in new tab).
   1. In Application name, fill out Flow Enterprise Server Integration, or something similar. If you want to have multiple Flow Enterprise Server integrations, name them so you can differentiate between them later.
   2. In Homepage URL, fill out the root URL of your Flow Enterprise Server instance. This will look something like https://flow.mycompany.com.
   3. In Application description add a description of the purpose of the application.
   4. In Authorization Callback URL, add the URL that GitHub should direct the user browser to after OAuth authentication is complete. This should look something like https://accounts/complete/github. For example, if your Flow Enterprise Server instance is at flow.mycompany.com, you would enter https://flow.mycompany.com/accounts/complete/github.
2. Once you save this information, find your Client ID and Client secret. If you don't see them, go to the GitHub app settings for this app.
3. Add this key and secret pair to the KOTS admin console for Flow Enterprise Server. Learn how to configure Flow Enterprise Server.
4. Once this is complete, follow the OAuth connection instructions in the GitHub Cloud setup article to complete your connection.

   Note: Once you have your OAuth app authorized in both GitHub and the KOTS admin console, managing your GitHub Cloud integration is identical in Flow Cloud and Flow Enterprise Server.