Agentless Integration Kit

Developing your application

The Agentless Integration Kit doesn’t require you to install special agent software, but you will have to modify your application to communicate with the PingFederate Reference ID Adapter through HTTP calls. The following information and recommendations should guide your development process.

About this task

This section provides example code in Java. To get the latest example code for a variety of languages (including .NET, PHP, and Python) see the Agentless Integration Kit projects in the Ping Identity GitHub repository. Choose the language you use and see the example-code directory to help you with the following steps.

Steps

  1. Determine whether your application will need to pick up attributes, drop off attributes, or both.

    Typically, if your application acts as an identity provider, it will drop off attributes with PingFederate. If your application acts as a service provider, it will pick up attributes from PingFederate.

  2. Configure an endpoint in your application to receive REF and resumePath values from PingFederate.

    Note the endpoint URL. You’ll enter it in the Authentication Endpoint field when you configure a Reference ID Adapter instance later in the setup process.

  3. Decide how your application will authenticate with PingFederate.

    For details, see Authentication methods.

  4. Configure your application to do one or both of the following:

  5. Configure your application to redirect the browser to the URL provided in the resumePath parameter, which PingFederate provided in the attribute drop-off process.

    Redirect URL format:

    https://pf_host:pf_port/resume_path?REF=reference_ID

    Example code:

    String resumeURL = String.format("https://localhost:9031%s?REF=%s", resumePath, ref);
    
    response.sendRedirect(resumeURL);