Para atualizar as credenciais que os pods usam para autenticação, é possível alternar o par de chaves que o Google Distributed Cloud usa para assinar os tokens da conta de serviço do Kubernetes (KSA, na sigla em inglês) que ele emite para os pods em um cluster de usuário. A rotação substitui as chaves privadas e públicas, emite novamente tokens assinados pela nova chave privada e fornece aoGoogle Cloud a nova chave pública para autenticação da Identidade da carga de trabalho. A rotação de chaves não é compatível com clusters avançados.
Sobre as chaves de assinatura de KSA
Uma KSA fornece uma identidade para processos executados em um pod. As KSAs são diferentes das contas de serviço doGoogle Cloud , que os aplicativos usam para fazer chamadas autorizadas para as APIs do Google Cloud .
O Google Distributed Cloud usa uma chave privada para assinar os tokens de KSA gerados para os pods e a chave pública correspondente para validar os tokens quando os pods enviam solicitações ao servidor da API Kubernetes. Quando um pod usa a Identidade da carga de trabalho para chamar as APIs do Google Cloud , o Google Cloud usa a mesma chave pública para autenticar a identidade do pod. Durante a criação do cluster de usuário, o Google Distributed Cloud gera o par de chaves, registra o cluster em uma frota e fornece a chave pública para o Google Cloud.
Tokens vinculados e tokens legados
Um pod pode usar um token legado ou um token vinculado para autenticação e autorização quando chama o servidor de API do Kubernetes. Os tokens vinculados têm um ciclo de vida limitado e são distribuídos para os pods usando volumes projetados. Os tokens legados nunca expiram e são mantidos em secrets do Kubernetes. Recomendamos os tokens vinculados porque eles são mais seguros.
Tanto os tokens vinculados quanto os legados são atualizados durante uma rotação de chaves.
Limitações
- Se você criou o cluster com
enableAdvancedClusterdefinido comotrue(necessário para configurar domínios de topologia), a rotação de chaves não é compatível.
Iniciar uma rotação de chaves
Antes de iniciar uma rotação de chaves, considere estes pontos:
Durante uma rotação de chaves, não é possível iniciar outra rotação de chaves, uma autoridade de certificação ou uma atualização de cluster.
A rotação de chaves não pode ser pausada ou revertida. Todas as chaves antigas são excluídas.
A rotação de chaves exclui os nós do cluster atuais e cria novos nós.
Para iniciar uma rotação de chaves:
gkectl update credentials ksa-signing-key rotate \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE \
[--skip-prompt]
Substitua:
USER_CLUSTER_CONFIG: é o caminho do arquivo de configuração do cluster de usuário
ADMIN_KUBECONFIG_FILE: o caminho do arquivo kubeconfig do cluster de administrador
Inclua --skip-prompt se não quiser ser solicitado.
Ver o status da rotação de chaves
Para ver o status de uma rotação de chaves, faça o seguinte:
gkectl update credentials ksa-signing-key status \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE
Se a rotação de chaves já tiver sido concluída, você verá uma mensagem como esta:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: True,
reason: KSASigningKeyRotationCompleted,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[2]}
Se a rotação de chaves da assinatura de KSA ainda estiver em andamento, você verá uma mensagem semelhante a esta:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: False,
reason: KSASigningKeyRotationProcessedReason,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[1,2]}