MicroStrategy ONE

Signing in to GitHub by Scanning a QR Ccode

GitHub users can log in using their smartphones to scan a QR code displayed on the computer screen. After you integrate the web application with MicroStrategy Identity, the GitHub login page displays a QR code.

The following steps contain only the information required to configure or use GitHub with MicroStrategy Identity. The information provided is subject to change. See the appropriate third-party documentation for the latest information.

You own the GitHub Enterprise product.

You have site administrative privileges for your GitHub Enterprise domain.

To display a custom image on the GitHub login page, you must create the image to display. Supported image formats are .png, .jpeg, and .jpg files.

If your GitHub users are populated from an identity management (IDM) system such as Microsoft Active Directory or OpenLDAP, MicroStrategy recommends that you add users to your Identity Network by synchronizing MicroStrategy Identity with the same IDM system as GitHub. This helps add user information to MicroStrategy Identity and may be easier than adding users manually or by importing a file. For steps, see Synchronizing Users from Microsoft Active Directory or Synchronizing Users from OpenLDAP.

To Integrate GitHub with MicroStrategy Identity

  1. Log into MicroStrategy Identity Manager.
  2. Click Logical Gateways.
  3. Under Web Application Login, click More, then click GitHub.
  4. You can change the image that is displayed on your GitHub login page. Next to the image preview, click Import An Icon. Select an image to display, then click Open.
  5. In the Enter Display Name field, provide a name to display on your GitHub login page. The name can be up to 30 characters long.
  6. In the GitHub domain URL field, type your custom GitHub domain URL. For example, https://yourcompanyname.github.com. To determine your custom GitHub URL, see your third-party instructions.
  7. Click Next.
  8. Note the value provided for Login URL. You will use this information to configure GitHub.
  9. Click MicroStrategy Identity Security Certificate to download the Identity security certificate (for example, saml2.crt). Note the location on your computer where the certificate is saved.
  10. In a new browser window or tab, log in to GitHub with an administrative account.
  11. Click the rocket ship icon.
  12. Open the Management Console.
  13. Open the Authentication area.
  14. Create a new SAML authentication type with the following values:
    • Single sign-on: The Login URL value from MicroStrategy Identity Manager.
    • Verification certificate: Upload the Identity security certificate that you downloaded from MicroStrategy Identity Manager.
  15. Save your settings.
  16. In MicroStrategy Identity Manager, click Done. GitHub users can log in to GitHub by scanning a QR code using the MicroStrategy Badge app on their smartphones.

Related Topics

Signing in to MicroStrategy Identity-Enabled Web Applications from a Centralized Website

Categorizing MicroStrategy Badge Resources

Logical Gateways