---
title: PingOne DaVinci IdP Adapter settings reference
description: Field descriptions for the PingOne DaVinci IdP Adapter configuration screen.
component: pingone
page_id: pingone:pingone_davinci_integration_kit:pf_p1_davinci_idp_adapter_settings_reference
canonical_url: https://docs.pingidentity.com/integrations/pingone/pingone_davinci_integration_kit/pf_p1_davinci_idp_adapter_settings_reference.html
llms_txt: https://docs.pingidentity.com/integrations/pingone/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: November 18, 2026
section_ids:
  standard-fields: Standard fields
  advanced-fields: Advanced fields
---

# 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](pf_p1_davinci_ik_adding_an_application_in_davinci.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Policy ID**              | The policy ID that you noted in [Adding an application in DaVinci](pf_p1_davinci_ik_adding_an_application_in_davinci.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **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](pf_p1_davinci_ik_adding_an_application_in_davinci.html).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Subject Attribute Path** | The attribute from DaVinci to use as the subject in the contract.Map using JSON Pointer ([RFC 6901](https://www.rfc-editor.org/info/rfc6901/)) 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`.&#xA;&#xA;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](https://docs.pingidentity.com/davinci/integrating_flows_into_applications/davinci_launching_a_flow_with_the_widget.html) in the DaVinci documentation. |
| **Authorization Callback Endpoint**  | The PingFederate endpoint that DaVinci uses to respond to authorization requests. Used for widget-based flows.&#xA;&#xA;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.&#xA;&#xA;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**.&#xA;&#xA;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).&#xA;&#xA;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.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
