Salesforce as IDP – Cloud SAML

Part 2: Setup miniOrange with Salesforce


Step 1. Setup Salesforce as IDP


  • Log in to Salesforce Portal.
  • Click on your profile icon on the top right then click Switch to Salesforce Classic mode from the profile/ menu and then go to the Setup page.
    • Salesforce Saml App
  • From the left pane, select Security Controls -> Identity Provider.
    • Salesforce Saml App
  • In the Service Provider section, click on the link (Service Providers are now created via Connected Apps. Click here.) to create the Service Provider using Connected Apps.
    • Salesforce Saml App
  • Enter Connected App Name, API Name and Contact Email.
    • Salesforce Saml App
  • Under the Web App Settings, check the Enable SAML checkbox and enter the following values:
    • Entity ID Entity ID or Issuer: Refer this step
    ACS URL ACS URL (For SP-Initiated SSO) Refer this step
    Single Logout URL Logout Url from Salesforce
    Subject Type Username
    Name ID Format urn:oasis:names:tc:SAML:2.0:nameid-format:persistent
  • Then click on Save.
  • Now from the left pane, under the Administer section, go to Manage Apps -> Connected Apps.
    • Salesforce Saml App
  • Click on the app you just created.
    • Salesforce Saml App
  • Under the Profiles section click the Manage Profiles button and select the profiles you want to give access to log in through this app.
    • Salesforce Saml App
  • Under SAML Login Information, click on Download Metadata.
    • Salesforce Saml App
    Keep this metadata handy for the next steps.

    Step 2. Setup miniOrange as Service Provider

  • Go to miniOrange Admin Console.
  • From the left navigation bar select Identity Provider. Then click on Add Identity Provider
    • Salesforce Saml App
  • Select SAML tab.
    • Salesforce Saml App
    You can get the metadata details of miniOrange app either by clicking on the link shown by "Click here" in the yellow block, Or you can also get the details after creating the app. Keep these details handy as we will need these in configuring Salesforce.
  • Click on Show Metadata details under For SP - INITIATED SSO. You can either manually enter details or use Metadata URL or File
    • Salesforce Saml App
  • Now to create SAML app for Salesforce, go to the Add Identity Provider page and click on Import IDP Metadata. Import the metadata file that you will get from the SAML Login Information section of Salesforce. Refer this step.
    • Salesforce Saml App
  • If you don't have a metadata file, you can also provide the details manually. You need to configure following endpoints:
    • IDP Entity ID Entity ID of IDP
    Single Login URL Login Url from IDP
    Single Logout URL Logout Url from IDP
    X.509 Certificate The public key certificate of your IDP.
  • Few other optional features that can be added to the Identity Provider(IDP) are listed in the table below:
    • Domain Mapping Can be used to redirect specific domain user to specific IDP
    Show IdP to Users Enable this if you want to show this IDP to all users during Login
    Send Configured Attributes Enabling this would allow you to add attributes to be sent from IDP
  • Click on Save.

Step 3. Test connection between miniOrange and Salesforce

  • Go to the miniOrange Admin Dashboard.
  • Go to Identity Providers tab. Then click on select button under the app you just created. Then click on Test Connection.
  • A new popup login window will open. Enter your credentials and login.
    • Atlassian Access Cloud SSO (Single Sign-On) Add Member
  • Now you will see TEST SUCCESSFUL in a new popup window. If not, then check if you have missed any of the above step.