Passcode security

This article will be published 13 november 2017

Preparation

To enable 2 factor authentication for users you will need to prepare the following:

• List of IP's that should not require 2 factor authentication
• An messaging URL for sending SMS's
• Access to cellphone numbers for all employees

System configuration

First you will setup the system to run in testmode, so that all messages are sent for you. After checking everything works, disable the testmode.

Change server configurations

• Set smsConnectUrl to your connection URL
• Check that smsParamMessage fits the parameter name of your SMS provider
• Check that smsParamNumber fits the parameter name of your SMS provider

Optionally you can allow IP based exceptions from the rules

• Set passcodeTrustedIp to true link
• Set passcodeTrustedIpList to contain your office IP's link

Furthermore you can allow multiple logins from the same IP to

• Set passcodeUserIpHistory to true link
• Set passcodeUserIpHistoryCount to minimum succesfull logins link

Activate passcode filters

Stop the application server

Go to the application folder and dive into: <application>\WEB-INF\web.xml

Uncomment the section containg the servlet mapping

   <filter>
       <filter-name>TwoFactorAuthentication</filter-name>
       <filter-class>dk.tempusserva.passcode.SmsVerificationFilter</filter-class>
   </filter>
   <filter-mapping>
       <filter-name>TwoFactorAuthentication</filter-name>
       <url-pattern>/main</url-pattern>
   </filter-mapping>

Start the application server

Test and go live

Validate that two factor login works as intended.

Change server configurations

• Set smsTestMode to false