Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Netskope Token de API
Campos de valores secretos
Los siguientes son los campos que deben estar incluidos en el secreto de Secrets Manager:
{
"apiToken": "API token value",
"tenantUrl": "https://example.goskope.com",
"serviceAccountName": "service account name"
}- Token de API
-
El token portador de la API Netskope REST de la cuenta de servicio. El proceso de rotación actualiza este campo.
- URL del inquilino
-
La URL de su Netskope inquilino, por ejemplo.
https://example.goskope.comLa URL debe usar HTTPS, debe terminar engoskope.comy no debe terminar con una barra al final. Un host regional como, por ejemplo, tambiénhttps://example.eu.goskope.comes válido. - servicio AccountName
-
El nombre de la cuenta de Netskope servicio propietaria del token. Secrets Manager registra este nombre para su registro y auditoría.
La rotación también escribe createdDate y expiresDate en el valor secreto. Estos campos registran la hora de emisión y el vencimiento del token actual en formato ISO 8601. No son campos que usted proporcione.
El rol de la cuenta de servicio no está almacenado en el secreto. El rol pertenece a la cuenta de servicio y no al token, por lo que la rotación nunca lo cambia.
Campos de metadatos secretos
Este tipo de secreto no requiere campos de metadatos de rotación. No utiliza ningún secreto de administrador y Secrets Manager establece la vida útil del token en 365 días.
Flujo de uso
Esta rotación utiliza una arquitectura de secreto único. No se requiere ningún secreto de administrador. La cuenta de servicio usa su token actual para generar su propio token de reemplazo.
Para crear tu secreto, usa la llamada a la CreateSecretAPI. Establezca el valor secreto en los campos descritos anteriormente y establezca el tipo de secreto en NetskopeApiToken. Para configurar la rotación, usa la llamada a la RotateSecretAPI. En la RotateSecret llamada, proporcione un ARN de rol que otorgue al servicio permiso para rotar el secreto. Para ver un ejemplo de política de permisos, consulta Seguridad y permisos.
Durante la rotación, Secrets Manager llama al punto final de la cuenta de Netskope servicio con el token actual para generar un reemplazo. Almacena el nuevo token como versión pendiente, lo verifica con la Netskope API y, a continuación, lo promociona a la versión actual. Secrets Manager rechaza un intervalo de rotación superior a 350 días, lo que mantiene cada intervalo dentro de la vida útil del token de 365 días.
Netskopeinvalida el token antiguo en cuanto genera el nuevo, de forma que los dos símbolos nunca se superpongan. Durante aproximadamente 30 segundos durante la rotación, la versión actual del secreto contiene una ficha que ya no funciona. La aplicación debe gestionar una respuesta HTTP 401. Para ello, debe volver a leer el secreto y volver a intentarlo. Una aplicación que almacena en caché el token sin este patrón falla durante cada rotación.
Si el rol de la cuenta de servicio usa una lista de direcciones IP permitidas, añada la lista de AWS prefijos administrados a esa listacom.amazonaws.. Las llamadas de rotación se originan en esta lista de prefijos y Netskope devuelven HTTP 403 si la lista de permitidos las excluye. Para obtener más información, consulte Listas de prefijos administradas de AWS en la Guía del usuario de Amazon VPC.region.secretsmanager-managed-external-secrets
