gitlab-org--gitlab-foss/doc/integration/salesforce.md

4 KiB

stage group info
Manage Authentication and Authorization To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Salesforce OmniAuth Provider (FREE SELF)

You can integrate your GitLab instance with Salesforce to enable users to log in to your GitLab instance with their Salesforce account.

Create a Salesforce Connected App

To enable Salesforce OmniAuth provider, you must use Salesforce's credentials for your GitLab instance. To get the credentials (a pair of Client ID and Client Secret), you must create a Connected App on Salesforce.

  1. Sign in to Salesforce.

  2. In Setup, enter App Manager in the Quick Find box, select App Manager, then select New Connected App.

  3. Fill in the application details into the following fields:

    • Connected App Name and API Name: Set to any value but consider something like <Organization>'s GitLab, <Your Name>'s GitLab, or something else that is descriptive.
    • Contact Email: Enter the contact email for Salesforce to use when contacting you or your support team.
    • Description: Description for the application.

    Salesforce App Details

  4. Select API (Enable OAuth Settings) and select Enable OAuth Settings.

  5. Fill in the application details into the following fields:

    • Callback URL: The callback URL of your GitLab installation. For example, https://gitlab.example.com/users/auth/salesforce/callback.
    • Selected OAuth Scopes: Move Access your basic information (id, profile, email, address, phone) and Allow access to your unique identifier (openid) to the right column.

    Salesforce OAuth App Details

  6. Select Save.

  7. On your GitLab server, open the configuration file.

    For Omnibus package:

    sudo editor /etc/gitlab/gitlab.rb
    

    For installations from source:

    cd /home/git/gitlab
    sudo -u git -H editor config/gitlab.yml
    
  8. See Configure initial settings for initial settings.

  9. Add the provider configuration:

    For Omnibus package:

    gitlab_rails['omniauth_providers'] = [
      {
        name: "salesforce",
        # label: "Provider name", # optional label for login button, defaults to "Salesforce"
        app_id: "SALESFORCE_CLIENT_ID",
        app_secret: "SALESFORCE_CLIENT_SECRET"
      }
    ]
    

    For installation from source:

    - { name: 'salesforce',
        # label: 'Provider name', # optional label for login button, defaults to "Salesforce"
        app_id: 'SALESFORCE_CLIENT_ID',
        app_secret: 'SALESFORCE_CLIENT_SECRET'
    }
    
  10. Change SALESFORCE_CLIENT_ID to the Consumer Key from the Salesforce connected application page.

  11. Change SALESFORCE_CLIENT_SECRET to the Consumer Secret from the Salesforce connected application page.

    Salesforce App Secret Details

  12. Save the configuration file.

  13. For the changes to take effect:

On the sign in page, there should now be a Salesforce icon below the regular sign in form. Select the icon to begin the authentication process. Salesforce asks the user to sign in and authorize the GitLab application. If everything goes well, the user is returned to GitLab and is signed in.

NOTE: GitLab requires the email address of each new user. After the user is signed in using Salesforce, GitLab redirects the user to the profile page where they must provide the email and verify the email.