AWS transfer: Document AWS Transfer Family host key storage types
Summary
Adds a section describing the two host key storage types (SERVICE_MANAGED and SECRETS_MANAGER), noting that Secrets Manager storage lets you encrypt host key material with your own AWS KMS key, plus a link to the new Secrets Manager host key page.
Security assessment
The added text documents where SFTP server private host key material is stored and that it can be protected with a customer-managed KMS key, which is security-relevant key-management guidance rather than a fix for a specific vulnerability.
Evidence
+ * AWS Secrets Manager (`SECRETS_MANAGER`) – Transfer Family stores the host key in a secret in Secrets Manager that you can encrypt with your own AWS KMS key. This is the default storage type when you create a server in the AWS Transfer Family console.
Diff
diff --git a/transfer/latest/userguide/configuring-servers-change-host-key.md b/transfer/latest/userguide/configuring-servers-change-host-key.md index 8e796db..137767a 100644 --- a//transfer/latest/userguide/configuring-servers-change-host-key.md +++ b//transfer/latest/userguide/configuring-servers-change-host-key.md @@ -28,0 +29,11 @@ Server host keys are used by servers that support the SFTP protocol. +AWS Transfer Family supports two host key storage types, which control where Transfer Family keeps the private key material for a host key: + + * Service managed (`SERVICE_MANAGED`) – Transfer Family stores and manages the host key material for you. This is the default storage type when you create a server by using the AWS CLI or the AWS API, and it requires no extra configuration. + + * AWS Secrets Manager (`SECRETS_MANAGER`) – Transfer Family stores the host key in a secret in Secrets Manager that you can encrypt with your own AWS KMS key. This is the default storage type when you create a server in the AWS Transfer Family console. + + + + +For details about AWS Secrets Manager storage, see [Store SFTP server host keys in AWS Secrets Manager](./server-host-key-storage.html). + @@ -47,0 +59,2 @@ The following topics provide detailed procedures for managing server host keys: + * [Store SFTP server host keys in AWS Secrets Manager](./server-host-key-storage.html) \- Store host keys in AWS Secrets Manager +