As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Netskope Token de API
Campos de valor secreto
A seguir estão os campos que devem estar contidos no segredo do Secrets Manager:
{
"apiToken": "API token value",
"tenantUrl": "https://example.goskope.com",
"serviceAccountName": "service account name"
}- Token de API
-
O token portador da API Netskope REST para a conta de serviço. O processo de rotação atualiza esse campo.
- URL do inquilino
-
Seu URL de Netskope inquilino, por exemplo
https://example.goskope.com. O URL deve usar HTTPS, deve terminar emgoskope.come não deve terminar com uma barra final. Um host regional como o tambémhttps://example.eu.goskope.comé válido. - serviço AccountName
-
O nome da conta Netskope de serviço que possui o token. O Secrets Manager registra esse nome para registro e auditoria.
A rotação também grava createdDate e expiresDate insere o valor secreto. Esses campos registram o tempo de emissão e a expiração do token atual no formato ISO 8601. Eles não são campos que você fornece.
A função da conta de serviço não é armazenada no segredo. A função pertence à conta de serviço e não ao token, portanto, a rotação nunca a altera.
Campos de metadados secretos
Esse tipo de segredo não requer campos de metadados de rotação. Ele não usa nenhum segredo de administrador, e o Secrets Manager define a vida útil do token em 365 dias.
Fluxo de uso
Essa rotação usa uma arquitetura de segredo único. Nenhum segredo administrativo é necessário. A conta de serviço usa seu token atual para gerar seu próprio substituto.
Para criar seu segredo, use a chamada de CreateSecretAPI. Defina o valor secreto para os campos descritos acima e defina o tipo de segredo como NetskopeApiToken. Para configurar a rotação, use a chamada de RotateSecretAPI. Na RotateSecret chamada, forneça um ARN de função que conceda ao serviço permissão para alternar o segredo. Para ver um exemplo de política de permissões, consulte Segurança e permissões.
Durante a rotação, o Secrets Manager chama o endpoint da conta de Netskope serviço com o token atual para gerar um substituto. Ele armazena o novo token como a versão pendente, o verifica em relação à Netskope API e o promove para o atual. O Secrets Manager rejeita um intervalo de rotação maior que 350 dias, o que mantém cada intervalo dentro da vida útil do token de 365 dias.
Netskopeinvalida o token antigo assim que gera o novo, para que os dois tokens nunca se sobreponham. Por aproximadamente 30 segundos durante a rotação, a versão atual do segredo contém um token que não funciona mais. Seu aplicativo deve lidar com uma resposta HTTP 401 lendo o segredo novamente e tentando novamente. Um aplicativo que armazena o token em cache sem esse padrão falha durante cada rotação.
Se a função da conta de serviço usar uma lista de permissões de IP, adicione a lista de prefixos AWS-managed com.amazonaws. a essa lista de permissões. As chamadas de rotação se originam dessa lista de prefixos e Netskope retornam HTTP 403 se a lista de permissões as excluir. Para obter mais informações, consulte listaS de prefixos gerenciados da AWS no Guia do usuário da Amazon VPC.region.secretsmanager-managed-external-secrets
