Introduction

The phixflow-login.xml configuration file allows the operator to define different login form configurations with restricted login options e.g. Local only, Active Directory only, all options. The user can then choose the login for to be displayed by providing an extra parameter to the PhixFlow start URL, or accept the default.

The 

There are 2 reasons for doing this:

1. You have configured Local logins and Active Directory (or SAML / SIngle Sign-on) logins, and you want advanced users to see all login options but normal users to see only Active Directory or Single Sign-on.
2. You want to enable SAML / Single Sign-on auto login. This logs you in automatically using your current logged-in Microsoft Windows credentials without displaying a login form, and cannot be mixed with other form options.

Starting PhixFlow with a non-default login form

To start PhixFlow with a non-default login form, append ?login=mylogin to the PhixFlow URL, where mylogin is the name of the login form e.g.

https://myserver.com/phixflow?login=full

Configuration

If $webapp/WEB-INF/classes/phixflow-login.xml does not exist, create it by copying phixflow-login.xml.example.

If you are not configuring Active Directory or SAML / Single Sign-on integration, no changes are required.

Configuration for Active Directory or SAML / Single Sign-on

If you are configuring Active Directory or SAML / Single Sign-on integration:

Edit $webapp/WEB-INF/classes/phixflow-login.xml:.

Find the loginConfiguration bean:

...

Set the defaultForm property to the name of the form that you want to be the default.

Starting PhixFlow with a non-default login form

To start PhixFlow with a non-default login form, append ?login=mylogin to the PhixFlow URL, where mylogin is the name of the login form e.g.

https://myserver.com/phixflow?login=full