Okta

Bugcrowd offers a Security Assertion Markup Language (SAML) based Single Sign-On (SSO) integration with Okta to help you create an easy and centralized way to log in to Crowdcontrol. This section provides the steps to configure Okta.

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.

Adding Bugcrowd to Your Okta Apps Portal

  1. Log in to your Okta account and click Admin.

    admin

  2. Hover over the Applications tab and click Applications.

    applications

  3. Click Add Application.

    add-application

  4. Click Create New App.

    create-new-app

  5. In Sign on method, select SAML 2.0 and click Create.

    select-saml

    The General Settings page is displayed.

  6. Specify the following:

    • App name: Specify Bugcrowd Inc as the app name.
    • App logo: Click Browse, specify the Bugcrowd logo image, and click Upload Logo.

    name-logo

  7. Click Next.

    click-next

    The SAML Settings page is displayed.

    To specify the information for this screen, you must access your Bugcrowd account.

    create-saml-integration

Accessing SAML Information in Bugcrowd

  1. In Crowdcontrol, click your profile.

    profile-click

  2. Click Authentication.

    click-authentication

  3. Click Single Sign-on (SSO).

    single-sign-on

    The SSO Configuration for Demo Organization is displayed.

  4. Make a note of the Single sign on URL and SP Entity ID.

    url-id

    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.

  5. Pause the screen and go to the next step.

Adding SAML Information in Okta

  1. Go back to Okta > Configure SAML page (last step in the first section).

  2. Specify the following information:

    • Single sign on URL: Paste the Single Sign on URL you copied from your Bugcrowd account.
    • Audience URI (SP Entity ID): Paste the Single Sign on URL you copied from your Bugcrowd account.
    • Name ID format: Select EmailAddress.
    • Application Username: Select Email.

    configure-saml

  3. In ATTRIBUTE STATEMENTS section, specify the following:

    • Name: Select Role
    • Value: Select user.Role

    Click Next at the bottom of the page.

    attributes

    The Feedback page is displayed.

  4. Select I’m an Okta customer adding an internal app and This is an internal app that we have created and click Finish.

    finish

Mapping Okta to Crowdcontrol

  1. Click View Setup Instructions.

    view-setup-instructions

    The How to Configure SAML 2.0 for Bugcrowd Inc. Application screen is displayed.

  2. Make a note of the information from the following fields:

    • Identity Provider Single Sign-On URL
    • Identity Provider Issuer
    • X.509 Certificate

    saml-20-for-app

  3. Navigate back to the Single Sign-On screen in Crowdcontrol and scroll to the SAML Settings section.

  4. Paste the information you copied in the following fields:

    • IdP Entity ID: Paste the Identity Provider Issuer information from Okta.
    • IdP SSO Target URL and IdP SLO Target URL: Paste the Identity Provider Single Sign-On URL information from Okta.
    • IdP Certificate: Paste the X.509 Certificate information from Okta.

    saml-settings

    Click SAVE AUTHENTICATION SETTINGS to save the information.

    Domain verification is required for SSO to function properly.

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.

    click-domains

    The Domain verification page is displayed.

  2. Specify the domain and click ADD DOMAIN.

    add-domain

    A verification code is displayed.

  3. Add a TXT record at the domain’s root with this code.

    unverified

    DDNS verification may take up to 24 hours to succeed.

    For information about adding a TXT record, consult your DNS provider. For any additional help verifying domains, send an email to support@bugcrowd.com.


Onboarding
Account Management
Program Management
Reporting
Submission Management
Integration Management