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.
Cifrar OpenSearch Metadatos de aplicaciones de interfaz de usuario con claves administradas por el
Los activos visuales y las configuraciones se almacenan como metadatos para su OpenSearch Aplicaciones de interfaz de usuario. Esto incluye consultas, visualizaciones y paneles guardados. Los datos de las fuentes de datos asociadas no se almacenan en los metadatos. Para obtener información sobre cómo cifrar los datos en sus fuentes de datos, consulte Protección de datos en Amazon OpenSearch Servicio por OpenSearch dominios y Cifrado en Amazon OpenSearch Sin servidor para colecciones sin servidor.
Tu OpenSearch Los metadatos de la interfaz de usuario están protegidos con cifrado en reposo. Esto evita el acceso no autorizado. El cifrado utiliza AWS Key Management Service (AWS KMS) para almacenar y administrar las claves de cifrado. De forma predeterminada, OpenSearch Los metadatos de la interfaz de usuario se cifran con AWS claves propias.
También puede utilizar la función de clave gestionada por el cliente (CMK) para gestionar sus propias claves de cifrado. Esto le ayuda a cumplir los requisitos normativos y de cumplimiento. Para usar CMK, debe crear un nuevo OpenSearch Aplica la interfaz de usuario y habilita CMK en el proceso de creación. Actualmente no se admite la actualización de una existente OpenSearch Aplicación de interfaz de usuario desde AWS clave propia de CMK.
Cuándo usar las claves administradas por el cliente:
-
Su organización tiene requisitos de cumplimiento normativo para la administración de claves
-
Necesita registros de auditoría para el uso de las claves de cifrado
-
Quiere controlar los programas de rotación de claves
-
Necesita integrarse con los flujos de trabajo de administración de claves existentes
Cuando utiliza una clave gestionada por el cliente, tiene un control total sobre la clave. Esto incluye la capacidad de:
-
Establecer y mantener políticas de claves.
-
Establecer y mantener políticas y concesiones de IAM.
-
Habilitar y deshabilitar la clave
-
Rote el material criptográfico de la clave
-
Agregue etiquetas a la clave
-
Crear alias de claves.
-
Programa la eliminación de la clave
La clave gestionada por el cliente debe estar en la misma Región de AWS como el OpenSearch aplicación de interfaz de usuario. No puede usar una clave de una región diferente.
Temas
Requisitos previos para usar las claves administradas por el cliente
Habilitar el cifrado de claves administrado por el cliente para AI Assistant Memory
Creación de una aplicación con cifrado de claves administrado por el cliente mediante la consola
Crear una aplicación con un cifrado de claves gestionado por el cliente mediante el AWS CLI
Supervisión del uso de las claves gestionadas por el cliente
Requisitos previos para usar las claves administradas por el cliente
Antes de poder usar una clave gestionada por el cliente para cifrar su OpenSearch Los metadatos de la aplicación de interfaz de usuario, debe crear una clave de cifrado simétrica en AWS KMS. Para obtener instrucciones sobre la creación de claves, consulte Creación de claves en el AWS KMS Guía para desarrolladores.
La política de claves para su clave gestionada por el cliente debe ser válida OpenSearch Permiso de interfaz de usuario para usar la clave. Utilice la siguiente política de claves y sustituya la placeholder values con su propia información:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowOpenSearchUIToUseKey", "Effect": "Allow", "Principal": { "Service": [ "application.opensearchservice.amazonaws.com" ] }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey", "kms:DescribeKey" ], "Resource": "*" }, { "Sid": "AllowOpenSearchUIToCreateGrantForAIAssistantMemory", "Effect": "Allow", "Principal": { "Service": [ "application.opensearchservice.amazonaws.com" ] }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "Bool": { "kms:GrantIsForAWSResource": "true" }, "ForAllValues:StringEquals": { "kms:GrantOperations": [ "Decrypt", "GenerateDataKey" ] } } }, { "Sid": "AllowKeyAdministration", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": "kms:*", "Resource": "*" } ] }
La política incluye tres declaraciones:
-
La primera declaración permite OpenSearch Interfaz de usuario para usar la clave en las operaciones de cifrado.
-
La segunda declaración permite OpenSearch Interfaz de usuario para crear un AWS KMS conceda la clave para que pueda cifrar los datos de AI Assistant Memory para las funciones de IA de la agencia. Para obtener más información, consulte Habilitar el cifrado de claves administrado por el cliente para AI Assistant Memory.
-
La tercera afirmación permite a los usuarios acceder a su Cuenta de AWS para administrar la clave. Esto incluye los permisos para actualizar la política de claves, habilitar o deshabilitar la clave y programar su eliminación. Puede restringir aún más estos permisos sustituyendo el principal raíz por usuarios o funciones de IAM específicos.
Para obtener más información sobre las políticas clave, consulte Uso de políticas clave en AWS KMS en el AWS KMS Guía para desarrolladores.
Habilitar el cifrado de claves administrado por el cliente para AI Assistant Memory
Si utilizas una clave gestionada por el cliente para cifrar tu OpenSearch Aplicación de interfaz de usuario, su política de claves también debe permitirlo OpenSearch Interfaz de usuario para crear una AWS KMS beca para AI Assistant Memory. La política clave en Requisitos previos para usar las claves administradas por el cliente incluye este permiso en el AllowOpenSearchUIToCreateGrantForAIAssistantMemory declaración. En esta sección se explica por qué es necesaria la declaración y cómo recuperar una aplicación que haya creado sin ella.
AI Assistant Memory es una capa de memoria gestionada por servicios que permite a Agentic Chat y al agente de investigación acceder OpenSearch INTERFAZ DE USUARIO. Guarda tus conversaciones anteriores para que las conversaciones en curso puedan persistir en todas las páginas principales. Para obtener más información, consulte Memoria del asistente de IA en Amazon OpenSearch Servicio.
Amazon OpenSearch El servicio habilita las funciones de IA de la agencia de forma predeterminada para los nuevos OpenSearch Aplicaciones de interfaz de usuario. Puede desactivarlas mediante la consola o la API. Para obtener más información, consulte Activación y desactivación de las funciones de IA de la agencia. Cuando las funciones están habilitadas, OpenSearch La interfaz de usuario crea una colección en un Amazon gestionado por servicios OpenSearch Cuenta sin servidor para almacenar los datos de la memoria.
Para cifrar los datos de la memoria con la clave gestionada por el cliente, OpenSearch La interfaz de usuario debe crear un AWS KMS conceda su clave. El AllowOpenSearchUIToUseKey la declaración otorga permisos solo para el cifrado de metadatos. No incluye el kms:CreateGrant permiso que requiere AI Assistant Memory.
Si tu política de claves no incluye la concesión del permiso, la aplicación se crea correctamente, pero el registro de la función AI Assistant Memory falla con un KMS_KEY_INSUFFICIENT_PERMISSION error. Agregue la siguiente declaración antes de crear la aplicación.
Si su política clave ya contiene las otras dos declaraciones que se muestran en Requisitos previos para usar las claves administradas por el cliente, añada la siguiente declaración a Statement matriz:
{ "Sid": "AllowOpenSearchUIToCreateGrantForAIAssistantMemory", "Effect": "Allow", "Principal": { "Service": [ "application.opensearchservice.amazonaws.com" ] }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "Bool": { "kms:GrantIsForAWSResource": "true" }, "ForAllValues:StringEquals": { "kms:GrantOperations": [ "Decrypt", "GenerateDataKey" ] } } }
Esta declaración utiliza las siguientes condiciones:
-
kms:GrantIsForAWSResourcepermite la subvención solo cuando un AWS el servicio la crea en su nombre, no cuando un director la crea directamente. -
kms:GrantOperationslimita la subvención aDecryptyGenerateDataKeyoperaciones que requiere AI Assistant Memory.
Añádela como una declaración independiente en tu política clave. No la combines con la existente AllowOpenSearchUIToUseKey declaración. Si los combinas, el kms:GrantIsForAWSResource la condición se aplica a kms:Encrypt, kms:Decrypt, kms:GenerateDataKey, y kms:DescribeKey actúa y rompe el cifrado de los metadatos.
Si ya has creado una aplicación y la función de memoria de AI Assistant no se ha podido registrar, no necesitas crear una nueva aplicación. Agregue la declaración a su política clave y, a continuación, llame al DeregisterCapability API seguida de RegisterCapability API en la aplicación existente. El estado de la capacidad cambia de create_failed a active. Esto difiere de cambiar la clave en sí, que requiere una nueva aplicación, como se describe en Actualización de la configuración de cifrado.
Creación de una aplicación con cifrado de claves administrado por el cliente mediante la consola
Al crear un OpenSearch En la consola, puedes especificar una clave gestionada por el cliente para cifrar los metadatos de la aplicación.
Para crear un OpenSearch Aplicación de interfaz de usuario con cifrado de claves administrado por el cliente mediante la consola
-
Inicia sesión en Amazon OpenSearch Consola de servicio en https://console.aws.amazon.com/aos/home
. -
En el panel de navegación izquierdo, elige OpenSearch Interfaz de usuario (paneles).
-
Elija Creación de aplicación.
-
En Nombre de la aplicación, especifique un nombre para su aplicación.
-
Configure los ajustes de autenticación y administración según sea necesario. Para obtener más información, consulte Empezando con el OpenSearch interfaz de usuario en Amazon OpenSearch Servicio.
-
En el Encriptación sección, para Cifrado en reposo, elija Utilice la clave gestionada por el cliente.
-
Seleccione una clave gestionada por el cliente existente de la lista o elija Crea una clave para crear una nueva clave en AWS KMS.
notaLa llave debe estar en el mismo Región de AWS como la aplicación que está creando.
-
(Opcional) Agregue etiquetas a la aplicación.
-
Seleccione Crear.
Crear una aplicación con un cifrado de claves gestionado por el cliente mediante el AWS CLI
Para crear un OpenSearch Aplicación de interfaz de usuario con cifrado de claves administrado por el cliente mediante AWS CLI, utilice el crear una aplicación comando con --kms-key-arn parámetro.
Sustituya placeholder values por su propia información.
aws opensearch create-application \ --namemy-application\ --kms-key-arn arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012
Si no especificas el --kms-key-arn parámetro, OpenSearch usa un AWS-clave gestionada para cifrar los metadatos de la aplicación.
Supervisión del uso de las claves gestionadas por el cliente
Cuando utiliza una clave gestionada por el cliente con un OpenSearch aplicación de interfaz de usuario, AWS KMS registra cada uso de la clave en AWS CloudTrail registros. Puedes usar estos registros para supervisar cómo y cuándo se usa tu clave. Los registros muestran qué usuario o servicio accedió a la clave.
AWS AWS KMS rota automáticamente las claves administradas por el cliente cada año. También puede rotar manualmente las claves según sea necesario. Para obtener más información sobre la rotación de teclas, consulte Rotación de claves de KMS en el AWS KMS Guía para desarrolladores.
Para obtener más información sobre la supervisión del uso de las claves, consulte Registro AWS KMS Llamadas a la API con AWS CloudTrail en el AWS KMS Guía para desarrolladores.
El uso de claves administradas por el cliente implica AWS KMS cargos. Los cargos se basan en la cantidad de solicitudes de API y claves almacenadas. Para obtener más información sobre los precios, consulta AWS Precios de los servicios de administración de claves
Actualización de la configuración de cifrado
Después de crear un OpenSearch La aplicación de interfaz de usuario no puede cambiar su configuración de cifrado. Si necesita usar una clave gestionada por el cliente diferente, debe crear una nueva aplicación. Si necesita cambiar entre AWS-claves administradas y administradas por el cliente, también debe crear una nueva aplicación con la configuración de cifrado deseada.
Antes de deshabilitar o eliminar una clave gestionada por el cliente, tenga en cuenta lo siguiente:
-
Si deshabilitas la clave, la aplicación perderá el acceso a sus metadatos cifrados. Debe volver a habilitar la misma clave para restablecer el acceso.
-
Si eliminas la clave, los objetos guardados de la aplicación quedarán permanentemente inaccesibles. Esto incluye consultas, visualizaciones y paneles. Las claves eliminadas no se pueden recuperar.
-
Recomendamos documentar el ARN de la clave antes de realizar cualquier cambio en el estado de la clave.
Siguientes pasos
Después de configurar el cifrado CMK para la aplicación, puede:
-
Asocie las fuentes de datos a la aplicación. Para obtener más información, consulte Administración de las asociaciones de orígenes de datos y los permisos de acceso a la nube privada virtual.
-
Crea espacios de trabajo para tu equipo. Para obtener más información, consulte Uso de Amazon OpenSearch Espacios de trabajo de servicio.
-
Configura AWS CloudTrail supervisar el uso de las claves. Para obtener más información, consulte Supervisión del uso de las claves gestionadas por el cliente.