PingIntelligence

Deploying PingIntelligence for MuleSoft 4.x

About this task

The PingIntelligence policy for MuleSoft now supports two languages:

  • Groovy

  • Java

Based on your environment and requirements, either of the policies can be deployed.

The PingIntelligence MuleSoft Java policy supports asynchronous invocation from the Gateway to PingIntelligence ASE.

The PingIntelligence policy for MuleSoft tar is now comprised of the following structure (after extraction):

pingidentity/
`-- mulesoft-policy
    |-- mulesoft-3.9
    |   |-- policy.xml
    |   `-- policy.yaml
    |-- mulesoft-4.0-groovy
    |   |-- policy.xml
    |   |-- policy.yaml
    |   `-- pom.xml
    `-- mulesoft-4.0-java
        |-- mule-artifact.json
        |-- policy.xml
        |-- policy.yaml
        `-- pom.xml

Complete the following steps to deploy the PingIntelligence policy for the MuleSoft 4.0 Groovy or Java policy:

To deploy the PingIntelligence policy for the MuleSoft 4.x or MuleSoft 4.0 Groovy or Java policy:

Steps

  1. Create a project directory by following the instructions in Getting started with Custom Policies development.

    The following screenshot shows an illustrative sample of a project directory structure.

    An example project directory structure.

    The PingIntelligence policy package provides three files for 4.x:

    • policy.xml: Contains the actual logic of the policy.

    • policy.yaml: Has details that render policy configuration UI.

    • pom.xml: Specifies dependencies for policy compilation.

  2. When the project’s directory structure is created, replace the contents of my-custom-policy.yaml with that of the policy.yaml file, and the contents of template.xml with that of policy.xml. Similarly, replace the contents of pom.xml with that of the pom.xml file provided in the PingIntelligence policy package.

    The project directory structure with arrows pointing to which files to copy the contents.

  3. Edit the pom.xml file to enter your organization’s groupID:

    <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

     <groupId>7a0f5884-ba26-4929-a681-66ca288a6992</groupId>
    <artifactId>PingIntelligence</artifactId>
    <version>1.2.0</version>
    <name>PingIntelligence</name>
    <description>ASE Sideband Policy for mule 4 with username info</description>

  4. From the command line in your project folder, run the following command.

    This packages the PingIntelligence policy and creates a deployable JAR file.

    > mvn clean install

    You require license to MuleSoft Enterprise Repository for compiling the policy.

  5. Upload the PingIntelligence policy to Exchange by following the instructions in Deploying a Policy Created Using the Maven Archetype.

    Result:

    The PingIntelligence policy is now available to apply to your APIs. For more information, see Applying the PingIntelligence policy.