12.2.4. Path Redirection
PicketLink allows you to define redirection rules for a specific path. This feature allows you to perform a HTTP redirect depending on a specific condition.
The most simple example about how to use this feature is when you defined a logout path to your application.
httpBuilder .forPath("/logout") .logout() .redirectTo("/goodbye.html");
In this case, once the user is logged out, PicketLink will redirect the user to a /goodbye.html page.
But some times you may want to perform a redirect depending on a specific condition. For example, let's define a rule where if a request is not authorized the user will be redirect to a specific error page:
httpBuilder .forPath("/admin/*") .authorizeWith() .role("Administrator") .redirectTo("/accessDenied.html").whenForbidden();
You can do the same thing if some error occurs during the request processing.
httpBuilder .forPath("/admin/*") .authorizeWith() .role("Administrator") .redirectTo("/error.html").whenError();
If you want to simplify your configuration, you can define all redirect rules by Section 12.2.2, “Grouping Paths”.