PingAuthorize

Sideband API Endpoint configuration properties

The following table identifies Sideband API Endpoint properties that might force the inclusion of additional attributes with the policy request.

Property Description

base-path

Defines the URI path prefix that the Sideband API uses to determine whether the Sideband API Endpoint handles a request.

The base-path property value can include parameters. If parameters are found and matched, they are included as attributes to policy requests.

The following configuration properties can reference parameters that base-path introduces:

  • service

  • resource-path

  • policy-request-attribute

service

Identifies the API service to the PDP. A policy can use this value to target requests.

The service value appears in the policy request as the service attribute. If undefined, the service value defaults to the name of the Sideband API Endpoint.

resource-path

Identifies the REST resource to the PDP.

The resource path value appears in the policy request as the HttpRequest.ResourcePath attribute. If undefined, the resource-path value defaults to the portion of the request that follows the base path, as defined by base-path.

policy-request-attribute

Defines zero or more static, arbitrary key-value pairs. If specified, the pairs are always added as attributes to policy requests.

These custom attributes appear in the policy request as fields of the Gateway attribute. For example, if a value of policy-request-attribute is foo=bar, the attribute Gateway.foo is added to the policy request with the value bar.