README.md

👮 Passport

Person Identifier as a Service — your personal user tracker and auth service.

Roadmap

• v1: MVP
  • January 5, 2019
  • Main concepts and working prototype.
• v2: Tracking
  • Sometime, 20xx
  • Tracking center.
• v3: Authentication
  • Somehow, 20xx
  • Authentication center.

Motivation

• We have to full control over our users' data and protect it from third parties.

Quick start

Requirements:

• Docker 18.06.0-ce or above
• Docker Compose 1.22.0 or above
• Go 1.9.2 or above
• GNU Make 3.81 or above

$ make up demo status

       Name                     Command               State                           Ports
-------------------------------------------------------------------------------------------------------------------
passport_db_1        docker-entrypoint.sh postgres    Up      0.0.0.0:5432->5432/tcp
passport_server_1    /bin/sh -c echo $BASIC_USE ...   Up      0.0.0.0:443->443/tcp, 0.0.0.0:80->80/tcp
passport_service_1   service run --with-profili ...   Up      0.0.0.0:8080->8080/tcp, 0.0.0.0:8090->8090/tcp,
                                                              0.0.0.0:8091->8091/tcp, 8092/tcp, 8093/tcp

$ make help

Specification

API

You can find API specification here. Also, we recommend using Insomnia HTTP client to work with the API - you can import data for it from the file.

CLI

Service command-line interface

$ make install

$ passport --help
Passport

Usage:
  passport [command]

Available Commands:
  completion  Print Bash or Zsh completion
  help        Help about any command
  migrate     Apply database migration
  run         Start HTTP server
  version     Show application version

Flags:
  -h, --help   help for passport

Use "passport [command] --help" for more information about a command.

Bash and Zsh completions

You can find completion files here or build your own using these commands

$ passport completion bash > /path/to/bash_completion.d/passport.sh
$ passport completion zsh  > /path/to/zsh-completions/_passport.zsh

Installation

Brew

$ brew install kamilsk/tap/passport

Binary

$ export REQ_VER=1.0.0  # all available versions are on https://github.com/kamilsk/passport/releases
$ export REQ_OS=Linux   # macOS and Windows are also available
$ export REQ_ARCH=64bit # 32bit is also available
$ # wget -q -O passport.tar.gz
$ curl -sL -o passport.tar.gz \
       https://github.com/kamilsk/passport/releases/download/"${REQ_VER}/passport_${REQ_VER}_${REQ_OS}-${REQ_ARCH}".tar.gz
$ tar xf passport.tar.gz -C "${GOPATH}"/bin/ && rm passport.tar.gz

Docker Hub

$ docker pull kamilsk/passport:1.x
# or use mirror
$ docker pull quay.io/kamilsk/passport:1.x

From source code

$ egg github.com/kamilsk/passport@^1.0.0 -- make test install
$ # or use mirror
$ egg bitbucket.org/kamilsk/passport@^1.0.0 -- make test install

egg¹ is an extended go get.

¹ The project is still in prototyping.↩

---

made with ❤️ for everyone