Prerequisites

Complete the following prerequisites before deploying the PingIntelligence policy on APIM:

Prerequisite:

Confirm that the Azure API Management Service is available
Version : The PingIntelligence policy supports Azure APIM Q2CY2020 version. If you are using any other version, contact Ping Identity support.
Confirm that the APIs to which you want to apply the PingIntelligence policy are available
Configure CA certificate in APIM: If you want to use the ASE self-signed certificate, then configure the CA certificate from the Security → CA certificates section.
PingIntelligence policy application

Select one of the following four levels to apply the PingIntelligence policy:
- For all the APIs
- For a group of APIs, that is, at the product level
- For individual APIs
- For a specific operation in the API
PingIntelligence software installation

Install and configure PingIntelligence software. Refer to the PingIntelligence deployment guide for your environment.

Verify that ASE is in sideband mode

Check that ASE is in sideband mode by running the following ASE command:

/opt/pingidentity/ase/bin/cli.sh status
API Security Enforcer
status                  : started
 mode : sideband
http/ws                 : port 80
https/wss               : port 443
firewall                : enabled
abs                     : disabled, ssl: enabled
abs attack              : disabled
audit                   : enabled
sideband authentication : disabled
ase detected attack     : disabled
attack list memory      : configured 128.00 MB, used 25.61 MB, free 102.39 MB
google pubsub           : disabled
log level               : debug
timezone                : local (UTC)

If ASE is not in sideband mode, then stop ASE and change the mode by editing the /opt/pingidentity/ase/config/ase.conf file. Set mode as sideband and start ASE.

Enable sideband authentication: For a secure communication between APIM and ASE, enable sideband authentication by entering the following ASE command:
```
# ./bin/cli.sh enable_sideband_authentication -u admin –p
```
Generate sideband authentication token

A token is required for APIM to authenticate with ASE. To generate the token in ASE, enter the following ASE command:
```
# ./bin/cli.sh -u admin -p admin create_sideband_token
```
Save the generated authentication token for further use.