PingOne

PingOne DaVinci IdP Adapter settings reference

Field descriptions for the PingOne DaVinci IdP Adapter configuration screen.

If you’re using an EU, Canada, or Asia DaVinci tenant, you must update the DaVinci API URL, DaVinci Auth URL, and DaVinci Widget URL. Replace .com with .eu for EU tenants, .ca for Canada tenants, or .asia for Asia tenants. Failure to do so results in an error in the PingFederate logs.

Standard fields

Field Description

Company ID

The company ID that you noted in Adding an application in DaVinci.

Policy ID

The policy ID that you noted in Adding an application in DaVinci.

Flow Type

The type of DaVinci flow that you’re using: Widget-based flow or API-based flow.

Widget-based flows

Designed for user interaction. They can, for example, redirect the browser, present HTML forms or screens, prompt for MFA, or display a message. If your integration requires user interaction, select Widget-based flow.

API-based flows

Run silently and don’t present any opportunity for user interaction. They execute more quickly than widget-based flows (when API-based flow is selected).

API-based flows can, for example, run a risk analysis, check entitlements, or request an authorization policy decision. If your integration doesn’t require user interaction and must be highly performant, select API-based flow.

API Key

The API key that you noted in Adding an application in DaVinci.

Subject Attribute Path

The attribute from DaVinci to use as the subject in the contract.

Map using JSON Pointer (RFC 6901) syntax.

Advanced fields

Field Description

Additional Properties Attribute

The name of the attribute that contains the additional properties from DaVinci.

The default value is additionalProperties.

Nonce Attribute Path

The attribute sent back from PingOne DaVinci for nonce validation.

Map using JSON Pointer (RFC 6901) syntax.

The default value is /parameters/nonce.

HTML Template

Identifies the HTML template the adapter uses. If you customized the template file name in /server/default/conf/template, enter the new name here.

The default value is pingone-davinci.html.

Used for widget-based flows.

Messages File

Identifies the customizable language-pack file that the adapter uses. If you customized the language-pack file name in /server/default/conf/language-packs, enter the new name here.

The default value is pingone-davinci-messages.

Used for widget-based flows.

DaVinci API URL

The DaVinci API URL.

The default value is https://orchestrate-api.pingone.com/.

DaVinci Auth URL

The DaVinci Auth base URL.

The default value is https://auth.pingone.com/.

DaVinci Widget URL

The DaVinci widget JS URL. Used for widget-based flows.

The default value is https://assets.pingone.com/davinci/latest/davinci.js.

To determine whether you need to add the DaVinci widget URL to the allow list for your content security policy (CSP) header, check the response-header-runtime-config.xml file in the <pf_install>/pingfederate/server/default/data/config-store directory. Learn more in this support article.

Send Origin Cookies

When selected, DaVinci forwards only the cookies listed in the Origin Cookies field, sent as a JSON array.

If Origin Cookies is empty, the widget sends no cookies.

If cleared, the widget forwards all cookies from the hosting page.

This checkbox is cleared by default.

Origin Cookies

A comma-separated list of cookies the DaVinci widget forwards to the DaVinci APIs, such as [cookie-1,cookie-2]. When Send Origin Cookies is selected, the widget forwards these cookies as a JSON array.

If this field is empty, the widget sends no cookies.

If Send Origin Cookies is cleared, the widget forwards all cookies from the hosting page.

This field is blank by default.

Learn more in Limiting the cookies passed by the widget in the DaVinci documentation.

Authorization Callback Endpoint

The PingFederate endpoint that DaVinci uses to respond to authorization requests. Used for widget-based flows.

The Application Return To URL setting in the DaVinci connector configuration is <PingFederate Base URL>/ext/<Authorization Callback Endpoint>.

The default value is /davinci-authn.

Service Unavailable Failure Mode

Determines whether the adapter should block the user’s sign-on attempt or bypass when the adapter is unable to access PingOne.

Setting to bypass could result in a security risk if the flow is not configured properly.

Retry Request

Specifies whether to retry a PingOne DaVinci API request that fails with an error code listed in the Retry Error Codes field.

Maximum Retries Limit

The maximum number of times to retry a PingOne DaVinci API request that fails with an error code listed in the Retry Error Codes field.

Retry Error Codes

A comma-separated list of HTTP status codes that trigger a retry of a failed PingOne DaVinci API request.

The default value is 429.

API Request Timeout

The amount of time in milliseconds that PingFederate waits for DaVinci to respond to requests. This value applies to the connect timeout, the socket (response) timeout, and the connection request timeout (the time spent waiting for an available connection in the connection pool).

A value of 0 disables the connect and socket (response) timeouts, allowing requests to wait indefinitely for a connection to be established and for DaVinci to respond. For the connection request timeout, the Apache HttpClient library default of three minutes applies.

The default value is 5000.

Proxy Settings

Defines proxy settings for outbound HTTP requests.

The default value is System Defaults.

To confirm whether you’re using an outbound proxy, check the run.properties file of your PingFederate instance. Outbound proxies are defined by host name and port using the http.proxyHost and http.proxyPort parameters (and their HTTPS equivalents).

If an outbound proxy is configured, select Custom and specify the host name and port in Custom Proxy Host and Custom Proxy Port, respectively.

Custom Proxy Host

The proxy server host name to use when Proxy Settings is set to Custom.

This field is blank by default.

Custom Proxy Port

The proxy server port to use when Proxy Settings is set to Custom.

This field is blank by default.

Max Total Connections

The maximum number of connections that the connection manager keeps in total across all routes to PingOne DaVinci APIs.

The default value is 20.

Max Connections Per Route

The maximum number of connections kept per route (combined remote host and port) to PingOne DaVinci APIs.

The default value is 5.

Connection Time to Live (ms)

The maximum lifetime in milliseconds of a pooled connection. Expired connections are closed rather than reused.

The default value is 300000 or five minutes.