FogBugz On Demand has the option to use Google OAuth for authentication out-of-the-box. This article covers the steps necessary to take advantage of this in your On Site installation.
Prerequisites
- Your FogBugz URL must be hosted at a valid, public TLD
Configure a Google OAuth Application
The first thing you’ll need to do is register a Google OAuth credentials. If you’ve got an Organization, setting up the credentials there might be a better fit.
- Create a new project, if necessary
- “Create Credentials” > “OAuth client ID”
- When prompted, click “Configure consent screen” and provide the desired product name (e.g., “FogBugz On Site”)
- Create credentials for a Web application, using [your FogBugz URL]/oauth/google/redirect as one of the Redirect URIs
- Enable the Google+ API (Dashboard > Enable API > Google+ API, then click “Enable”)
Configure FogBugz with OAuth Secrets
Once the credentials are registered, you will be provided with a Client ID and a Client Secret. These values will need to go into the registry on the FogBugz web server as sOAuthGoogleClientId and sOAuthGoogleClientSecret, respectively. You’ll also want to include the Redirect URI from above as sOAuthGoogleRedirectUrl. The registry values are already configured with blank values, and you can find them at HKEY_LOCAL_MACHINE\SOFTWARE\Fog Creek Software\FogBugz\[your FogBugz install directory]\
After configuring the registry values, reset IIS to ensure the new configuration values are updated.
Enable OAuth Authentication
From a browser on your Trusted Network(s) (if you’re not sure, you can usually use a browser on the server hosting FogBugz), navigate to [your FogBugz URL]/f/debug/featureswitches and ensure that “OAuthConfig” is enabled. (Manuscript On Premises customers will not see a feature switch with this name… carry on!) Once completed, follow the final configuration steps to enjoy logging in with your Google credentials.
Need help? We’re always happy to help, just contact us.