AWS cli high security documentation change
Summary
Added new security features including workload restrictions and encryption options, updated CLI version, and modified terminology from 'Harness' to 'harness'
Security assessment
Added 'allowedWorkloadConfiguration' with workload identity restrictions to prevent unauthorized access, and 'encryptionKeyArn' field for customer-managed KMS keys to enable encryption of memory data. These directly implement security controls for access management and data protection.
Diff
diff --git a/cli/latest/reference/bedrock-agentcore-control/create-harness.md b/cli/latest/reference/bedrock-agentcore-control/create-harness.md index 65996feaa..b8f77a99f 100644 --- a//cli/latest/reference/bedrock-agentcore-control/create-harness.md +++ b//cli/latest/reference/bedrock-agentcore-control/create-harness.md @@ -13 +13 @@ - * [next](create-memory.html "create-memory") | + * [next](create-harness-endpoint.html "create-harness-endpoint") | @@ -15 +15 @@ - * [AWS CLI 2.35.5 Command Reference](../../index.html) » + * [AWS CLI 2.35.8 Command Reference](../../index.html) » @@ -23 +23 @@ - * [create-memory →](create-memory.html "next chapter \(use the right arrow\)") + * [create-harness-endpoint →](create-harness-endpoint.html "next chapter \(use the right arrow\)") @@ -59 +59 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -Operation to create a Harness. +Operation to create a harness. @@ -905,0 +906,51 @@ JSON Syntax: +>> +>> allowedWorkloadConfiguration -> (structure) +>> +>>> The configuration that restricts which workloads in the request’s identity chain are allowed to invoke the target, identified by their hosting environments and workload identities. At launch, this is supported only for AgentCore Runtime targets, and the allowed workloads are AgentCore Gateways. +>>> +>>> hostingEnvironments -> (list) +>>> +>>>> The list of hosting environments whose workloads are allowed to invoke the target. At launch, the only supported hosting environment is AgentCore Gateway. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `10` +>>>> + +>>>> +>>>> (structure) +>>>> +>>>>> A hosting environment whose workloads are allowed to invoke the target. At launch, the only supported hosting environment is AgentCore Gateway. +>>>>> +>>>>> arn -> (string) [required] +>>>>> +>>>>>> The Amazon Resource Name (ARN) of the hosting environment. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `20` +>>>>>> * max: `1011` +>>>>>> + +>>> +>>> workloadIdentities -> (list) +>>> +>>>> The list of workload identities that are allowed to invoke the target. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `10` +>>>> + +>>>> +>>>> (string) +>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `3` +>>>>> * max: `255` +>>>>> * pattern: `[A-Za-z0-9_.-]+` +>>>>> + @@ -963 +1014,10 @@ JSON Syntax: - ] + ], + "allowedWorkloadConfiguration": { + "hostingEnvironments": [ + { + "arn": "string" + } + ... + ], + "workloadIdentities": ["string", ...] + } @@ -1620 +1680 @@ JSON Syntax: ->> This is a Tagged Union structure. Only one of the following top level keys can be set: `path`, `s3`, `git`. +>> This is a Tagged Union structure. Only one of the following top level keys can be set: `path`, `s3`, `git`, `awsSkills`. @@ -1658 +1718 @@ JSON Syntax: ->>>> * pattern: `https://.*` +>>>> * pattern: `https://[^#@]+` @@ -1682,0 +1743,18 @@ JSON Syntax: +>> +>> awsSkills -> (structure) +>> +>>> AWS Skills baked into the harness’s underlying Runtime. +>>> +>>> paths -> (list) +>>> +>>>> Optionally filter allowed skills with glob syntax, e.g., [‘core-skills/*’]. +>>>> +>>>> (string) +>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * max: `4096` +>>>>> * pattern: `([^*?\[\]]|\*)+` +>>>>> + @@ -1687 +1765 @@ Shorthand Syntax: - path=string,s3={uri=string},git={url=string,path=string,auth={credentialArn=string,username=string}} ... + path=string,s3={uri=string},git={url=string,path=string,auth={credentialArn=string,username=string}},awsSkills={paths=[string,string]} ... @@ -1705,0 +1784,3 @@ JSON Syntax: + }, + "awsSkills": { + "paths": ["string", ...] @@ -1738 +1819 @@ Syntax: -> This is a Tagged Union structure. Only one of the following top level keys can be set: `agentCoreMemoryConfiguration`. +> This is a Tagged Union structure. Only one of the following top level keys can be set: `agentCoreMemoryConfiguration`, `managedMemoryConfiguration`, `disabled`. @@ -1782,0 +1864,63 @@ Syntax: +> +> managedMemoryConfiguration -> (structure) +> +>> Harness creates and manages a memory resource in the customer’s account. +>> +>> arn -> (string) +>> +>>> The ARN of the managed AgentCore Memory resource. Read-only on Get, ignored on Create/Update input. +>>> +>>> Constraints: +>>> +>>> * pattern: `arn:aws:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:memory\/[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}` +>>> + +>> +>> strategies -> (list) +>> +>>> Strategy types to enable. Defaults to [SEMANTIC, SUMMARIZATION]. +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `4` +>>> + +>>> +>>> (string) +>>> +>>>> Possible values: +>>>> +>>>> * `SEMANTIC` +>>>> * `SUMMARIZATION` +>>>> * `USER_PREFERENCE` +>>>> * `EPISODIC` +>>>> + +>> +>> eventExpiryDuration -> (integer) +>> +>>> Event retention in days. Defaults to 30. +>>> +>>> Constraints: +>>> +>>> * min: `3` +>>> * max: `365` +>>> + +>> +>> encryptionKeyArn -> (string) +>> +>>> Customer-managed KMS key. Defaults to AWS-owned key. Not updatable after creation. +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `2048` +>>> * pattern: `arn:aws(|-cn|-us-gov):kms:[a-zA-Z0-9-]*:[0-9]{12}:key/[a-zA-Z0-9-]{36}` +>>> + +> +> disabled -> (structure) +> +>> Explicitly opt out of memory. @@ -1797,0 +1942,9 @@ JSON Syntax: + }, + "managedMemoryConfiguration": { + "arn": "string", + "strategies": ["SEMANTIC"|"SUMMARIZATION"|"USER_PREFERENCE"|"EPISODIC", ...], + "eventExpiryDuration": integer, + "encryptionKeyArn": "string" + }, + "disabled": { + @@ -2049 +2202 @@ harness -> (structure) ->> The ID of the Harness. +>> The ID of the harness. @@ -2059 +2212 @@ harness -> (structure) ->> The name of the Harness. +>> The name of the harness. @@ -2069 +2222 @@ harness -> (structure) ->> The ARN of the Harness. +>> The ARN of the harness. @@ -2079 +2232 @@ harness -> (structure) ->> The status of the Harness.