2
0
mirror of https://github.com/cderche/greenlock-challenge-s3 synced 2025-05-10 15:36:33 +00:00

Update README.md

This commit is contained in:
cyrille 2019-05-08 18:27:15 +01:00 committed by GitHub
parent 91e6d557dc
commit 21c4f86aac
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -8,3 +8,56 @@
# greenlock-challenge-s3 # greenlock-challenge-s3
S3 backed challenge strategy for greenlock-express.js (and greenlock.js) S3 backed challenge strategy for greenlock-express.js (and greenlock.js)
## Requirements
You will need a s3 bucket and the corresponding credentials.
## Integration
### greenlock-express.js
```javascript
let challenge = require('greenlock-challenge-s3').create({
accessKeyId: accessKeyId // Replace with your accessKeyId
, secretAccessKey: secretAccessKey // Replace with your secretAccessKey
, regionName: regionName // Replace with your regionName
, bucketName: bucketName // Replace with your bucketName
, directory: '' // Recommended
, debug: true // Debug
});
var Greenlock = require("greenlock-express");
var greenlock = Greenlock.create({
// Other options
, challenge: challenge
});
// Continue your greenlock setup
```
## Testing
The strategy is tested against the greenlock-store-test [https://git.coolaj86.com/coolaj86/greenlock-challenge-test.js]
To run the tests yourself, create a `.env` file with the following
```
// .env file
AWS_ACCESS_KEY_ID=abc // Replace with your accessKeyId
AWS_SECRET_ACCESS_KEY=abc // Replace with your secretAccessKey
AWS_BUCKET_REGION=abc // Replace with your regionName
AWS_BUCKET_NAME=abc // Replace with your bucketName
```
Run the following command:
```console
$ npm run clean && npm run test && npm run clean
```
## License
ISC