Working of Parameter TargetAsRelativeURI- To Use a Relative Target for Credential Collector Redirects

Document ID : KB000054903
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

This document describes how to use Relative Target for Credential Collector redirects instead of FQDN (Fully Qualified Domain Name) by using WebAgent Configuration parameter ? TargetAsRelativeURI

Solution:

TargetAsRelativeURI

Instructs the Web Agent to use a relative URI instead of a fully qualified URL when directing requests to a credential collector and target resource. Using a relative URI prevents requests from being processed by credential collectors on other systems installed with Web Agents. Enabling this parameter also causes the Web Agent to reject any target that does not begin with a forward slash (/).

Default: No

Note: This setting applies to all credential collectors except the cookie credential collector (CCC). The CCC must use a fully-qualified domain name for this parameter. OnAuthAccept responses will not work properly with a CCC if a relative URI is used.

Typically, a fully qualified URL is appended to the credential collector URL. For example:

url?A=1&Target=http://www.nete.com/index.html.

To use only a relative URI, set the TargetAsRelativeURI parameter to yes. If set to yes, the target parameter appended to the credential collector URL is a relative target, such as url?A=1&Target=/index.html. In turn, when the credential collector redirects back to the Web Agent protecting the target resource, it is a relative redirect. Also, the Web Agent rejects any target that does not begin with a forward slash (/).

The default value for this parameter is no, so a fully qualified URL is always used.