Install [deprecated]

Deprecated. Use Install page for current version

Installation is pretty simple. Best and recommended way to run application is via docker compose. There are several docker-compose.yml templates for various scenarios. Anyway, there are some steps, that need to be done on GSuite site, before you start installation.

Start application

Make sure you have installed docker and docker compose.

1. Download docker-compose.yml for latest release.
2. Rename downloaded p12 file to service-account.p12 and move it to same directory as docker-compose.yml
3. Edit docker-compose.yml and set LDAP configuration based on your preferences in both services
4. Run docker-compose up -d and follow logs with docker-compose logs -f

Configuration

1. Copy private key to configuration

   docker cp ./service-account.p12 \
       $(docker-compose ps -q identity):/opt/karaf/etc/identity/
   

2. To list all configuration properties run `docker-compose exec identity

   docker-compose exec identity /opt/karaf/bin/client \
       'config:list "(service.pid=eu.hlavki.identity*)"'
   

3. On host computer create file configure.cmd with content:

   config:edit eu.hlavki.identity.google
   config:property-set oauth2.serviceAccount.privateKey.passphrase notasecret
   config:property-set oauth2.serviceAccount.privateKey.file /opt/karaf/etc/identity/service-account.p12
   config:update
   

4. Run docker-compose exec -T identity /opt/karaf/bin/client -b < configure.cmd

Application test

Open in browser http://localhost:8181 and click Sign in.