Add an SSO link in Salesforce (example)

Create a dynamic single sign-on (SSO) link and add it to your Salesforce page.

Steps

In the Salesforce administrative console, go to Setup > Customize > Home > Custom Links.
On the Home page, in the Custom Links section, click New.
Complete the Label, Name, and Description fields.
In the Content Source list, select URL.

In the text area, enter one of the following URLs:

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. Learn more about Global Variables in the Salesforce documentation.

Choose from:

For SSO through 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: The host name or IP address of the PingFederate server.
- pf_port: The port number of the PingFederate server.
- destination_URL: The fully-qualified URL of the target application or other protected resource.
- connection_ID: 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 through 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: The host name or IP address of the PingFederate server.
- pf_port: The port number of the PingFederate server.
- destination_URL: The fully-qualified URL of the target application or other protected resource.
- adapter_ID: 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

Click Save.
Go to Setup > Customize > Home Page Components.
Add a new link component using the custom link that you created.
Go to Setup > Customize > Home Page Layout.
Edit your existing layout or create a new layout to include the new link component.
Check that the user profile is configured to use the page layout that you modified.