{"id":18217307,"url":"https://github.com/openservices-dev/aws-user-service","last_synced_at":"2025-04-07T21:43:49.184Z","repository":{"id":260906639,"uuid":"882680844","full_name":"openservices-dev/aws-user-service","owner":"openservices-dev","description":"User management for your web application.","archived":false,"fork":false,"pushed_at":"2025-02-09T19:05:39.000Z","size":235,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-09T20:20:38.374Z","etag":null,"topics":["aws","aws-cognito","aws-xray","user-management"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/openservices-dev.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-03T13:34:29.000Z","updated_at":"2025-02-09T19:05:42.000Z","dependencies_parsed_at":"2025-02-09T20:20:13.049Z","dependency_job_id":"cf199365-bff9-47c3-b6ed-750d9cf5315f","html_url":"https://github.com/openservices-dev/aws-user-service","commit_stats":{"total_commits":3,"total_committers":1,"mean_commits":3.0,"dds":0.0,"last_synced_commit":"d862e42b4a786d5d37455d39cbda4b28e8bfd7d1"},"previous_names":["openservices-dev/aws-user-service"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openservices-dev%2Faws-user-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openservices-dev%2Faws-user-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openservices-dev%2Faws-user-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openservices-dev%2Faws-user-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openservices-dev","download_url":"https://codeload.github.com/openservices-dev/aws-user-service/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247737069,"owners_count":20987713,"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":["aws","aws-cognito","aws-xray","user-management"],"created_at":"2024-11-03T17:04:39.723Z","updated_at":"2025-04-07T21:43:49.154Z","avatar_url":"https://github.com/openservices-dev.png","language":"TypeScript","readme":"# AWS User Service\n\nUser management API using AWS Cognito.\n\n## Routes\n\nList of routes with basic info.\n\nUse `/user/api-docs` to view routes descriptions. This route is available only in development mode (`ENV=DEVELOPMENT`).\n\nFor testing purpose check [Postman collection](./aws-user-service.postman_collection.json).\n\n| Request | Path | Description |\n| ------- | ---- | ----------- |\n| POST | /user/register | Register new user |\n| POST | /user/confirm | Confirm registration using verification code |\n| POST | /user/login | Log in user |\n| GET | /user/me | User detail |\n| PUT | /user/user/:id | Update user |\n| POST | /user/password-reset-request | Request password reset |\n| POST | /user/password-reset | Reset password using verification code |\n| POST | /user/totp/setup | Setup MFA |\n| POST | /user/totp/verify | Verify MFA |\n| DELETE | /user/:id | Delete user |\n| GET | /user/refresh-token | Renew refresh token |\n\n## Environment variables\n\nHere are some basic environment variables. Whole configuration is in [config.ts](./src/config.ts) where you can find type and supported values for each option.\n\n| Name | Description |\n| ---- | ----------- |\n| PORT | Port number on which the service is listening |\n| SERVICES_AWS_COGNITO_REGION | AWS Cognito region (e.g. `eu-central-1`) |\n| SERVICES_AWS_COGNITO_POOL_ID | ID in form `\u003cregion\u003e-\u003crandom string\u003e` |\n| SERVICES_AWS_COGNITO_CLIENT_ID | App client ID |\n| SERVICES_AWS_COGNITO_CLIENT_SECRET | App client secret |\n\n## Logging and debugging\n\n#### Debug logs\n\n```\nLOGGER_LEVEL=debug\n```\n\n#### Sentry\n\n**Sentry** is supported and is initialized if `SENTRY_DSN` variable is set:\n\n```\nSENTRY_DSN=\n```\n\n#### AWS X-Ray or default tracing\n\nService provides basic tracing using `cls-hooked` and `uuid7` trace ID. This trace ID is part of each log and is unique for each request.\n\n```shell\nSERVICES_TRACE_TYPE=CLS_HOOKED\n```\n\nAWS X-Ray is supported and has also additional options (check [config.ts](./src/config.ts)).\n\n```shell\nSERVICES_TRACE_TYPE=AWS_XRAY\n```\n\n## License\n\n[MIT license](./LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenservices-dev%2Faws-user-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenservices-dev%2Faws-user-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenservices-dev%2Faws-user-service/lists"}