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.
Configuración de la de AWS SDK de cifrado de bases de datos
| Nuestra biblioteca de cifrado del lado del cliente pasó a llamarse AWS SDK de cifrado de bases de datos. En esta guía para desarrolladores, se sigue proporcionando información sobre el cliente de cifrado de DynamoDB. |
El AWS El SDK de cifrado de bases de datos está diseñado para ser fácil de usar. Aunque el AWS El SDK de cifrado de bases de datos tiene varias opciones de configuración, los valores predeterminados se eligen cuidadosamente para que sean prácticos y seguros para la mayoría de las aplicaciones. Sin embargo, es posible que deba ajustar la configuración para mejorar el rendimiento o incluir una característica personalizada en el diseño.
Temas
Selección de un lenguaje de programación
El AWS El SDK de cifrado de bases de datos para DynamoDB está disponible en varios lenguajes de programación. Las implementaciones del lenguaje están diseñadas para ser totalmente interoperables y ofrecer las mismas características, aunque pueden implementarse de diferentes maneras. Por lo general, se utiliza la biblioteca que es compatible con su aplicación.
Seleccionar las claves de encapsulamiento
El AWS El SDK de cifrado de bases de datos genera una clave de datos simétrica única para cifrar cada campo. No necesita configurar, administrar ni usar las claves de datos. El AWS El SDK de cifrado de bases de datos lo hace por usted.
Sin embargo, debe seleccionar una o más claves de encapsulación para cifrar cada clave de datos. El SDK de cifrado de bases de datos de AWS admite claves KMS de cifrado simétrico y claves RSA KMS asimétricas de AWS Key Management Service(AWS KMS). También es compatible con las claves simétricas AES y las claves asimétricas RSA que proporciona en diferentes tamaños. Usted es responsable de la seguridad y durabilidad de sus claves de empaquetado, por lo que le recomendamos que utilice una clave de cifrado en un módulo de seguridad de hardware o en un servicio de infraestructura clave, como AWS KMS.
Para especificar las claves de encapsulación para el cifrado y el descifrado, utilice un conjunto de claves. Según el tipo de conjunto de claves que utilice, puede especificar una clave de encapsulación o varias claves de empaquetado del mismo tipo o de diferentes tipos. Si utiliza varias claves de encapsulación para encapsular una clave de datos, cada clave de encapsulación cifrará una copia de la misma clave de datos. Las claves de datos cifradas (una por clave de encapsulación) se guardan en la descripción del material que se almacena junto al campo cifrado. Para descifrar los datos, el AWS El SDK de cifrado de bases de datos debe usar primero una de sus claves de empaquetado para descifrar una clave de datos cifrada.
Recomendamos usar una de las AWS KMS llaveros siempre que sea posible. Los AWS El SDK de cifrado de bases de datos proporciona la AWS KMS llavero y el AWS KMS Llavero jerárquico, lo que reduce el número de llamadas realizadas a AWS KMS. Para especificar un AWS KMS key en un llavero, utilice un AWS KMS identificador de clave. Si utiliza el AWS KMS Conjunto de claves jerárquico, debe especificar el ARN de la clave. Para obtener más información sobre los identificadores de clave de un AWS KMS clave, consulte Identificadores clave en el AWS Key Management Service Guía para desarrolladores.
-
Cuando cifras con un AWS KMS puede especificar cualquier identificador de clave válido (clave ARN, nombre de alias, ARN de alias o identificador de clave) para una clave KMS de cifrado simétrico. Si usa una clave de RSA KMS asimétrica, debe especificar la clave ARN.
Si especifica un nombre de alias o un ARN de alias para una clave de KMS al cifrar, el SDK de cifrado de bases de datos de AWS guarda el ARN de clave actualmente asociado a ese alias; no lo guarda. Los cambios en el alias no afectan a la clave KMS utilizada para descifrar las claves de datos.
-
De forma predeterminada, el AWS KMS el llavero descifra los registros en modo estricto (en el que se especifican determinadas claves de KMS). Debe usar el ARN de una clave para identificar AWS KMS keys para descifrar.
Cuando se cifra con un AWS KMS llavero, el AWS El SDK de cifrado de bases de datos almacena la clave ARN del AWS KMS key en la descripción del material con la clave de datos cifrada. Al descifrar en modo estricto, el AWS El SDK de cifrado de bases de datos verifica que aparezca la misma clave ARN en el anillo de claves antes de intentar usar la clave de empaquetado para descifrar la clave de datos cifrada. Si utiliza un identificador de clave diferente, el AWS El SDK de cifrado de bases de datos no reconocerá ni utilizará el AWS KMS key, incluso si los identificadores hacen referencia a la misma clave.
-
Al descifrar en modo de descubrimiento, no especifique ninguna clave de encapsulación. En primer lugar, el AWS El SDK de cifrado de bases de datos intenta descifrar el registro con la clave ARN almacenada en la descripción del material. Si eso no funciona, el AWS El SDK de cifrado de bases de datos pregunta AWS KMS descifrar el registro con la clave de KMS que lo cifró, independientemente de quién sea el propietario de esa clave de KMS o quién tenga acceso a ella.
Para especificar una clave AES sin procesar o un par de claves RSA sin procesar como clave de encapsulación en un conjunto de claves, debe especificar un espacio de nombres y un nombre. Al descifrar, debe utilizar exactamente el mismo espacio de nombres y el mismo nombre para cada clave de encapsulación sin procesar que utilizó al cifrar. Si usa un nombre o espacio de nombres diferente, el AWS El SDK de cifrado de bases de datos no reconocerá ni utilizará la clave de empaquetado, aunque el material de la clave sea el mismo.
Crear un filtro de detección
Al descifrar datos cifrados con claves KMS, se recomienda descifrarlos en modo estricto, es decir, limitar las claves de encapsulamiento utilizadas solo a las que especifique. Sin embargo, si es necesario, también puede descifrar en el modo de detección, en el que no se especifica ninguna clave de encapsulamiento. En este modo, AWS KMS puede descifrar la clave de datos cifrada con la clave de KMS que la cifró, independientemente de quién sea el propietario de esa clave de KMS o quién tenga acceso a ella.
Si debe descifrar en modo de detección, le recomendamos que utilice siempre un filtro de detección, que limita las claves de KMS que se pueden usar a las de un determinado Cuenta de AWS y partición. El filtro de detección es opcional, pero es una práctica recomendada.
Utilice la siguiente tabla para determinar el valor de partición de su filtro de detección.
| Region | Partición |
|---|---|
| Regiones de AWS | aws |
| Regiones de China | aws-cn |
| AWS GovCloud (US) Regions | aws-us-gov |
El siguiente ejemplo muestra cómo crear un filtro de detección. Antes de usar el código, sustituya los valores del ejemplo por valores válidos para su Cuenta de AWS y particionar.
Trabajar con bases de datos de varios inquilinos
Con el AWS El SDK de cifrado de bases de datos, puede configurar el cifrado del lado del cliente para bases de datos con un esquema compartido aislando a cada inquilino con materiales de cifrado distintos. Al considerar una base de datos de multitenencia, tómese un tiempo para revisar sus requisitos de seguridad y cómo podría afectarlos la multitenencia. Por ejemplo, el uso de una base de datos multiusuario puede afectar a su capacidad de combinar los AWS El SDK de cifrado de bases de datos con otra solución de cifrado del lado del servidor.
Si tiene varios usuarios que realizan operaciones de cifrado en su base de datos, puede usar uno de los AWS KMS conjuntos de claves para proporcionar a cada usuario una clave distinta para utilizarla en sus operaciones criptográficas. Administrar las claves de datos de una solución de cifrado del cliente multitenencia puede resultar complicado. Recomendamos organizar los datos por inquilino siempre que sea posible. Si el inquilino se identifica mediante los valores de la clave principal (por ejemplo, la clave de partición de una tabla de Amazon DynamoDB), la administración de las claves resulta más sencilla.
Puede utilizar el AWS KMS llavero para aislar a cada inquilino con un AWS KMS llavero y AWS KMS keys. Basado en el volumen de AWS KMS llamadas realizadas por inquilino, es posible que desee utilizar el AWS KMS Conjunto de claves jerárquico para minimizar las llamadas a AWS KMS. El AWS KMS Llavero jerárquico es una solución de almacenamiento en caché de materiales criptográficos que reduce la cantidad de AWS KMS llamadas mediante AWS KMS protegido claves de sucursal se conservaron en una tabla de Amazon DynamoDB y, a continuación, almacenaron localmente en caché los materiales clave de rama utilizados en las operaciones de cifrado y descifrado. Debe utilizar el AWS KMS Conjunto de claves jerárquico para implementar cifrado con capacidad de búsqueda en su base de datos.
Crear balizas firmadas
El AWS Usos del SDK de cifrado de bases de datos balizas estándar y balizas compuestas para proporcionar cifrado con capacidad de búsqueda soluciones que permiten buscar registros cifrados sin descifrar toda la base de datos consultada. Sin embargo, el AWS El SDK de cifrado de bases de datos también es compatible balizas firmadas que se pueden configurar completamente a partir de campos firmados en texto plano. Las balizas firmadas son un tipo de baliza compuesta que indexan y realizan consultas complejas sobre ellas SIGN_ONLY y SIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXT campos.
Por ejemplo, si tiene una base de datos de multitenencia, puede que desee crear una baliza firmada que le permita consultar en la base de datos los registros cifrados por la clave de un inquilino específico. Para obtener más información, consulte Consulta de balizas en una base de datos de multitenencia.
Debes usar el AWS KMS Llavero jerárquico para crear balizas firmadas.
Para configurar una baliza firmada, proporcione los siguientes valores.
Puede definir las partes firmadas en listas definidas local o globalmente. Le recomendamos que defina las partes firmadas en una lista global en la versión de baliza siempre que sea posible. Al definir las partes firmadas de forma global, puede definir cada parte una vez y, a continuación, reutilizarlas en varias configuraciones de balizas compuestas. Si solo piensa utilizar una parte firmada una vez, puede definirla en una lista local en la configuración de balizas firmadas. Puede hacer referencia tanto a las partes locales como a las globales en su lista de constructores.
Si define sus listas de piezas firmadas de forma global, debe proporcionar una lista de piezas de construcción que identifique todas las formas posibles en las que la baliza firmada puede ensamblar los campos de la configuración de la baliza.
Para definir las listas de piezas firmadas de forma global, debe utilizar la versión 3.2 o posterior del AWS SDK de cifrado de bases de datos. Implemente la nueva versión en todos los lectores antes de definir cualquier pieza nueva a nivel mundial.
No puede actualizar las configuraciones de balizas existentes para definir listas de piezas firmadas de forma global.
- Nombre de la baliza
-
El nombre que utilizas al consultar la baliza.
El nombre de una baliza firmada no puede ser el mismo nombre que el de un campo sin cifrar. No puede haber dos balizas con el mismo nombre de baliza.
- Carácter dividido
-
El personaje que se usa para separar las partes que componen su baliza firmada.
El carácter dividido no puede aparecer en los valores de texto no cifrado de ninguno de los campos a partir de los que se construye la baliza firmada.
- Lista de piezas firmadas
-
Identifica los campos firmados incluidos en la baliza firmada.
Cada parte debe incluir un nombre, una fuente y un prefijo. La fuente es
SIGN_ONLYoSIGN_AND_INCLUDE_IN_ENCRYPTION_CONTEXTcampo que identifica la pieza. La fuente debe ser un nombre de campo o un índice que haga referencia al valor de un campo anidado. Si el nombre de la pieza identifica el origen, puede omitir el origen y el AWS El SDK de cifrado de bases de datos utilizará automáticamente el nombre como fuente. Recomendamos especificar la fuente como nombre de la pieza siempre que sea posible. El prefijo puede ser cualquier cadena, pero debe ser único. Dos partes firmadas de una baliza firmada no pueden tener el mismo prefijo. Recomendamos utilizar un valor corto que distinga la pieza de otras partes servidas por la baliza compuesta.Recomendamos definir las partes firmadas de forma global siempre que sea posible. Podrías considerar la posibilidad de definir una parte firmada de forma local si solo pretendes utilizarla en una baliza compuesta. Una pieza definida localmente no puede tener el mismo prefijo o nombre que una pieza definida globalmente.
- Lista de constructores (opcional)
-
Identifique los constructores que definen las diferentes formas en que la baliza firmada puede ensamblar las piezas firmadas.
Si no especifica una lista de constructores, la AWS El SDK de cifrado de bases de datos ensambla la baliza firmada con el siguiente constructor predeterminado.
-
Todas las piezas firmadas en el orden en que se agregaron a la lista de piezas firmadas
-
Todas las piezas son obligatorias
- Constructores
-
Cada constructor es una lista ordenada de piezas del constructor que define una forma de ensamblar la baliza firmada. Las piezas del constructor se unen en el orden en que se agregan a la lista, con cada parte separada por el carácter dividido especificado.
Cada parte del constructor nombra una parte firmada y define si esa parte es obligatoria u opcional dentro del constructor. Por ejemplo, si desea consultar una baliza firmada sobre
Field1,Field1.Field2yField1.Field2.Field3, marcarField2yField3como opcional y crear un constructor.Cada constructor debe tener como mínimo una pieza requerida. Recomendamos hacer que la primera parte de cada constructor sea obligatoria para poder usar el operador
BEGINS_WITHen las consultas.Un constructor tiene éxito si todas las piezas requeridas están presentes en el registro. Al escribir un registro nuevo, la baliza firmada utiliza la lista de constructores para determinar si la baliza se puede ensamblar a partir de los valores proporcionados. Intente ensamblar la baliza en el orden en que se agregaron los constructores a la lista de constructores y utilice el primer constructor que lo haga correctamente. Si ningún constructor tiene éxito, la baliza no se graba en el registro.
Todos los lectores y redactores deben especificar el mismo orden de constructores para garantizar que los resultados de sus consultas sean correctos.
Utilice los siguientes procedimientos para especificar su propia lista de constructores.
-
Cree una pieza constructora para cada pieza firmada para definir si esa pieza es necesaria o no.
El nombre de la pieza constructora debe ser el nombre del campo firmado.
El siguiente ejemplo ilustra cómo crear una pieza de construcción para un campo firmado.
-
Cree un constructor para cada una de las formas posibles de ensamblar la baliza firmada utilizando las partes constructoras que creó en el paso 1.
Por ejemplo, si desea consultar sobre
Field1.Field2.Field3yField4.Field2.Field3, debe crear dos constructores. TantoField1comoField4pueden ser necesarios porque están definidos en dos constructores distintos. -
Cree una lista de constructores que incluya todos los constructores que creó en el Paso 2.
-
Especifique el
constructorListcuando cree su baliza firmada.
-