Usar o EnableKeyRotation
com um AWS SDK ou a CLI
Os exemplos de código a seguir mostram como usar o EnableKeyRotation
.
- CLI
-
- AWS CLI
-
Para habilitar a alternância automática de uma chave do KMS
O exemplo de
enable-key-rotation
a seguir viabiliza a alternância automática de uma chave do KMS gerenciada pelo cliente com um período de alternância de 180 dias. A chave do KMS será alternada em um ano (aproximadamente 365 dias) a partir da data em que esse comando for concluído e todos os anos a partir de então.O parâmetro
--key-id
identifica a chave do KMS. Este exemplo usa o valor de ARN da chave, mas você pode usar o ID da chave ou o ARN da chave do KMS. O parâmetro--rotation-period-in-days
especifica o número de dias entre cada data de alternância. Especifique um valor entre 90 e 2.560 dias. Se nenhum valor for especificado, o valor padrão será de 365 dias.aws kms enable-key-rotation \ --key-id
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
\ --rotation-period-in-days180
Este comando não produz saída. Use o
get-key-rotation-status
comando para verificar se a chave KMS está habilitada.Para obter mais informações, consulte Rotating keys no Guia do desenvolvedor do AWS Key Management Service.
-
Para obter detalhes da API, consulte EnableKeyRotation
na Referência de comandos da AWS CLI.
-
- Python
-
- SDK para Python (Boto3).
-
nota
Há mais no GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS
. class KeyManager: def __init__(self, kms_client): self.kms_client = kms_client self.created_keys = [] @classmethod def from_client(cls) -> "KeyManager": """ Creates a KeyManager instance with a default KMS client. :return: An instance of KeyManager initialized with the default KMS client. """ kms_client = boto3.client("kms") return cls(kms_client) def enable_key_rotation(self, key_id: str) -> None: """ Enables rotation for a key. :param key_id: The ARN or ID of the key to enable rotation for. """ try: self.kms_client.enable_key_rotation(KeyId=key_id) except ClientError as err: logging.error( "Couldn't enable rotation for key '%s'. Here's why: %s", key_id, err.response["Error"]["Message"], ) raise
-
Para obter detalhes da API, consulte EnableKeyRotation na Referência da API do AWS SDK para Python (Boto3).
-
Para ver uma lista completa dos Guias do desenvolvedor de SDK da AWS e exemplos de código, consulte Usar este serviço com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.