{"id":22982392,"url":"https://github.com/niradler/serverless-auth-go","last_synced_at":"2025-06-17T13:38:31.756Z","repository":{"id":39966220,"uuid":"474180385","full_name":"niradler/serverless-auth-go","owner":"niradler","description":"Simple authentication mechanism base on aws serverless services (Dynmodb, Lambda, ApiGateway)","archived":false,"fork":false,"pushed_at":"2022-07-10T12:56:06.000Z","size":135,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-08-08T01:12:10.957Z","etag":null,"topics":["authentication","aws","aws-lambda","golang","serverless"],"latest_commit_sha":null,"homepage":"https://github.com/niradler/serverless-auth-go","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/niradler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-25T22:26:12.000Z","updated_at":"2023-08-08T01:12:10.957Z","dependencies_parsed_at":"2022-06-25T18:39:36.707Z","dependency_job_id":null,"html_url":"https://github.com/niradler/serverless-auth-go","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niradler%2Fserverless-auth-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niradler%2Fserverless-auth-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niradler%2Fserverless-auth-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/niradler%2Fserverless-auth-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/niradler","download_url":"https://codeload.github.com/niradler/serverless-auth-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229773754,"owners_count":18122073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["authentication","aws","aws-lambda","golang","serverless"],"created_at":"2024-12-15T02:18:13.513Z","updated_at":"2024-12-15T02:18:14.134Z","avatar_url":"https://github.com/niradler.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Serverless Auth\n\nSimple authentication mechanism base on aws serverless services (Dynmodb, Lambda, ApiGateway)\n\n## Features\n\n- Basic user authentication with email/password\n- Passwordless user authentication with email only (need to configure email provider)\n- Login with providers like Google, Facebook, etc.\n- Authorization roles.\n- Multi tenants (create an org, and start inviting users, and assign roles to users, admin is the default role for the user that create the org)\n\n## Usage\n\n| method | route                                | payload                   | Role  | public | description             |\n| ------ | ------------------------------------ | ------------------------- | ----- | ------ | ----------------------- |\n| POST   | /v1/auth/login                       | email,password            |       | true   | Login                   |\n| POST   | /v1/auth/login/email                 | email                     |       | true   | Passwordless Login      |\n| POST   | /v1/auth/signup                      | email,password,data       |       | true   | Signup                  |\n| GET    | /v1/auth/validate                    |                           |       | true   | ValidateToken           |\n| POST   | /v1/auth/renew                       |                           |       | false  | Get new Token           |\n| GET    | /v1/auth/provider/:provider          |                           |       | true   | Login with provider     |\n| GET    | /v1/auth/provider/:provider/callback |                           |       | true   | Validate provider login |\n| GET    | /v1/users/me                         |                           |       | true   | Health check            |\n| PUT    | /v1/users/me                         | data                      |       | false  | Update user data        |\n| PUT    | /v1/users/me/password                | password,repeatedPassword |       | false  | Update user password    |\n| POST   | /v1/orgs                             | name                      |       | false  | Create Org              |\n| POST   | /v1/orgs/:orgId/invite               | email,role                | admin | false  | Invite user to me org   |\n| GET    | /v1/orgs/:orgId/users                |                           | admin | false  | Get org users           |\n\n## Deploy\n\nuse deploy.sh script to setup and customize the deployment\n\nto customize the deployment, you can use the following environment variables:\n\n```.env\nAWS_ACCESS_KEY_ID=\nAWS_SECRET_ACCESS_KEY=\nAWS_DEFAULT_REGION=\nSLS_AUTH_GOOGLE_CLIENT_ID=\nSLS_AUTH_GOOGLE_CLIENT_SECRET=\nSLS_AUTH_GOOGLE_CALLBACK=\nSLS_AUTH_CLIENT_CALLBACK=\nSLS_AUTH_SESSION_SECRET=\nSLS_AUTH_JWT_SECRET=\nSLS_AUTH_APP_NAME=\nSLS_AUTH_SENDGRID_API_KEY=\nSLS_AUTH_FROM_EMAIL=\nSLS_AUTH_EMAIL_TEMPLATES_FOLDER=\nSLS_AUTH_APP_NAME=\nSLS_AUTH_APP_CONTACT=\n```\n\n## Develop\n\n```sh\nnpm i -g cdk\ngit clone https://github.com/niradler/serverless-auth-go.git\ncd serverless-auth-go\n$env:GOOS = 'linux' or export GOOS=linux\ncd server \u0026\u0026 go get \u0026\u0026 go build -o build/main ./src\ncd infra \u0026\u0026 cdk deploy\n# run\ncd server\ngo run ./src/.\n```\n\n## Tech Stack\n\n- Using aws cdk (iac) to deploy the aws services. (golang)\n- Scalable api using Gin framework. (golang)\n- goth for providers logins. (github/bitbucket/gitlab/facebook/google) (only google/github is tested)\n\n## Contribution\n\nContribution is welcome.\n\n[Roadmap](https://github.com/niradler/serverless-auth-go/projects/1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniradler%2Fserverless-auth-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fniradler%2Fserverless-auth-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fniradler%2Fserverless-auth-go/lists"}