CustomKeyStoresListEntry
Contains information about each custom key store in the custom key store list.
Contents
Note
In the following list, the required parameters are described first.
- CloudHsmClusterId
-
A unique identifier for the Amazon CloudHSM cluster that is associated with an Amazon CloudHSM key store. This field appears only when the
CustomKeyStoreTypeisAWS_CLOUDHSM.Type: String
Length Constraints: Minimum length of 19. Maximum length of 24.
Pattern:
cluster-[2-7a-zA-Z]{11,16}Required: No
- ConnectionErrorCode
-
Describes the connection error. This field appears in the response only when the
ConnectionStateisFAILED.Many failures can be resolved by updating the properties of the custom key store. To update a custom key store, disconnect it (DisconnectCustomKeyStore), correct the errors (UpdateCustomKeyStore), and try to connect again (ConnectCustomKeyStore). For additional help resolving these errors, see How to Fix a Connection Failure in Amazon Key Management Service Developer Guide.
All custom key stores:
-
INTERNAL_ERROR— Amazon KMS could not complete the request due to an internal error. Retry the request. ForConnectCustomKeyStorerequests, disconnect the custom key store before trying to connect again. -
NETWORK_ERRORS— Network errors are preventing Amazon KMS from connecting the custom key store to its backing key store.
Amazon CloudHSM key stores:
-
CLUSTER_NOT_FOUND— Amazon KMS cannot find the Amazon CloudHSM cluster with the specified cluster ID. -
INSUFFICIENT_CLOUDHSM_HSMS— The associated Amazon CloudHSM cluster does not contain any active HSMs. To connect a custom key store to its Amazon CloudHSM cluster, the cluster must contain at least one active HSM. -
INSUFFICIENT_FREE_ADDRESSES_IN_SUBNET— At least one private subnet associated with the Amazon CloudHSM cluster doesn't have any available IP addresses. A Amazon CloudHSM key store connection requires one free IP address in each of the associated private subnets, although two are preferable. For details, see How to Fix a Connection Failure in the Amazon Key Management Service Developer Guide. -
INVALID_CREDENTIALS— TheKeyStorePasswordfor the custom key store doesn't match the current password of thekmsusercrypto user in the Amazon CloudHSM cluster. Before you can connect your custom key store to its Amazon CloudHSM cluster, you must change thekmsuseraccount password and update theKeyStorePasswordvalue for the custom key store. -
SUBNET_NOT_FOUND— A subnet in the Amazon CloudHSM cluster configuration was deleted. If Amazon KMS cannot find all of the subnets in the cluster configuration, attempts to connect the custom key store to the Amazon CloudHSM cluster fail. To fix this error, create a cluster from a recent backup and associate it with your custom key store. (This process creates a new cluster configuration with a VPC and private subnets.) For details, see How to Fix a Connection Failure in the Amazon Key Management Service Developer Guide. -
USER_LOCKED_OUT— ThekmsuserCU account is locked out of the associated Amazon CloudHSM cluster due to too many failed password attempts. Before you can connect your custom key store to its Amazon CloudHSM cluster, you must change thekmsuseraccount password and update the key store password value for the custom key store. -
USER_LOGGED_IN— ThekmsuserCU account is logged into the associated Amazon CloudHSM cluster. This prevents Amazon KMS from rotating thekmsuseraccount password and logging into the cluster. Before you can connect your custom key store to its Amazon CloudHSM cluster, you must log thekmsuserCU out of the cluster. If you changed thekmsuserpassword to log into the cluster, you must also and update the key store password value for the custom key store. For help, see How to Log Out and Reconnect in the Amazon Key Management Service Developer Guide. -
USER_NOT_FOUND— Amazon KMS cannot find akmsuserCU account in the associated Amazon CloudHSM cluster. Before you can connect your custom key store to its Amazon CloudHSM cluster, you must create akmsuserCU account in the cluster, and then update the key store password value for the custom key store.
External key stores:
-
INVALID_CREDENTIALS— One or both of theXksProxyAuthenticationCredentialvalues is not valid on the specified external key store proxy. -
XKS_PROXY_ACCESS_DENIED— Amazon KMS requests are denied access to the external key store proxy. If the external key store proxy has authorization rules, verify that they permit Amazon KMS to communicate with the proxy on your behalf. -
XKS_PROXY_INVALID_CONFIGURATION— A configuration error is preventing the external key store from connecting to its proxy. Verify the value of theXksProxyUriPath. -
XKS_PROXY_INVALID_RESPONSE— Amazon KMS cannot interpret the response from the external key store proxy. If you see this connection error code repeatedly, notify your external key store proxy vendor. -
XKS_PROXY_INVALID_TLS_CONFIGURATION— Amazon KMS cannot connect to the external key store proxy because the TLS configuration is invalid. Verify that the XKS proxy supports TLS 1.2 or 1.3. Also, verify that the TLS certificate is not expired, and that it matches the hostname in theXksProxyUriEndpointvalue, and that it is signed by a certificate authority included in the Trusted Certificate Authoritieslist. -
XKS_PROXY_NOT_REACHABLE— Amazon KMS can't communicate with your external key store proxy. Verify that theXksProxyUriEndpointandXksProxyUriPathare correct. Use the tools for your external key store proxy to verify that the proxy is active and available on its network. Also, verify that your external key manager instances are operating properly. Connection attempts fail with this connection error code if the proxy reports that all external key manager instances are unavailable. -
XKS_PROXY_TIMED_OUT— Amazon KMS can connect to the external key store proxy, but the proxy does not respond to Amazon KMS in the time allotted. If you see this connection error code repeatedly, notify your external key store proxy vendor. -
XKS_VPC_ENDPOINT_SERVICE_INVALID_CONFIGURATION— The Amazon VPC endpoint service configuration doesn't conform to the requirements for an Amazon KMS external key store.-
The VPC endpoint service must be an endpoint service for interface endpoints in the caller's Amazon Web Services account.
-
It must have a network load balancer (NLB) connected to at least two subnets, each in a different Availability Zone.
-
The
Allow principalslist must include the Amazon KMS service principal for the Region,cks.kms.<region>.amazonaws.com, such ascks.kms.us-east-1.amazonaws.com. -
It must not require acceptance of connection requests.
-
It must have a private DNS name. The private DNS name for an external key store with
VPC_ENDPOINT_SERVICEconnectivity must be unique in its Amazon Web Services Region. -
The domain of the private DNS name must have a verification status of
verified. -
The TLS certificate specifies the private DNS hostname at which the endpoint is reachable.
-
-
XKS_VPC_ENDPOINT_SERVICE_NOT_FOUND— Amazon KMS can't find the VPC endpoint service that it uses to communicate with the external key store proxy. Verify that theXksProxyVpcEndpointServiceNameis correct and the Amazon KMS service principal has service consumer permissions on the Amazon VPC endpoint service.
Type: String
Valid Values:
INVALID_CREDENTIALS | CLUSTER_NOT_FOUND | NETWORK_ERRORS | INTERNAL_ERROR | INSUFFICIENT_CLOUDHSM_HSMS | USER_LOCKED_OUT | USER_NOT_FOUND | USER_LOGGED_IN | SUBNET_NOT_FOUND | INSUFFICIENT_FREE_ADDRESSES_IN_SUBNET | XKS_PROXY_ACCESS_DENIED | XKS_PROXY_NOT_REACHABLE | XKS_VPC_ENDPOINT_SERVICE_NOT_FOUND | XKS_PROXY_INVALID_RESPONSE | XKS_PROXY_INVALID_CONFIGURATION | XKS_VPC_ENDPOINT_SERVICE_INVALID_CONFIGURATION | XKS_PROXY_TIMED_OUT | XKS_PROXY_INVALID_TLS_CONFIGURATIONRequired: No
-
- ConnectionState
-
Indicates whether the custom key store is connected to its backing key store. For an Amazon CloudHSM key store, the
ConnectionStateindicates whether it is connected to its Amazon CloudHSM cluster. For an external key store, theConnectionStateindicates whether it is connected to the external key store proxy that communicates with your external key manager.You can create and use KMS keys in your custom key stores only when its
ConnectionStateisCONNECTED.The
ConnectionStatevalue isDISCONNECTEDonly if the key store has never been connected or you use the DisconnectCustomKeyStore operation to disconnect it. If the value isCONNECTEDbut you are having trouble using the custom key store, make sure that the backing key store is reachable and active. For an Amazon CloudHSM key store, verify that its associated Amazon CloudHSM cluster is active and contains at least one active HSM. For an external key store, verify that the external key store proxy and external key manager are connected and enabled.A value of
FAILEDindicates that an attempt to connect was unsuccessful. TheConnectionErrorCodefield in the response indicates the cause of the failure. For help resolving a connection failure, see Troubleshooting a custom key store in the Amazon Key Management Service Developer Guide.Type: String
Valid Values:
CONNECTED | CONNECTING | FAILED | DISCONNECTED | DISCONNECTINGRequired: No
- CreationDate
-
The date and time when the custom key store was created.
Type: Timestamp
Required: No
- CustomKeyStoreId
-
A unique identifier for the custom key store.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Required: No
- CustomKeyStoreName
-
The user-specified friendly name for the custom key store.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 256.
Required: No
- CustomKeyStoreType
-
Indicates the type of the custom key store.
AWS_CLOUDHSMindicates a custom key store backed by an Amazon CloudHSM cluster.EXTERNAL_KEY_STOREindicates a custom key store backed by an external key store proxy and external key manager outside of Amazon.Type: String
Valid Values:
AWS_CLOUDHSM | EXTERNAL_KEY_STORERequired: No
- TrustAnchorCertificate
-
The trust anchor certificate of the Amazon CloudHSM cluster associated with an Amazon CloudHSM key store. When you initialize the cluster, you create this certificate and save it in the
customerCA.crtfile.This field appears only when the
CustomKeyStoreTypeisAWS_CLOUDHSM.Type: String
Length Constraints: Minimum length of 1. Maximum length of 5000.
Required: No
- XksProxyConfiguration
-
Configuration settings for the external key store proxy (XKS proxy). The external key store proxy translates Amazon KMS requests into a format that your external key manager can understand. The proxy configuration includes connection information that Amazon KMS requires.
This field appears only when the
CustomKeyStoreTypeisEXTERNAL_KEY_STORE.Type: XksProxyConfigurationType object
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: