Skip to content

Salesforce

Ironchip acts as the identity provider (IdP) for Salesforce over SAML. This guide explains how to enable single sign-on and, optionally, how to require users or groups to sign in with Ironchip only.

  • Access to the Ironchip admin console.
  • A user with the permissions needed to configure Salesforce.
  1. Sign in to Salesforce as an administrator and go to Setup.

    Salesforce setup menu

  2. Go to Identity and then Single Sign-On Settings.

    Single Sign-On Settings in Salesforce

  3. Click Edit, enable SAML Enabled, and click New from Metadata File.

    Steps to edit the settings, enable SAML, and create from a metadata file

  4. In the Ironchip admin console, go to Applications and click New application.

    New application button in the Ironchip admin console

  5. On the Custom application card, click Create application.

    Custom application card with the Create application link

  6. Select the SAML type and download the metadata file with Download metadata file.

    Selecting the SAML type and downloading the metadata file

  7. Upload the downloaded file to Salesforce and click Create.

    Uploading the Ironchip metadata file in Salesforce

  8. Save the changes (change the name if you want) and download the Salesforce metadata with Download Metadata.

    Saved Single Sign-On Settings with the Download Metadata button

  9. Upload that file to a public internet address and enter its URL, in raw format, in the Metadata URL field of the Ironchip form.

    Metadata URL field of the Ironchip Add a new application form

  10. Click Add service to add the application.

  11. Create the users in Ironchip as shown in the video. The username must be the same as in Salesforce.

Creating Salesforce users in IronchipPlay video

Activate Ironchip as an authentication method

Section titled “Activate Ironchip as an authentication method”
  1. In Salesforce, search for My Domain with the search bar.

    Searching for My Domain in Salesforce

  2. In Authentication Configuration, click Edit.

    Edit button in Authentication Configuration

  3. Under Authentication Service, select the new authentication method and click Save.

    My Domain authentication configuration with the new method selected under Authentication Service

The integration is now configured.

  1. Go to the Salesforce sign-in page and select the Ironchip sign-in option shown below the form.

    Salesforce sign-in page with the Ironchip option

  2. Enter the username.

    Username field

  3. Authorize the connection from the Ironchip app.

    Authorization request in the Ironchip app

This part explains how to configure Salesforce so the users or groups you choose can only authenticate with Ironchip.

  • Salesforce protected by Ironchip.
  • The users you are going to configure already added in Ironchip.
  1. Go to Single Sign-On Settings and enable Disable login with Salesforce credentials.

    Option to disable login with Salesforce credentials

  2. Go to Permission Sets and click New.

    Permission Sets list with the New button

  3. After you create the set, enter Single Sign-On in the search bar and click the only option that appears.

    Searching for Single Sign-On in the permission set

  4. Click Edit, enable the marked option, and save the changes.

    Single sign-on option enabled in the permission set

  5. Go to the Users or Groups panel, depending on which one you want to modify, and click the name of the user or group.

    User list with the name of the user to modify

  6. Scroll down to Permission Set Assignments and click Edit.

    Permission Set Assignments section of the user

  7. Add the set you created at the beginning and save the changes.

    Permission set added to the user’s assignments

Try to sign in with the credentials of a user configured with this rule. Entering a Salesforce username and password doesn’t let you in. Using Ironchip does.