dp-identity-api

command module
v1.57.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 24, 2024 License: MIT Imports: 8 Imported by: 0

README

dp-identity-api

An API used to manage the authorisation of users accessing data publishing services.

Getting started

Run make debug to get started

To run the app with reflex and have it restart when you make changes, run:

make debug-watch

Dummy data

If test data is required in the local Cognito user pool:

  • Run make populate-local

To remove create test data from Cognito user pool:

  • Run make remove-test-data
Dependencies
  • No further dependencies other than those defined in go.mod
Configuration
Environment variable Default Description
BIND_ADDR :25600 The host and port to bind to
GRACEFUL_SHUTDOWN_TIMEOUT 20s The graceful shutdown timeout in seconds (time.Duration format)
HEALTHCHECK_INTERVAL 30s Time between self-healthchecks (time.Duration format)
HEALTHCHECK_CRITICAL_TIMEOUT 90s Time to wait until an unhealthy dependent propagates its state to make this app unhealthy (time.Duration format)
AWS_REGION eu-west-2 The default AWS region for the identity api service
AWS_COGNTIO_USER_POOL_ID - The ID of the user pool to be used
AWS_COGNITO_CLIENT_ID - Cognito client ID
AWS_COGNITO_CLIENT_SECRET - Cognito client secret
AWS_AUTH_FLOW - A parameter to define the request to the InitiateAuth endpoint in cognito
MessageAction RESEND A feature flag to SUPPRESS or RESEND message action on creating a new user
HTTP_WRITE_TIMEOUT [^dpnet] How long the dispatcher waits for us to write to it (time.Duration format)

[^dpnet]: dp-net default

To get the values for the other AWS Cognito secrets:

  • AWS_COGNITO_USER_POOL_ID get from AWS > Cognito > User Pools > user pool ID
  • AWS_COGNITO_CLIENT_ID get from AWS > Cognito > User Pools > App Integration > App clients > dp-identity-api > client id
  • AWS_COGNITO_CLIENT_SECRET get from AWS > Cognito > User Pools > App Integration > App clients > dp-identity-api > client secret
Configuration needed to import user and group from s3
export GroupsFilename=""
export GroupUsersFilename=""
export UserFileName=""
export S3Bucket=""
export S3BaseDir=""
export S3Region=""
export AWSCognitoUserPoolID=""

Contributing

See CONTRIBUTING for details.

License

Copyright © 2024, Office for National Statistics

Released under MIT license, see LICENSE for details.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL