@middy/ssm 2.5.0 → 2.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/index.d.ts +2 -13
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -47,16 +47,16 @@ npm install --save @middy/ssm
|
|
|
47
47
|
|
|
48
48
|
## Options
|
|
49
49
|
|
|
50
|
-
- `AwsClient` (object) (default `AWS.SSM`): AWS.SSM class constructor (e.g. that has been instrumented with AWS
|
|
50
|
+
- `AwsClient` (object) (default `AWS.SSM`): AWS.SSM class constructor (e.g. that has been instrumented with AWS X-Ray). Must be from `aws-sdk` v2.
|
|
51
51
|
- `awsClientOptions` (object) (optional): Options to pass to AWS.SSM class constructor.
|
|
52
52
|
- `awsClientAssumeRole` (string) (optional): Internal key where role tokens are stored. See [@middy/sts](/packages/sts/README.md) on to set this.
|
|
53
|
-
- `awsClientCapture` (function) (optional): Enable
|
|
53
|
+
- `awsClientCapture` (function) (optional): Enable AWS X-Ray by passing `captureAWSClient` from `aws-xray-sdk` in.
|
|
54
54
|
- `fetchData` (object) (required): Mapping of internal key name to API request parameter `Names`/`Path`. `SecureString` are automatically decrypted.
|
|
55
55
|
- `disablePrefetch` (boolean) (default `false`): On cold start requests will trigger early if they can. Setting `awsClientAssumeRole` disables prefetch.
|
|
56
56
|
- `cacheKey` (string) (default `ssm`): Cache key for the fetched data responses. Must be unique across all middleware.
|
|
57
57
|
- `cacheExpiry` (number) (default `-1`): How long fetch data responses should be cached for. `-1`: cache forever, `0`: never cache, `n`: cache for n ms.
|
|
58
58
|
- `setToEnv` (boolean) (default `false`): Store role tokens to `process.env`. **Storing secrets in `process.env` is considered security bad practice**
|
|
59
|
-
- `setToContext` (boolean) (default `false`): Store role
|
|
59
|
+
- `setToContext` (boolean) (default `false`): Store role tokens to `request.context`.
|
|
60
60
|
|
|
61
61
|
NOTES:
|
|
62
62
|
- Lambda is required to have IAM permission for `ssm:GetParameters` and/or `ssm:GetParametersByPath` depending on what you're requesting.
|
|
@@ -79,7 +79,7 @@ handler
|
|
|
79
79
|
.use(ssm({
|
|
80
80
|
fetchData: {
|
|
81
81
|
accessToken: '/dev/service_name/access_token', // single value
|
|
82
|
-
dbParams: '/dev/service_name/database/',
|
|
82
|
+
dbParams: '/dev/service_name/database/', // object of values, key for each path
|
|
83
83
|
defaults: '/dev/defaults'
|
|
84
84
|
},
|
|
85
85
|
setToContext: true
|
|
@@ -109,7 +109,7 @@ handler
|
|
|
109
109
|
.use(ssm({
|
|
110
110
|
fetchData: {
|
|
111
111
|
accessToken: '/dev/service_name/access_token', // single value
|
|
112
|
-
dbParams: '/dev/service_name/database/',
|
|
112
|
+
dbParams: '/dev/service_name/database/', // object of values, key for each path
|
|
113
113
|
},
|
|
114
114
|
cacheExpiry: 15*60*1000,
|
|
115
115
|
cacheKey: 'ssm-secrets'
|
package/index.d.ts
CHANGED
|
@@ -1,19 +1,8 @@
|
|
|
1
1
|
import { SSM } from 'aws-sdk'
|
|
2
|
-
import {
|
|
2
|
+
import { Options as MiddyOptions } from '@middy/util'
|
|
3
3
|
import middy from '@middy/core'
|
|
4
4
|
|
|
5
|
-
interface Options<S = SSM> {
|
|
6
|
-
AwsClient?: new() => S
|
|
7
|
-
awsClientOptions?: Partial<SSM.Types.ClientConfiguration>
|
|
8
|
-
awsClientAssumeRole?: string
|
|
9
|
-
awsClientCapture?: typeof captureAWSClient
|
|
10
|
-
fetchData?: { [key: string]: string }
|
|
11
|
-
disablePrefetch?: boolean
|
|
12
|
-
cacheKey?: string
|
|
13
|
-
cacheExpiry?: number
|
|
14
|
-
setToEnv?: boolean
|
|
15
|
-
setToContext?: boolean
|
|
16
|
-
}
|
|
5
|
+
interface Options<S = SSM> extends MiddyOptions<S, SSM.Types.ClientConfiguration> {}
|
|
17
6
|
|
|
18
7
|
declare function ssm (options?: Options): middy.MiddlewareObj
|
|
19
8
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@middy/ssm",
|
|
3
|
-
"version": "2.5.
|
|
3
|
+
"version": "2.5.4",
|
|
4
4
|
"description": "SSM (EC2 Systems Manager) parameters middleware for the middy framework",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"engines": {
|
|
@@ -46,12 +46,12 @@
|
|
|
46
46
|
},
|
|
47
47
|
"homepage": "https://github.com/middyjs/middy#readme",
|
|
48
48
|
"dependencies": {
|
|
49
|
-
"@middy/util": "^2.5.
|
|
49
|
+
"@middy/util": "^2.5.4"
|
|
50
50
|
},
|
|
51
51
|
"devDependencies": {
|
|
52
|
-
"@middy/core": "^2.5.
|
|
52
|
+
"@middy/core": "^2.5.4",
|
|
53
53
|
"aws-sdk": "^2.939.0",
|
|
54
54
|
"aws-xray-sdk": "^3.3.3"
|
|
55
55
|
},
|
|
56
|
-
"gitHead": "
|
|
56
|
+
"gitHead": "a4134a579c757a9fdfed3006877ba2c0ec8a2cfa"
|
|
57
57
|
}
|