Currently we have this page explaining how to use the Authentication Login URL: http://openam.forgerock.org/doc/webhelp/admin-guide/authn-from-browser.html, but it is not explicit with the XUI. There are several variations on how to specify realm and parameters when using the XUI but this is not explained in this article in the doc. It would be ideal to add examples using teh most typical parameters like realm, module, service, goto & gotoOnFail
Also, we need to document realm/behavior handling:
Within the XUI, the realm maybe specified within the URI in several places...
Support is provided for all of these methods of specifying the realm, the only constraint is that they must match. If the realms so not match, a inconsistent realm error is raised and a message to that effect displayed to the user.
In the scenario that the XUI is loaded with inconsistent realms specified, the realm in the URL parameters (before the fragment) is taken as the primary and the user redirected to the login page using that realm