ARTIFACTORY: How to configure Artifactory SAML SSO with PingFederate

Products
Frog_Artifactory
Content Type
Installation_Setup
AuthorFullName__c
Harry Van, Shisiya Sebastian
articleNumber
000001529
FirstPublishedDate
2016-10-06T13:35:53Z
lastModifiedDate
2026-09-15

ARTIFACTORY: How to configure Artifactory SAML SSO with PingFederate

Introduction
PingFederate is an enterprise federation server that enables user authentication and single sign-on. The JFrog Platform offers a SAML-based Single Sign-On service allowing identity providers full control over the authentication process. Using SAML, the JFrog Platform acts as a service provider that receives users’ authentication information from external identity providers like PingFederate.
To integrate PingFederate with Artifactory using SAML SSO, the following actions are included.
  • Set up an IDP Adapter for managing users or Identities
  • Configure an SP connection to authorize access to Artifactory
  • Configure Artifactory SAML SSO with Authentication Provider information


Set up a simple IDP Adapter instance
If you already have an IDP adapter, please ignore the steps below and go to the next action.
  1. Go to the PingFederate UI and then IdP Adapters
  2. Create a new Instance and add Name, ID
  3. Select a suitable adapter, ex: HTML Form ID Adapter, and click Next
  1. Click on the button “Add a new row to ‘Credential Validators’” - If one is available, skip to step 11.
  1. If one is not available, you can create one by scrolling down and clicking on ‘Manage Password Credential Validators’
  1. Click ‘Create new Instance’. Give it a Name and ID, for my example, I am using ‘SimpleUserAndPass’ and setting the type to ‘Simple Username Password Credential Validator’
Click Next.
  1. Now we under the Instance Configuration, we can add a test user.
  1. Create a new user by providing a Username and Password, then click Update to save the user. Then click Next.
  1. Confirm the Credential settings and click Save.
  1. This will bring you back to the ‘Manage Password Credential Validators’ tab. Click Done
  1. Click ‘Add a new row to ‘Credential Validators’ and select your Credential Validators from the drop-down, then click Update, and Next.
  1. Click Next when on the Extend Contract screen
  1. On the “Adapter Attributes” tab, under “Unique User Key Attribute,” select username, and select the Pseudonym for any other attribute other than ‘username’ then click next
  1. Skip “Adapter Contract Mapping” and click next
  1. Review the IdP adapter summary and click save


Configure an SP connection
Here, we are mapping the IDP Adapter and the Artifactory service.
  1. Log in to your PingFederate UI.
  2. Under SP Connections, click on Create Connection.
  1. On the Connection Template page, choose “Do not use a template for this connection” and click Next
  1. Under Connection Type, select Browser SSO Profiles, choose the SAML 2.0 protocol, and click Next.
  1. On the Connection Options page, tick the Browser SSO checkbox, and click Next.
  1. Under Import Metadata select NONE and click Next.
  1. On the General Info page, in the Partner’s Entity ID (Connection ID) textbox, enter the base URL of your Artifactory Instance.
  1. In the Connection Name textbox, fill in the desired name. Then, click Next.
  2. On the Browser SSO page, click on Configure Browser SSO.
  1. On the SAML Profiles page, tick only the SP Initiated SSO checkbox. Then, click Next.
  1. You can skip the Assertion Time page by clicking Next.
  2. On the Assertion Creation page, click on Configure Assertion Creation.
  1. On the Identity Mapping page, select Standard and click Next.
  1. On the Attribute Contract page, for the Attribute contract  “SAML_SUBJECT”, select Subject Name Format as “urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified”, and click Next.
  1. On the Authentication Source Mapping page, select Map New Adapter Instance.
  1. On the Adapter Instance page, under the Adapter Instance dropdown menu, choose your desired adapter (Note: To configure the adapter instance, refer to the steps above). Click Next.
  1. Under Mapping method, select “Use only the Adapter Contract values in the SAML assertion” and click Next.
  1. On the Attribute Contract Fulfillment page, in the Attribute Contract section, select Adapter in the Source dropdown menu, select the username in the Value dropdown menu, and click Next. (username should be one of the adapter contract value you created or which is available in the IDP adapter)
  1. Skip the Issuance Criteria page by clicking Next.
  2. On the Summary page, click Done.
  3. On the Authentication Source Mapping page, click Next.
  4. On the Summary page, click Done.
  5. On the Assertion Creation page, click Next.
  6. On the Protocol Settings page, select Configure Protocol Settings.
  1. On the Assertion, Consumer Service URL page, tick the default checkbox and enter the value “0” in the Index textbox. Then, select POST in the Binding dropdown menu. In the Endpoint URL, fill in https://${ARTIFACTORY_URL}/ui/api/v1/auth/saml/loginResponse/<saml_display_name>
    Note:

    The saml_display_name you provide will be used for Artifactory’s SAML SSO display name settings; use anything aside from “default” and the name must start with a lowercase letter and only contain lowercase letters, digits and `-` character. In my example, I set saml_display_name to pingfed.
    Click the Add button, and click Next.
  1. On the Allowable SAML Bindings page, tick only the POST and Redirect checkboxes. Then, click Next.
  1. On the Signature Policy page, tick the Always sign the SAML assertion checkbox. Then, click Next.
  1. On the Encryption Policy page, choose None, and click Next.
  2. On the Summary page, click Done.
  1. On the Protocol Settings page, click Next.
  2. On the Summary page, click Done.
  3. On the Browser SSO page, click Next.
  4. On the Credentials page, click Configure Credentials.
  1. Click on Manage certificates and create a new certificate. Fill in the Common Name and Organization, set the Signature Algorithm to RSA SHA256, click Next, and click Done
  1. On the Summary page, make sure “Make This The Active Certificate” is checked, and click Save.
  1. Back on the Certificate Management page, click Done.
  1. On the Digital Signature Settings page, under the Signing Certificate dropdown menu, select the desired certificate with RSA SHA256. Then, click Next.
  1. On the Summary page, click Done.
  2. On the Credentials page, click Next.
  3. On the Activation & Summary page, click Save.


Configure and get the PingFederate Server IP and details:
System → Server → Protocol settings
Set your SAML 2.0 Entity ID here; this will be used in the Artifactory SAML SSO configuration under SAML Service Provider Name/Identity Provider Entity ID


Export the SAML metadata: We will be using this to get the SAML certificate and the Login URL
Under the SP Connections page, in the Connection Name under the Action column, click on Export Metadata.
Select the Artifactory Cert we created earlier in the drop-down, then click Next.
Click Export and save the metadata.xml file. Then, click Done.


Configure PingFederate in Artifactory SAML SSO
Once the SP connection is completed in PingFederate, we can use those details to configure it in the Artifactory UI.
  1. Log in to Artifactory UI as an admin user.
  2. Navigate to Administration → Authentication → SAML SSO
  3. Tick the Enable SAML Integration checkbox.
  4. In the SAML Login URL text box, fill in https://{PINGFEDERATE_URL}:{PORT}/idp/SSO.saml2. (Ex: https://pingfederate.jfrog.io:9031/idp/SSO.saml2)
  5. In the SAML Logout URL, fill in https://ARTI_URL/ui/login( Ex: https://myartifactory.jfrog.io/ui/login)
  6. In the SAML Service Provider Name/Identity Provider Entity ID (Issuer) textbox, fill in the SAML 2.0 Entity ID that you configured for your IDP in the SP connection (here, “HarryVPingfed”).
  7. In the SAML Certificate textbox, fill in the x509 certificate that was provided with the metadata.xml file that you exported from your PingFederate instance.
  1. Select “Auto Create users”
  2. Click Save.
  3. Log out of Artifactory, then to verify that your configuration is correct, click "Log In" and click "SAML SSO"


Snippet from Artifactory SAML SSO
Troubleshooting
After SAML integration, if you are unable to log in, please review the artifactory-service.log. A sample error message is as follows
Error occurred while trying to login using SAML: Fail to find SAML Assertion in response.
This happens if the SAML SSO configuration in Artifactory and PingFederate are not matching.
  1. Verify whether the SAML Service Provider and Entity ID in the SP connection are matching or not
  2. Verify the Consumer Service URL is correctly given in SP connections.
You can also verify the server.log of PingFederate and see that the SAML response received from Artifactory is not the same as configured.


Reference:
https://jfrog.com/help/r/jfrog-platform-administration-documentation/saml-sso