jay brown
34 lines
1.1 KiB
Markdown
34 lines
1.1 KiB
Markdown
# Cognito Auth
|
|
|
|
A reusable Go package for AWS Cognito authentication and authorization with Echo framework using PKCE flow.
|
|
|
|
## Features
|
|
|
|
- Complete OAuth 2.0 PKCE flow for AWS Cognito
|
|
- JWT token validation and verification
|
|
- Route-based authorization using Cognito user groups
|
|
- Middleware for token handling
|
|
- Cookie-based token storage
|
|
- Default home page with authentication status
|
|
- Simple integration with Echo framework
|
|
|
|
## Feature flag for Auth
|
|
To disable all of these features for all endpoints you must set
|
|
`DISABLE_AUTH=true` in your environment.
|
|
|
|
## Package details
|
|
For a detailed explanation of all of the files in this
|
|
package see the [summary](./summary.md) file.
|
|
|
|
## Configuration
|
|
|
|
The package reads configuration from environment variables:
|
|
|
|
- `COGNITO_CLIENT_ID`: Your AWS Cognito App Client ID
|
|
- `COGNITO_CLIENT_SECRET`: Your AWS Cognito App Client Secret (optional for public clients)
|
|
- `COGNITO_USER_POOL_ID`: Your AWS Cognito User Pool ID
|
|
- `COGNITO_DOMAIN`: Your AWS Cognito domain
|
|
- `AWS_REGION`: AWS region where your Cognito User Pool is located (us-east-2)
|
|
- `DEBUG`: Set to "true" for debug logging
|
|
|