---
title: Configure CIMD settings
description: On the CIMD Settings page, configure the global behavior for all Client ID Metadata Document (CIMD) clients.
component: pingfederate
version: 13.1
page_id: pingfederate:administrators_reference_guide:pf_configuring_cimd_settings
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_configuring_cimd_settings.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: June 22, 2026
page_aliases: ["pf_configuring_CIMD_settings.adoc"]
section_ids:
  steps: Steps
  cache-settings: Cache settings
  connection-settings: Connection settings
  result: Result
---

# Configure CIMD settings

On the **CIMD Settings** page, configure the global behavior for all Client ID Metadata Document (CIMD) clients.

## Steps

1. In the PingFederate admin console, go to **System > OAuth Settings > CIMD Settings**.

2. Select the **Enable CIMD** checkbox to allow PingFederate to process CIMD requests.

3. Configure the **Cache Settings** and **Connection Settings** sections.

   Refer to the following tables for field information.

4. Click **Save**.

|   |                                                                                           |
| - | ----------------------------------------------------------------------------------------- |
|   | Before using CIMD, PingFederate must be configured with an external OAuth client storage. |

## Cache settings

Use the **Cache Settings** section to control how long PingFederate can cache CIMD clients and their retrieved metadata.

| Field                          | Description                                                                                                                                                                                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Minimum Lifetime (seconds)** | The minimum amount of time that PingFederate caches a CIMD client and its metadata, in seconds.Use this setting to prevent frequent metadata retrieval when metadata documents specify very short cache lifetimes.A valid value is an integer between `0` and `86400`.               |
| **Maximum Lifetime (seconds)** | The maximum amount of time that PingFederate caches a CIMD client and its metadata, in seconds.Use this setting to limit how long PingFederate can retain CIMD client data when metadata documents specify long cache lifetimes.A valid value is an integer between `1` and `86400`. |

## Connection settings

Use the **Connection Settings** section to control how PingFederate retrieves client metadata documents.

Review these settings carefully to protect PingFederate from excessive outbound metadata retrieval activity.

| Field                             | Description                                                                                                                                                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Request Timeout (seconds)**     | The maximum amount of time that PingFederate waits to establish a connection when retrieving a client metadata document.A valid value is an integer between `1` and `30`.                                                                                     |
| **Read Timeout (seconds)**        | The maximum amount of time that PingFederate waits to read the metadata response after the connection is established.A valid value is an integer between `1` and `120`.                                                                                       |
| **Maximum Retry Attempts**        | The maximum number of retry attempts that PingFederate makes when retrieving a client metadata document.Use a low value unless your deployment requires additional resilience for temporary network failures.A valid value is an integer between `0` and `5`. |
| **Maximum Response Size (bytes)** | The maximum allowed size of a retrieved client metadata document, in bytes.Use this setting to prevent PingFederate from processing unexpectedly large metadata responses.A valid value is an integer between `1` and `65536`.                                |

## Result

PingFederate applies the CIMD settings globally to all CIMD requests and clients.