Single Sign-On (SSO)

langs

• ru

Stack: Go, gRPC, SQLite, Docker

Project Structure:

├───cmd
├───config // Configurations
├───internal
│   ├───app // Application components integration
│   │   └───grpc // gRPC server application code
│   ├───config // Application config structure
│   ├───domain
│   │   └───models // Shared structures
│   ├───service // Service layer
│   │   ├───acs
│   ├───storage // Data storage layer
│   │   └───postgres
│   ├───transport // Data transport layer
│   │   └───grpc
│   │       ├───acs // Files for working with roles/permissions
├───migrations // Migration files
└───tests // Tests

Installation, Building, and Running:

Prerequisites:

1. go compiler 1.21.5
2. git
3. Docker
4. make
5. Postman

Steps:

1. Clone the repository: git clone https://github.com/puregrade-group/sso ./my/favorite/dir
2. Install dependencies: go mod download
3. Create the database and populate tables: make mgrs-up or go run ./cmd/migrator/main.go --storage-path=storage/sso.db --migrations-path=migrations
4. For testing, populate the necessary test data: make test-mgrs-up or go run ./cmd/migrator/main.go --storage-path="./storage/sso.db" --migrations-path="./tests/migrations" --migrations-table="test"
5. Run the application: make run or go run ./cmd/main.go --config=./config/config.yaml
6. To test the functionality, you can run the tests using go test, send requests through Postman, or write your own client for this application. To do this, you will need to refer to https://github.com/puregrade-group/protos and find the .proto files there for Postman or import the latest version of the generated files from this repository for your own client.

or

5. Build the Docker image: docker build --tag image-name .
6. Run the container: docker run -p 50051:50051/tcp --name container-name <image_id>
7. Test the functionality.

Examples:

Application logs upon startup:

Output from Postman:

Output from tests: