Skip to content
A generic web application handling login flows via OpenID Connect
Java Shell Other
Branch: master
Clone or download
Latest commit c7509c8 Sep 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
net.loginbuddy.common optimized imports Sep 14, 2019
net.loginbuddy.democlient optimized imports Sep 14, 2019
net.loginbuddy.demoserver loginbuddy now proxies calls to the providers userinfo endpoint if th… Sep 13, 2019
net.loginbuddy.selfissued optimized imports Sep 14, 2019
net.loginbuddy.service optimized imports Sep 14, 2019
.travis.yml Update .travis.yml Aug 5, 2019
Dockerfile finished support for selfissued. Now adding tests and documentation Sep 5, 2019
Dockerfile_selfissued finished support for selfissued. Now adding tests and documentation Sep 5, 2019
LICENSE Initial commit Nov 20, 2018
Makefile finished support for selfissued. Now adding tests and documentation Sep 5, 2019
docker-compose-demosetup.yml finished the self-issued work for the moment Sep 6, 2019
docker-compose.yml continued to simplify the configuration Aug 19, 2019
pom.xml added security headers to web responses Sep 7, 2019


A container based solution that helps developers support social login for their applications in a simple way!

The latest docker image is always available at docker hub.

A running version of the latest Loginbuddy may be here: (If the URL is not working, I am trying to figure out something new)

Loginbuddy - Your authenticator

This project implements an OpenID Connect client that can be used as proxy between an application (your application) and an OpenID Provider. This is useful for cases where social login should be an option for users to login to your application. Your application only needs to communicate with Loginbuddy. After finishing the authentication and authorization with providers, Loginbuddy provides single response to the application.

The high level design looks like this:

alt overview

Getting started

Running the latest and greatest container of Loginbuddy

The sample setup consists of Loginbuddy, a sample web application and a sample OpenID Provider. The instructions are made for Docker on a MacBook and may need to be adjusted for windows users.

  • Preparation
    • modify your hosts file, add
    • for MacBooks this would be done at sudo /etc/hosts
  • Run docker run -p 80:80 -p 443:443 -d saschazegerman/loginbuddy:latest-demo
    • this will pull the latest demo image from docker hub
    • this will use ports 80 (http), 443 (https)
  • Open a browser

The demo simulates a client, a social login provider (called 'fake') and uses Loginbuddy!

The last page displays the type of message Loginbuddy would return to your application. (the window is very small. Copy the content, paste it into JSONLINT and click 'Validate JSON').

Since the demo uses self-signed certificates, confirm the SSL security screens in your browser.

Current state

To find out more details on how to configure and build Loginbuddy, please visit the WIKI pages!

Please check the project page to find out what is planned for the future and what has been done so far: projects.


Copyright (c) 2019. All rights reserved.

This software may be modified and distributed under the terms of the Apache License 2.0 license. See the LICENSE file for details.

You can’t perform that action at this time.