Configuración del Amazon Q Developer Wiz complemento

Wiz es una plataforma de seguridad en la nube que proporciona gestión de la postura de seguridad, evaluación y priorización de riesgos y gestión de vulnerabilidades. Si usas Wiz para evaluar y monitorear tus AWS aplicaciones, puedes usar el complemento del chat de Amazon Q para acceder a información de Wiz sin salir del AWS Management Console.

Puede usar el complemento para identificar y recuperar Wiz problemas, evalúe sus activos más riesgosos y comprenda las vulnerabilidades o exposiciones. Tras recibir una respuesta, puede hacer preguntas de seguimiento, incluida la forma de solucionar un problema.

Para configurar el complemento, debes proporcionar las credenciales de autenticación de tu Wiz cuenta para habilitar una conexión entre Amazon Q y Wiz. Después de configurar el complemento, puede acceder a Wiz métricas @wiz añadiéndolas al principio de la pregunta en el chat de Amazon Q.

Requisitos previos

Agregar permisos

Para configurar los complementos, se requieren los siguientes permisos de nivel de administrador:

Adquiera credenciales

Antes de empezar, anote la siguiente información de su Wiz account. Estas credenciales de autenticación se almacenarán en AWS Secrets Manager secreto al configurar el complemento.

Secretos y funciones de servicio

AWS Secrets Manager secreto

Cuando configuras el complemento, Amazon Q crea un nuevo AWS Secrets Manager secreto para que lo guardes Wiz credenciales de autenticación. Como alternativa, puede usar un secreto existente que haya creado usted mismo.

Si crea un secreto usted mismo, asegúrese de que incluya las siguientes credenciales y utilice el siguiente JSON formato:

{ 
   "ClientId": "<your-client-id>", 
   "ClientSecret": "<your-client-secret>"  
}

Para obtener más información sobre la creación de secretos, consulte Crear un secreto en la Guía del AWS Secrets Manager usuario.

Roles de servicio

Para configurar el Wiz en Amazon Q Developer, necesitas crear un rol de servicio que dé permiso a Amazon Q para acceder a tu secreto de Secrets Manager. Amazon Q asume esta función para acceder al secreto donde su Wiz se almacenan las credenciales.

Al configurar el complemento en la AWS consola, tiene la opción de crear un nuevo secreto o utilizar uno existente. Si creas un secreto nuevo, el rol de servicio asociado se crea automáticamente. Si utilizas un secreto existente y un rol de servicio existente, asegúrate de que tu rol de servicio contenga estos permisos y que tenga adjunta la siguiente política de confianza. El rol de servicio necesario depende del método de cifrado secreto.

Si el secreto está cifrado con una KMS clave AWS gestionada, se requiere el siguiente rol de IAM servicio:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:secretsmanager:{{your-region}}:{{your-account-id}}:secret:[[secret-id]]"
            ]
        }
    ]
}

Si el secreto está cifrado con una AWS KMS clave gestionada por el cliente, se requiere el siguiente rol de IAM servicio:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:{{region}}:{{accountId}}:secret:{{secretId}}"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": "arn:aws:kms:{{region}}:{{accountId}}:key/{{keyId}}",
            "Condition": {
                "StringEquals": {
                    "kms:ViaService": "secretsmanager.{{region}}.amazonaws.com"
                }
            }
        }
    ]
}

Para permitir que Amazon Q asuma la función de servicio, la función de servicio necesita la siguiente política de confianza:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "q.amazonaws.com"
      },
      "Action": ["sts:AssumeRole", "sts:SetContext"],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{accountId}}",
          "aws:SourceArn": "arn:aws:codewhisperer:{{region}}:{{accountId}}:profile/{{profileId}}"
        }
      }
    }
  ]
}

Para obtener más información sobre las funciones de servicio, consulte Crear una función para delegar permisos a un AWS servicio en la Guía del AWS Identity and Access Management usuario.

Configure el Wiz complemento

Los complementos se configuran en la consola de Amazon Q Developer. Amazon Q utiliza las credenciales almacenadas en AWS Secrets Manager para permitir las interacciones con Wiz.

Para configurar el Wiz complete el siguiente procedimiento:

Si quieres actualizar las credenciales de un complemento, debes eliminar el complemento actual y configurar uno nuevo. Al eliminar un complemento, se eliminan todas las credenciales y especificaciones anteriores. Cada vez que configuras un complemento nuevo, ARN se genera uno nuevo.

Configura los permisos de usuario

Para usar los complementos, se requieren los siguientes permisos:

Cuando concedes acceso a una IAM identidad a una entidad configurada Wiz plugin, la identidad obtiene acceso a cualquier recurso del Wiz cuenta recuperable mediante el complemento. Wiz el plugin no detecta los permisos de usuario. Si quieres controlar el acceso a un complemento, puedes hacerlo especificando el complemento ARN en una IAM política.

Cada vez que crees o elimines y vuelvas a configurar un complemento, se le asigna uno nuevoARN. Si utilizas un complemento ARN en una política, tendrás que actualizarlo si quieres conceder acceso al complemento recién configurado.

Para localizar el Wiz complementoARN, vaya a la página de complementos en la consola de desarrolladores de Amazon Q y elija el configurado Wiz el complemento. En la página de detalles del plugin, copia el pluginARN. Puedes añadirlo ARN a una política para permitir o denegar el acceso al Wiz el complemento.

Para ver ejemplos de IAM políticas que controlan el acceso a los complementos, consultePermita a los usuarios chatear con complementos de un proveedor.

Chatea con el Wiz complemento

Para usar Amazon Q Wiz plugin, introduce @Wiz al principio una pregunta sobre tu Wiz problemas. También se deben incluir las preguntas de seguimiento o las respuestas a las preguntas de Amazon @Wiz Q.

A continuación, se muestran algunos ejemplos de casos de uso y las preguntas asociadas que puede hacer para aprovechar al máximo Amazon Q Wiz el complemento: