Atualizando as configurações de segurança do cluster Amazon MSK usando o AWS CLI

1. Crie um arquivo JSON contendo as configurações de criptografia desejadas para o cluster. Veja um exemplo a seguir.

   nota

   Você só pode atualizar a configuração de criptografia cliente-agente. Você não pode atualizar a configuração de criptografia no cluster (broker-to-broker).

   {"EncryptionInTransit":{"ClientBroker": "TLS"}}

2. Crie um arquivo JSON contendo as configurações de autenticação desejadas para o cluster. Veja um exemplo a seguir.

   {"Sasl":{"Scram":{"Enabled":true}}}

3. Execute o seguinte AWS CLI comando:

   aws kafka update-security --cluster-arn ClusterArn --current-version Current-Cluster-Version --client-authentication file://Path-to-Authentication-Settings-JSON-File --encryption-info file://Path-to-Encryption-Settings-JSON-File

   A saída dessa operação update-security é semelhante ao seguinte JSON.

   {
       
       "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
       "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
   }

4. Para ver o status da update-security operação, execute o comando a seguir, ClusterOperationArn substituindo-o pelo ARN obtido na saída do update-security comando.

   aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

   A saída desse comando describe-cluster-operation é semelhante ao seguinte JSON de exemplo.

   {
       "ClusterOperationInfo": {
           "ClientRequestId": "c0b7af47-8591-45b5-9c0c-909a1a2c99ea",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2021-09-17T02:35:47.753000+00:00",
           "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
           "OperationState": "PENDING",
           "OperationType": "UPDATE_SECURITY",
           "SourceClusterInfo": {},
           "TargetClusterInfo": {}
       }
   }

   Se OperationState tiver o valor PENDING ou UPDATE_IN_PROGRESS, aguarde um pouco e execute o comando describe-cluster-operation novamente.

nota

As operações de API AWS CLI e de atualização das configurações de segurança de um cluster são idempotentes. Isso significa que se você invocar a operação de atualização de segurança e especificar uma configuração de autenticação ou criptografia que seja a mesma configuração que o cluster já tem, essa configuração não será alterada.