users

Minesweeper

The famous game since the early days of Microsoft where you have to flag the cells with mine while opening the cells with value and get the highest score possible.

Learning outcomes

• Store encrypted password and use the same encryption in authenticating user credentials.
• Generation of access token and refresh token for extending user session.
• Configure specific information to be added in the jwt tokens.
• Implement middleware interceptor chains based on the endpoint.

Microservices Ecosystem

This repository is part of a larger ecosystem of microservices each serving it's purpose in bring Minesweeper to life.

• Web Services
• Authorization
• Update Database
• Web Interface

You can use the docker-compose.yml file to start all the services in separate docker containers in one go. This file is available in a different repository. Please let me know if you'd like to experiment with that.

About

This repository contains the Users services APIs for the game in golang.

Endpoints

• /user - Creates a new user.
• /users - Returns a list of users for usernames.
• /users/username - Returns a user for username.
• /user/username - Updates a user for userId.
• /authorize - Generates authentication tokens from username and password.
• /refresh - Generates new authentication tokens from refresh token.

Environment Variables

• MONGO_CLIENT_ID - MongoDB Cloud Atlas client id
• DATABASE - MongoDB Database
• MONGO_COLLECTION - MongoDB Collection
• PORT - Port to run the service.
• CLIENT_SECRET - Client secret to generate/authenticate access token.
• REFRESH_CLIENT_SECRET - Client secret to generate/authenticate refresh token.
• TOKEN_EXPIRE_MINUTES - Validity of the access token.
• REFRESH_TOKEN_EXPIRE_MINUTES - Validity of the refresh token.

Run the service

The service can be run either directly as a go project or use a Docker container to build and run.

The projects uses go modules to manage the dependencies.

Run the following commands in order to build the project to build from the command line.

go get -d -v ./...
go mod download
go mod vendor
go mod verify
go build
go run main.go

Or the following to build the docker container.

docker build -t minesweeper .
docker run -it minesweeper

Ensure that the go.sum and vendor/modules.txt do not have it's content altered unless there is a dependency alteration.

Author

• Atul Anand