---
title: Deploying the PingIntelligence policy
description: PingIntelligence provides an XML Extensible Markup Language (XML) policy file to integrate PingIntelligence and Azure API Management Service.
component: pingintelligence
version: 5.2
page_id: pingintelligence:pingintelligence_integrations:pingintelligence_deploy_azure_policy
canonical_url: https://docs.pingidentity.com/pingintelligence/5.2/pingintelligence_integrations/pingintelligence_deploy_azure_policy.html
revdate: April 3, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  next-steps: Next steps
---

# Deploying the PingIntelligence policy

PingIntelligence provides an XML Extensible Markup Language (XML) *(tooltip: \<div class="paragraph">
\<p>A structured, hierarchical text format, based on SGML, for the flexible and organized exchange of data.\</p>
\</div>)* policy file to integrate PingIntelligence and Azure API Management Service.

## About this task

This policy can be applied at an individual API level, for all the APIs, to a group of APIs, or for an operation of an API. PingIntelligence recommends that the PingIntelligence policy be the first policy in the Azure policy XML. This ensures that all the traffic is captured by ASE and sent to the PingIntelligence artificial intelligence (AI) engine for analysis.

To deploy the PingIntelligence policy:

## Steps

1. [Download](https://www.pingidentity.com/en/resources/downloads/pingintelligence.html) the **Azure API Management** policy XML file from the **Sideband Integration** section of the PingIntelligencedownloads page.

2. Open the downloaded Azure policy XML file and copy the policy at the desired level: all APIs, individual APIs, operation level, or group of APIs. Click **Policies** in the **Inbound processing** box and paste the policy.

   |   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   |   | The PingIntelligence policy does not validate the authenticity of a JSON Web Token (JWT) *(tooltip: \<div class="paragraph">&#xA;\<p>An IETF standard container format for a JSON object used for the secure exchange of content, such as identity or entitlement information. You can find the industry standard in \<a href="https\://datatracker.ietf.org/doc/html/rfc7519">RFC 7519\</a>.\</p>&#xA;\</div>)*. Configure the PingIntelligence policy after the `<validate-jwt>` policy. |

   ![A screenshot of the Inbound processing window.](../_images/jnr1564009247651.png)

3. Click the **Save** button to save the policy.

   ![A screenshot of the PingIntelligence policy XML policy.](../_images/kaq1564009250251.png)

   |   |                                                                                                                                                                                                                                                                                                                    |
   | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   |   | If an existing policy is deployed, copy and paste the `<inbound>` section of the PingIntelligence policy into the `<inbound>` section of your existing policy. Similarly, replace the `<outbound>` section of the policy. It is recommended that the PingIntelligence policy be the first policy that is executed. |

## Next steps

PingIntelligence API discovery is a process to discover and report APIs from your API environment. The discovered APIs are reported in PingIntelligence Dashboard. APIs are discovered when a global API JavaScript Object Notation (JSON) *(tooltip: \<div class="paragraph">
\<p>An open, lightweight data-interchange format that uses human-readable text to store and transmit data.\</p>
\</div>)* is defined in the ASE. For more information, see [API discovery and configuration](../managing_pingintelligence_for_apis/pingintelligence_api_discovery_configuration.html). You can edit the discovered API's JSON definition in the Dashboard before adding it to ASE. For more information on editing and configuring API discovery, see [Discovered APIs](../managing_pingintelligence_for_apis/pingintelligence_discovered_apis.html).