Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mifi/cognito-backup

CLI for backing up AWS Cogntito User Pools
https://github.com/mifi/cognito-backup

aws aws-cognito backup cloud cognito-backup user-pool user-pools

Last synced: 6 days ago
JSON representation

CLI for backing up AWS Cogntito User Pools

Awesome Lists containing this project

README

        

# cognito-backup 👫→💾
Amazon doesn't have any way of backing up their AWS Cognito User Pools and Groups.
So in my frustrating times working with AWS Cognito, I wrote this tool. `cognito-backup` is a simple CLI for backing up the user data, and can also restore afterwards. Note: AWS has no way of extracting the passwords of your users so you need to store these separately 😵

## Requirements

Requires node 12 or newer

## Install
```
npm install -g cognito-backup
```

## Usage
Backup all users in a single user pool:
`cognito-backup backup-users `

Backup all users in all user pools for this account:
`cognito-backup backup-all-users `

Restore users to a single user pool:
`cognito-backup restore-users `

Backup/export all groups in a single user pool:
`cognito-backup backup-groups `

Restore/import groups to a single user pool (Note: run this *before* restoring users)
`cognito-backup restore-groups `

Run `cognito-backup` for complete usage.

## Examples

```bash
cognito-backup backup-users eu-west-1_1_12345
cognito-backup backup-users eu-west-1_1_12345 --region eu-west-1 --file mypool.json
cognito-backup backup-all-users eu-west-1_1_12345 --region eu-west-1 --dir output
cognito-backup restore-users eu-west-1_12345 Abcd.1234 --file eu-west-1_12345.json

cognito-backup backup-groups eu-west-1_12345
cognito-backup restore-groups eu-west-1_12345
```

## Troubleshooting

Enable verbose log output:
```
DEBUG=cognito-backup cognito-backup ...
```

## Related

- https://github.com/mifi/dynamodump
- https://github.com/rahulpsd18/cognito-backup-restore