PingFederate Server

Defining token exchange processor policies

To exchange security tokens, the OAuth authorization server needs at least one token exchange processor policy.

Before you begin

Before you define a token exchange processor policy, create the necessary token processor instances. See Managing token processors.

About this task

In the Token Exchange Processor Policy Management window, configure and define a token exchange processor policy.

Steps

  1. Go to Applications → Token Exchange → Processor Polices to open theToken Exchange Processor Policy Management window.

  2. Click Add Processor Policy.

    Result:

    The Token Exchange Processor Policy window opens.

  3. On the Manage Processor Policy tab, enter the policy ID and Name. Click Next.

    Select the Actor Token Required check box if you want to specify whether the policy requires an actor token as well as a subject token in the token exchange requests from the clients.

  4. On the Attribute Contract tab, add attributes to the attribute contract as needed. Click Next.

  5. On the Token Processor Mapping tab, map a token processor to each subject token type or each combination of subject token type and actor token type:

    1. Click the Map New Token Processor button.

      Result:

      The Token Processor Mapping window opens.

    2. On the Token Types tab, from the Subject Token Processor list, select the instance.

    3. In the Subject Token Type field, enter the identifier.

    4. If an actor token processor is required, from the Actor Token Processorlist, select the instance.

    5. In the Actor Token Type field, enter the identifier. Click Next.

    6. On the Attribute Sources & User Lookup tab, add additional attribute sources for contract fulfillment as needed. Click Next.

    7. On the Contract Fulfillment tab, select the Source and Value for each attribute. Click Next.

    8. On the Issuance Criteria tab, specify conditions that attributes must satisfy for PingFederate to exchange the token. Click Next.

    9. On the Summary tab, review the token processor mapping. Click Done.

      Result:PingFederate returns you to the Token Exchange Processor Policy window.

  6. On Summary tab, review the policy. Click Done.

    Result:

    The Token Exchange Processor Policy Management window opens.

  7. If you want to make the new token exchange processor policy the default policy, click Set as Default on the corresponding row in the table.

  8. Click Save.