Welcome to Bugcrowd's Product Documentation Center

You'll find comprehensive guides and documentation to help you start working with Bugcrowd as quickly as possible.

OneLogin

Single Sign On

Specific Role Required to Configure SSO

To configure SSO for your program, you must be an Organization Owner.
Organization Owners can log in using Username and Password.

Bugcrowd offers a Security Assertion Markup Language (SAML) based Single Sign-On (SSO) integration with OneLogin to help you create an easy and centralized way to log in to Crowdcontrol. SAML is an XML-based standard for SSO authentication that creates a simplified way to access the applications that you can use. If you do not have OneLogin set up, see getting started guide.

The steps to configure OneLogin for SSO are:

  1. Adding Bugcrowd to your OneLogin Apps Portal
  2. Adding Your Identity Provider's SSO Settings to Crowdcontrol
  3. Verifying domain
  4. Logging in to SSO

Adding Bugcrowd to Your OneLogin Apps Portal

  1. Log in to your OneLogin account.
  2. Select Apps > Add Apps.
  1. Search for Bugcrowd.
  1. Select the Bugcrowd app.

The Configuration page is displayed.

  1. Modify any of the configuration settings that control how the Bugcrowd app appears in your portal and the connector version you want to use. Select SAML 2.0 as your connector.
  1. Save the settings.
    A new set of tabs appear that allow you to configure rules, parameters, SSO, access policies, and users for the Bugcrowd app.
  2. Select the SSO tab.
  1. Select X.509 Certificate (View Details) for additional information.
    • Use SHA1
    • X.509 Certificate

This page displays all the information that is required for adding to Crowdcontrol later. Make a note of the following information:

  • X.509 certificate and its fingerprint
  • Issuer URL
  • SAML 2.0 endpoint
  • SLO endpoint

Adding Your Identity Provider's SSO Settings to Crowdcontrol

  1. In Crowdcontrol, click your profile.
  1. Click Authentication.
  1. Click Single Sign-on (SSO).

The SAML Settings page is displayed.

  1. Specify in the information you saved from OneLogin in the earlier section.
Add the SSO settings from OneLogin

Add the SSO settings from OneLogin

Single Logout

Bugcrowd only supports logouts Identity Provider (IdP) initiated logouts, that is logging out of Bugcrowd will not log you out of your SSO provider.

The following table provides the Crowdcontrol fields mapped to OneLogin fields.

Crowdcontrol Field
OneLogin Field

IdP Certificate

X.509 Certificate

IdP Certificate Fingerprint

Fingerprint

IdP Entity ID

Issuer URL

IdP SSO Target URL

SAML 2.0 endpoint

IdP SLP Target URL

SLO endpoint

When you add the X.509 certificate, you must copy and paste the entire contents of the certificate, including the BEGIN and END headers as shown.

-----BEGIN CERTIFICATE-----
TTDMTSCCAkWgAwIBAgIJAJC1HiIAZAiIMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
m3LtH40luvg0sd0ng4evAT0mMYh4rdYDApTb21lLVN0YXRlMSEwHwYDVQQKDBhJbnRlcm5ldCBX
aWRnaXRzIFB0eSBMdGQwHhcNMTExMjMxMDg1OTQ0WhcNMTIxMjMwMDg1OTQ0WjBF 
t4c0fN746vaInA1KxYEeI1Rx5KXY8zIdj6a7hhphpj2E04LDdw7r495dv3UgEgpR
C3Fayua4DRHyZOLmlvQ6tIChY0ClXXuefbmVSDeUHwc8YufRAERp2GfQnL2JlPUL
B7xxt8BVc69rLeHV15A0qyx77CLSj3tCx2IUXVqRs5mlSbq094NBxsauYcm0A6Jq
vA==
-----END CERTIFICATE-----
  1. Save the settings.
    Crowdcontrol displays the SSO configuration for your program.
  2. Copy the Onelogin SAML Code.
Single Sign-on configuration for your company

Single Sign-on configuration for your company

  1. Go back to your Onelogin account and navigate to the Bugcrowd Configuration tab. Paste the Onelogin SAML Code.

Verifying Domain

All domains must be verified by Bugcrowd. You will not be able to login until the email address domains are verified.

  1. In Crowdcontrol, click your profile and then click Domains.

The Domain Verification page is displayed.

  1. Specify the domain and then click ADD DOMAIN.

A verification code is displayed.

  1. Add a TXT record at the domain's root with this code.

Note:

DNS verification may take up to 24 hours to succeed.

Having troubles?

For information about adding aTXT record, consult your DNS provider.
For any additional help verifying domains, contact [email protected].

Logging in Using SSO

After you have enabled SSO, your team members can navigate to the Company Apps area of OneLogin and click the Bugcrowd app to log in. If SSO is set up properly, members will be logged in to Crowdcontrol.

Updated 3 months ago


OneLogin


Single Sign On

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.