Skip to content


The following documentation shows how to configure Java Spring apps to use oxd for authentication.


The oxd-spring requires the oxD Server. Please use the following link to install it

Install oxd-spring#

Clone oxd-spring from Github repo and run maven command to install it:

git clone
cd oxd-spring 
mvn clean package -Dmaven.test.skip=true

Now you can run the executable jar:

java -jar target/oxd-spring-0.0.1-SNAPSHOT.jar

Point browser to And log in into using test credentials: test_user/test_user_password

Note: oxd-server must run on localhost and be bound to port: 8099, otherwise you'll need to configure oxd-spring/src/main/resources/ file.

Customize oxd-spring#

To use your own server as openid provider you need to modify oxd.server.op-host property from oxd-spring/src/main/resources/, e.g:


Make sure the server already installed on your machine, or you can follow this guide to install it.