Authentication

The site login article uses the Authentication template. It lets users log into the site, either with an account they have created using the Registration form, or with a third party provider.

Page Title and Content

The page title and content, including inline elements, appear as per the Default template.

Related Assets

Articles using the Authentication template display related images, media items, forms, polls and features in the same way as the Default template.

Related Articles

Related articles are output as a series of links beneath the other page content. 

Utility Articles

Articles picked in the Utility section of the article extras are output as links beneath the login form. These links are designed to link to your site's registration and password reset pages. The links will include your login article as a return URL parameter (including any return URL parameters present on your login page).

These return parameters mean that when a user registers with your site, or resets their password, the forms can redirect them back to the login article and, once they have logged in, they will be redirected again to the secure content they were trying to access.

The standard forms we provide are called CITIZENSIMPLESIGNUPEXAMPLE and CITIZENRESETPASSWORDEXAMPLE. They should be related to articles using the Forms Service template and those articles picked here.

Login Form

The login form is generated by Handlebars Templates the Authentication worker - you can't edit it directly when setting up your article.

The login options displayed on the form can be controlled in the article extras of the Authentication template - pick the options you'd like to appear. For example, the screenshot at the top of the page has three providers enabled:

If you only have a single third party login enabled, it's possible to create a more seamless single sign-on experience by enabled the autoSubmitIfOnlyProvider setting in the Base Provider Parameters.

Configuring the Site Login

An article using the Authentication template can be configured via its article extras as follows:

1. Log out text. When a user is logged in, the log out text will be used when outputting links to the login article instead of the article heading or alternate link text. If left blank, the value "Log out" is used. When this link is clicked users will be automatically logged out of the site. They will remain logged into any external authentication providers if they logged in via a third party (ie if a user authenticates using Facebook, then logs out of the iCM powered site, they will remain logged into Facebook). This behaviour is outside of our control.
2. Welcome article. If the user was prompted to log in when trying to access a secure article or content (the target content), they will be redirected to it on successful login. If no such target content can be identified, the user will instead be redirected to the selected "Welcome" article. If a welcome article is not selected, the user will be redirected to the site homepage.
3. Default groups. A list of the groups that a user authenticating with the site will be added to see Authentication - Providers, Users and Default Groups later in this guide). If you change these groups, the next time a user logs in, they'll be added to any additional groups. User's aren't ever removed from groups
4. Utility articles. Pick the Forms Service articles that display your registration and password reset forms
5. Enabled authentication providers. The authentication providers a user is able to sign in with. These providers must first be configured in the API Server's Authentication worker. Only providers that have been configured will appear here. Checking a box will cause that provider to appear on the login article.
6. Timeouts and Headers. See the next section of this guide.

Subsite Settings

Your site's main login article should be picked in the Subsite Configuration - Subsite Configuration - General Settings. This is the article users will be redirected to when they try to access secure content.

Article Extras