1. In the Salesforce administrative console, go to Setup > Customize > Home > Custom Links.
  2. On the Home page, in the Custom Links section, click New.
  3. Complete the Label, Name, and Description fields.
  4. From the Content Source list, select URL.
  5. In the text area, enter one of the following URLs:
    Tip:

    You can insert {!API.Session_ID} and {!API.Partner_Server_URL_200} (or equivalent) by selecting $Api from the Select Field Type list, and then selecting the variable you want from the Insert Field list.

    Salesforce dynamically populates these variables when the user clicks the link. For more information, see Global Variables in the Salesforce documentation.

    • For SSO via an SP-partner connection in PingFederate:
      https://pf_host:pf_port/idp/startSSO.ping?
sid={!API.Session_ID}&apiendpoint={!API.Partner_Server_URL_200}&
TargetResource=destination_URL&
PartnerSpId=connection_ID
      Replace the variables as follows:
      • pf_host is the host name or IP address of the PingFederate server.
      • pf_port is the port number of the PingFederate server.
      • destination_URL is the fully-qualified URL of the target application or other protected resource.
      • connection_ID is the Partner's Entity ID (Connection ID) of the service provider (SP) connection that you configured.
      Example URL:
      https://pingfederate.example.com:9031/idp/startSSO.ping?sid={!API.Session_ID}&apiendpoint={!API.Partner_Server_URL_200}&TargetResource=https://portal.example.com/welcome&PartnerSpId=SFConnection1
    • For SSO via IdP-to-SP adapter mapping in PingFederate:
      https://pf_host:pf_port/pf/adapter2adapter.ping?
sid={!API.Session_ID}&apiendpoint={!API.Partner_Server_URL_200}&
TargetResource=destination_URL&
IdpAdapterId=adapter_ID
      Replace the variables as follows:
      • pf_host is the host name or IP address of the PingFederate server.
      • pf_port is the port number of the PingFederate server.
      • destination_URL is the fully-qualified URL of the target application or other protected resource.
      • adapter_ID is the Instance ID of the Salesforce IdP Adapter that you configured.
      Example URL:
      https://pingfederate.example.com:9031/pf/adapter2adapter.ping?sid={!API.Session_ID}&apiendpoint={!API.Partner_Server_URL_200}&TargetResource=https://portal.example.com/welcome&IdpAdapterId=SFAdapter1
  6. Click Save.
  7. Go to Setup > Customize > Home Page Components.
  8. Add a new link component using the custom link that you created.
  9. Go to Setup > Customize > Home Page Layout.
  10. Edit your existing layout, or create a new layout, to include the new link component.
  11. Check that the user profile is configured to use the page layout that you modified.