userdetails

userdetails

Note

v2.0 of userdetails requires ALA CAS 5

About

The Atlas user management app (userdetails) manages profile information for users.

This application is the central repository for user information for Atlas systems requiring authentication.

Userdetails works hand in hand with ALA CAS 5 and both share the same underlying database.

CAS manages the local authentication as well as third party auth provider integrtion.

General Information

Technologies

• Grails framework: 3.2.11
• JQuery

Setup

• To do end to end testing, the project requires you to run CAS project on a different port such as 8089.
• You will need the following local directory:

  
  /data/userdetails/config

* Add the external config files for userdetails.
* You will need MySQL running in your local environment
* You will need to run the flyway migrations from [ALA CAS 5](https://github.com/AtlasOfLivingAustralia/ala-cas-5) to setup the initial database.

### Mail Server
* You will get unexpected errors if you are not running a local mail server. The config.groovy is set up to point at a mail server on port 1025. This is a good option https://nilhcem.github.io/FakeSMTP/download.html.

* The app is expected to run in the default port 8080 locally.

### High Availability

The `userdetails` app includes Spring Session support for storing session state in a Redis cluster.  To enable, set the
following config properties:

```yaml
spring:
  session:
    store-type: redis
  redis:
    host: cluster-host-name
    password: cluster-password
    port: 6379