HELP FILE

Remedyforce BMC App Integration

    Set up a Remedyforce BMC app integration so that your users can sign into this app using the same credentials that they use for LastPass.

    Part 1 - Add the SSO app to LastPass

    About this task:
    1. Log in and access the LastPass new Admin Console by doing either of the following:
      • While logged in to LastPass, click the active LastPass icon active LastPass icon in your web browser toolbar, then select Admin Console in the menu.
      • Log in at https://admin.lastpass.com with your admin email address and master password.
    2. Go to Applications > SSO apps.
    3. Select Add app in the upper-right navigation (or Search the catalog if you're adding your first app).
    4. Search for and select your app from the catalog (or Add an unlisted app if you can't find your app).
    5. Click Continue, and you are taken to the Set up LastPass section of the app configuration.

      Fastpath: LastPass automatically fills out all required information in the Set up app section for you. Some apps allow you to upload settings in an XML file, while others require you to copy and paste the following information:
      Name in LastPass Value
      Entity ID 
      https://identity.lastpass.com
      SSO Endpoint 
      https://identity.lastpass.com/SAML/SSOService
      Logout URL 
      https://identity.lastpass.com/Login/Logout
      Certificate fingerprint Provided in the Set up app section of the SSO app. If needed, download the LastPass certificate in PEM, DER, or Download metadata (XML) format.
      Certificate fingerprint (SHA256)
      Certificate (PEM)

    6. For the next steps, open a new web browser window or tab. Go to the app's settings to enable single sign-on, and make sure your app recognizes LastPass as the Identity Provider.

    Part 2 - Configure the app in Remedyforce BMC

    Before you begin: You must have a company domain set up and allow third-party cookies in your browser before proceeding with the steps below.
    Troubleshooting: If your company domain is not set up yet, go to Company Settings > My Domain and create a new domain using the following format:
    <yourworkdomain>.my.salesforce.com
    About this task: For detailed instructions, please see Remedyforce BMC documentation.
    1. Open a new tab on your browser and log to the admin portal.
    2. Select the Setup menu in the upper-right navigation, then select Setup.

      Setup - Salesforce

    3. Select Company Settings > My Domain to verify that you have a company domain set up.

      Work domain - Salesforce

    4. Select Identity > Single Sign-On Settings in the left navigation.

      SSO settings in Salesforce

    5. Select Edit.

      Enable saml- Salesforce

    6. For the Federated Single Sign-on Using SAML section, enable the SAML enabled setting and click Save.

      Note: Enable the Make Federation ID case-insensitive checkbox if you want to make the Federation ID field on a user object case-insensitive. If there are Federation ID duplicates, make each ID unique before you enable this setting. Make sure the new Federation ID is updated everywhere it’s used.
      enable saml checkbox- Salesforce

    7. In the SAML Single Sign-on Settings section, select New to add a new entry.

      new idp configuration - Salesforce

    8. Enter the following information:

      Name Description Value
      Name SAML provider LastPass
      API Name Enter your desired name Custom
      Issuer Entity ID value (copied from the LastPass Admin Console) 
      https://identity.lastpass.com
      Entity Id Also known as the Issuer ID or App ID for your app, this is the Metadata URL of the Service Provider.
      • If you have a custom domain setup, use the following format: 
        https://[customDomain].my.salesforce.com
      • If you do not have a custom domain setup, use the following:
        https://saml.salesforce.com
      Identity Provider Certificate LastPass certificate file you downloaded in Part 1 Upload the LastPass Certificate that you downloaded in Part 1
      Identity Provider Login URL SSO endpoint value (copied from the LastPass Admin Console) 
      https://identity.lastpass.com/SAML/SSOService
      Identity Provider Logout URL Logout URL (copied from the LastPass Admin Console) 
      https://identity.lastpass.com/Login/Logout
      Custom Error URL SSO endpoint value (copied from the LastPass Admin Console) 
      https://identity.lastpass.com/SAML/SSOService

    9. Click Save.

      SAML Single Sign-On Settings

    10. Copy the Salesforce Login URL value and paste it into a text editor.

      Remember: You will be using this value in later steps.

      Salesforce Login URL in SAML settings

    11. In the left navigation, select Company Settings > My Domain.
    12. In the Authentication Configuration section, click Edit.

      Edit Authentication Configuration settings

    13. Uncheck the Login Form setting.
    14. Enable the LastPass setting.
    15. Click Save.

      Update Authentication Service Settings

    Part 3 - Finalize the Remedyforce BMC SSO app configuration in LastPass

    1. Return to the LastPass new Admin Console.
    2. Back on the Configure app page in the LastPass Admin Console (from Part 1), select Set up LastPass.
    3. For the "ACS" field, paste the Salesforce Login URL (copied in Part 2).
    4. Optional: Enable Step-up authentication if you want to require users to confirm their identity using the LastPass Authenticator app upon each login to this SSO app.

      Remember: Passwordless login for SSO apps only supports authentication using stored biometrics (face or fingerprint) via push notification in the LastPass Authenticator app.

    5. Select Advanced settings.
    6. For the Entity ID field, paste the Service provider entity URL copied in Part 2.
    7. Optional: If desired, in the Advanced settings section, add any of the following additional customizations:

      Name in LastPass Description/Value
      Nickname The name of the app how it appears in the Admin Console (and Cloud Apps, if your users have a LastPass password management vault)
      Role Custom role that you created to organize users and the permissions assigned to them
      Identity Provider (LastPass) This is the URL of the identity provider, which is LastPass:
      https://identity.lastpass.com
      Relay State URL to which the service provider redirects the user after processing the SAML response
      Identifier These settings will depend on the app you're configuring – please refer to the SSO app's documentation, then select one of the following:
      • Email (default)
      • Secondary Email
      • User ID
      • Groups
      • Roles
      • Custom
      SAML signature method SHA256 (uses 256-bit hash)
      Signing and encryption Make your desired selections from the following:
      • Sign assertion
      • Encrypt assertion
      • Sign request
      • Sign response
      Upload partner certificate Select the partner certificate you saved locally (if applicable)
      Custom attributes To add more custom attributes, select Add SAML attribute and choose from the following options:
      • Email
      • Secondary Email
      • User ID
      • Groups
      • Roles
      • Custom (associated with the SSO app)
      Tip: You can define custom attribute statements when creating a new SAML integration, or modifying an existing one. These statements are inserted into the SAML assertions shared with your app.

    8. Click Save & assign users > Users, groups & roles to begin making your selections.
    9. Search for and select your desired users, groups, and/or roles, then click Assign.
    10. Click Save & continue > Finish.

      Result: Setup for your SSO app is complete! The LastPass users you assigned to this SSO app can now use their LastPass account to sign in to this SSO app going forward.