Page created: 26 Jul 2021 |
Page updated: 17 Feb 2022
This tutorial describes how to create a policy for a REST service to control access based on an acceptable audience value.
An authorization server like PingFederate might set an
on the access tokens that it issues, naming one or more services that are allowed to
accept the access token. A REST service can use the
audience field to
ensure that it does not accept access tokens that are intended for use with a different
As with the Permitted Clients policy, each rule in the Permitted Audiences policy defines an acceptable audience value.
- Go to .
- Expand Global Decision Point and SCIM Policy Set.
- Highlight Token Policies and click + and then Add Policy.
- For the name, replace Untitled with Permitted Audiences.
- From the Combining Algorithm list, select Unless one decision is permit, the decision will be deny.
- Click + Add Rule.
- For the name, replace Untitled with Audience: https://example.com.
- From the Effect list, select Permit.
In the Condition section:
- Click + Comparison.
- From the Select an Attribute list, select HttpRequest.AccessToken.audience.
- From the middle, comparison-type list, select Equals.
- In the final field, enter https://example.com.
- Expand + Advice and Obligations.
Click the Components tab, expand
Advice, and drag Unauthorized
Audience to the Advice and Obligations
Do not click Show Advice and Obligations within the "Audience: https://example.com" rule.
- Click Save changes.