github.com/jwuensche/hub-go-authentication

HubGoAuthentication

This repository contains a simple and lightweight authentication service build with go.

How to start

git clone [e-mail]:jwuensche/hub-go-authentication.git
#or
git clone https://github.com/jwuensche/hub-go-authentication.git

go build -o hub-go-auth
./hub-go-auth

or if you want to build and run the docker image

make docker
docker create volume hub_go_auth

#to run the created container
make run

The Dockerfile will use the golang container to compile and run the container. Per default the container will use port 9000 this can be changed in the Makefile.

Configuration

Configuration files are located in the config directory and will be generated by the service if none are present.

Current files are:

• config.yml

port : 9000 #Assign port, This is currently not checked so don't enter any invalid ports.

Usage

Request can be send by posting json to the specified routes which are:

• /auth

{
  "User": "foo",
  "Password" : "bar"
}

• /checkToken

{
  "Token" : "foobar"
}

• /register

{
  "User": "foo",
  "Password": "bar"
}

• /logout

{
  "Token":"foobar"
}

• /changePassword

{
  "User":"foo",
  "CurrentPassword":"bar",
  "NewPassword":"rab"
}

How to test

Run

  $ go test

in your terminal to execute existing tests.

Current Issues

• Tests currently not including errors thrown by used packages like json or os
• Transition to usage of JWT https://jwt.io/introduction/

Used Packages

• gorilla/mux, https://github.com/gorilla/mux

• op-logging, https://github.com/op/go-logging

• go-yaml, https://github.com/go-yaml/yaml