---
title: Customizing a configuration endpoint response
description: You can customize the PingFederate [.filepath]``openid-configuration.template.json`` template to configure both OpenID Connect (OIDC) discovery and OAuth authorization server metadata endpoints.
component: pingfederate
version: 13.1
page_id: pingfederate:administrators_reference_guide:pf_customiz_config_endpoint_response
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_customiz_config_endpoint_response.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: May 23, 2025
section_ids:
  about-this-task: About this task
  customizing_the_openid_provider_configuration_endpoint_response: Customizing the OpenID Provider configuration endpoint response
  steps: Steps
  customizing-the-oauth-authorization-server-metadata-endpoint-response: Customizing the OAuth authorization server metadata endpoint response
  steps-2: Steps
  related-links: Related links
---

# Customizing a configuration endpoint response

## About this task

You can customize the PingFederate `openid-configuration.template.json` template to configure both OpenID Connect (OIDC) discovery and OAuth authorization server metadata endpoints. To suit multiple use cases simultaneously, you can customize the amount of configuration information and add conditional statements to return different responses, based on information from the requests.

## Customizing the OpenID Provider configuration endpoint response

The OpenID Provider (OP) configuration endpoint at `/.well-known/openid-configuration` provides configuration information for the OAuth clients to interface with PingFederate using the OIDC protocol.

### Steps

1. Edit the `<pf_install>/pingfederate/server/default/conf/template/openid-configuration.template.json` file to specify the desired information to be returned by the OAuth metadata configuration endpoint.

   Multiple samples are provided, including sample statements using the `$HttpServletRequest` and `$HttpServletResponse` objects to get and set values.

2. Save your changes.

   Template customization doesn't require a restart of PingFederate.

   For a clustered PingFederate environment, repeat these steps on each node.

## Customizing the OAuth authorization server metadata endpoint response

The OAuth authorization server metadata endpoint at `/.well-known/oauth-authorization-server` provides configuration information for the OAuth clients to interface with PingFederate using the OAuth 2.0 protocol.

### Steps

1. Edit the `<pf_install>/pingfederate/server/default/conf/template/openid-configuration.template.json` file to specify the desired information to be returned by the OAuth metadata configuration endpoint.

   Multiple samples are provided, including sample statements using the `$HttpServletRequest` and `$HttpServletResponse` objects to get and set values.

2. Save your changes.

   Template customization doesn't require a restart of PingFederate.

   For a clustered PingFederate environment, repeat these steps on each node.

## Related links

* [OpenID Provider configuration endpoint](../developers_reference_guide/pf_openid_provider_config_endpoint.html)

* [OAuth authorization server metadata endpoint](../developers_reference_guide/pf_oauth_authorization_server_metadata_endpoint.html)

* [HttpServletRequest](https://javaee.github.io/javaee-spec/javadocs/javax/servlet/http/HttpServletRequest.html) in the Java EE 8 Specification APIs documentation.