Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 2.85 KB

readme.adoc

File metadata and controls

60 lines (43 loc) · 2.85 KB

{project-name}

Purpose

{project-name} offers several login-mechanisms for appNG users.

Configuration

name type description default

successPage

text

The path the user is forwarded to after a successful login

/appng-manager

digestMaxValidity

int

the maximum validity of a login digest in minutes

3

mailFrom

text

the sender address for e-mails send during password retrieval

support@example.com

enableDeeplinks

boolean

set to true to forward the user to the originally requested page

true

Login Mechanisms

Form based Login

This is the default login mechanism requiring a user name and a password. Both are managed in the appNG manager application.

Digest Login

The digest login offers a digest based authentication.

External applications that do know about a the shared secret can use this to generate a parameterized URL that automatically signs in the user. Therefore a digest of the following form is needed: {user}|{yyyyMMddHHmmss}|{utc-offset}|{hash}.

Example: admin|20160114120555|+01:00|1D87C8A5E738BD3015AC57F2D9B862A5

The {hash} is a MD5 hash of {user}|{timestamp}|{utc-offset}|{shared-secret}, where {shared-secret} comes from the platform property sharedSecret.

To enable digest-login, you have to set the following site properties:

  • authApplication = appng-authentication

  • authLoginPage = digestlogin

  • authLoginRef = login

A valid digest login URL looks like

Note that the digest parameter needs to be URL encoded.

Tip

If digestlogin is not the first entry listed in authLoginPage, you need the directly address the digest login like this:

NTLM Login

This login method uses Microsoft NTLM to sign in a user with it’s windows domain account. It requires the WAFFLE Authentication Framework to be installed and configured properly. Note that both the appNG server and also the client machines must be running under Microsoft Windows.