Todos los productos
Search
Centro de documentos

Simple Log Service:Cifrado de datos

Última actualización: Sep 18, 2026

Simple Log Service le permite usar Key Management Service (KMS) para cifrar datos y protegerlos en reposo. Este tema describe los mecanismos de cifrado de datos en Simple Log Service y proporciona instrucciones sobre cómo usar KMS para cifrar datos.

Requisitos previos

Key Management Service (KMS) debe estar activado. Para obtener más información, consulte Purchase a Dedicated KMS instance.

Mecanismos de cifrado de datos

Simple Log Service es compatible con los siguientes dos mecanismos de cifrado.

Cifrado con una clave de servicio

Características:

  • Simplicidad: no requiere configuración adicional. Simple Log Service gestiona el cifrado y la administración de claves, lo que reduce la carga operativa.

  • Aislamiento de claves: se genera una clave de cifrado de datos única para cada logstore con el fin de mejorar la seguridad de los datos.

  • Durabilidad: estas claves de cifrado de datos nunca caducan, lo que garantiza estabilidad a largo plazo.

  • Algoritmos de cifrado compatibles: AES (predeterminado) y SM4.

Casos de uso:

  • Desea implementar rápidamente el cifrado de datos sin gestionar las claves por su cuenta.

  • No tiene requisitos específicos de gestión de claves y prefiere que el proveedor del servicio las administre.

  • Necesita garantizar la validez y estabilidad a largo plazo de sus claves de cifrado de datos.

Usuarios objetivo:

Pequeñas empresas o usuarios individuales que buscan un cifrado de registros sencillo y seguro, sin tener que encargarse de tareas complejas de gestión de claves.

Cifrado con Bring Your Own Key (BYOK)

Características:

  • Control total: usted gestiona todo el ciclo de vida de sus claves, incluida la creación, rotación y eliminación.

  • Flexibilidad: puede actualizar o rotar las claves fácilmente según sea necesario para mejorar la seguridad y la flexibilidad.

  • Gestión proactiva: debe crear y gestionar una clave maestra del cliente (CMK) en la consola de KMS, además de otorgar los permisos necesarios.

Casos de uso:

  • Su organización tiene requisitos estrictos de seguridad y cumplimiento que exigen claves de cifrado autogestionadas.

  • Desea gestionar y rotar proactivamente las claves de cifrado para cumplir con estándares de seguridad más altos.

  • Requiere la capacidad de rotar o eliminar rápidamente una clave para proteger sus datos si esta se ve comprometida o surgen otros riesgos de seguridad.

Usuarios objetivo:

Grandes empresas o instituciones financieras con requisitos estrictos de protección de datos y cumplimiento normativo. Estas organizaciones necesitan implementar sus propias políticas de gestión de claves y cuentan con equipos dedicados para administrarlas.

Importante

Si se elimina o deshabilita su clave maestra del cliente (CMK), la clave BYOK asociada deja de ser válida y todas las solicitudes de lectura y escritura al logstore fallarán.

Limitaciones

Una vez que seleccione un mecanismo de cifrado, no podrá cambiarlo ni modificar el algoritmo o tipo de cifrado. Solo puede usar el parámetro enable para habilitar o deshabilitar la función de cifrado. Cuando actualice el logstore, deberá incluir el parámetro encrypt_conf completo en cada solicitud.

Por ejemplo, si primero elige cifrar los datos mediante una clave de servicio, no podrá cambiar después al método Bring Your Own Key (BYOK).

Cifrar datos con una clave de servicio

Para configurar el cifrado de datos, incluya el parámetro encrypt_conf cuando llame a la API CreateLogStore o UpdateLogStore.

La estructura de datos del campo encrypt_conf se describe en la siguiente tabla. El campo user_cmk_info no es obligatorio.

Parámetro

Tipo

Descripción

Ejemplo

object

La configuración de cifrado.

enable

boolean

Indica si se debe habilitar el cifrado de datos. Valores válidos:

  • true

  • false

true

encrypt_type

string

El algoritmo de cifrado. Valores válidos: default y sm4. Es obligatorio cuando enable se establece en true.

default

user_cmk_info EncryptUserCmkConf

Opcional. Si se especifica, se utiliza la clave bring-your-own-key (BYOK). De lo contrario, se usa la clave de servicio de Simple Log Service.

{ "cmk_key_id" : "f5136b95-2420-ab31-xxxxxxxxx" "arn" : "acs:ram::13234:role/logsource" "region_id" : "cn-hangzhou" }

Cifrar datos con BYOK

Requisitos previos

Key Management Service (KMS) debe estar activado. Para obtener más información, consulte Purchase a Dedicated KMS instance.

Paso 1: Otorgar permisos de BYOK

Antes de usar el método BYOK, debe otorgar los permisos necesarios de Resource Access Management (RAM).

  1. Inicie sesión en la consola de RAM.

  2. Create a RAM role for a trusted Alibaba Cloud service con las siguientes configuraciones:

    En Role Type, seleccione common service role. En Role Name, introduzca KMS-TEST. En Select Trusted Service, seleccione Simple Log Service.

  3. Otorgue los permisos AliyunKMSReadOnlyAccess y AliyunKMSCryptoUserAccess al rol de RAM. Para obtener más información, consulte Grant permissions to a RAM role.

  4. Otorgue el permiso ram:PassRole. Puede omitir este paso si usa su cuenta de Alibaba Cloud para configurar el cifrado BYOK. Si usa un usuario de RAM, debe create a custom policy y luego grant permissions to the RAM user.

    El valor Resource de la siguiente política debe reemplazarse con el ARN del rol de RAM creado en Step 2. Para obtener más información sobre cómo consultar el ARN de un rol de RAM, consulte How do I view the ARN of a RAM role?.

    {
        "Version": "1",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": "ram:PassRole",
                "Resource": "acs:ram::<account-id>:role/<role-name>"  
            }
        ]
    }

Paso 2: Configurar el cifrado de datos

Importante

Una vez que configure el cifrado de datos, no podrá modificar el algoritmo ni el tipo de cifrado. Solo puede usar el parámetro enable para habilitar o deshabilitar la función de cifrado. Cuando actualice el logstore, deberá incluir el parámetro encrypt_conf completo en cada solicitud.

Para un logstore existente, llame a la API UpdateLogStore e incluya el parámetro encrypt_conf para configurar el cifrado de datos.

Antes de llamar a UpdateLogStore, primero debe recuperar la configuración actual del logstore mediante GetLogStore. Después, modifique la configuración y pásela en la solicitud UpdateLogStore.

La siguiente tabla describe la estructura de datos del parámetro encrypt_conf. Para usar BYOK, debe especificar el parámetro user_cmk_info.

Parámetro

Tipo

Descripción

Ejemplo

object

La configuración de cifrado.

enable

boolean

Indica si se debe habilitar el cifrado de datos. Valores válidos:

  • true

  • false

true

encrypt_type

string

El algoritmo de cifrado. Valores válidos: default y sm4. Es obligatorio cuando enable se establece en true.

default

user_cmk_info EncryptUserCmkConf

Opcional. Si se especifica, se utiliza la clave bring-your-own-key (BYOK). De lo contrario, se usa la clave de servicio de Simple Log Service.

{ "cmk_key_id" : "f5136b95-2420-ab31-xxxxxxxxx" "arn" : "acs:ram::13234:role/logsource" "region_id" : "cn-hangzhou" }

Estructura de datos EncryptUserCmkConf

Parámetro

Tipo

Descripción

Ejemplo

object

La estructura de datos para la configuración de cifrado gestionada por el usuario.

cmk_key_id

string

El ID de la clave maestra del cliente (CMK) para BYOK.

f5136b95-2420-ab31-xxxxxxxxx

arn

string

El ARN del rol de RAM que creó en Step 1.

acs:ram::13234:role/logsource

region_id

string

El ID de la región donde se encuentra la CMK.

cn-hangzhou

encrypt_conf = {
    "enable" : true,                 # Specifies whether to enable encryption.
    "encrypt_type" : "default",      # The encryption algorithm. Supported values: default, m4, sm4_ecb, sm4_cbc, sm4_gcm, aes_ecb, aes_cbc, aes_cfb, aes_ofb, and aes_gcm.
    "user_cmk_info" :                # Optional. If you specify this parameter, BYOK is used. Otherwise, a service key is used.
    {
          "cmk_key_id" : "",         # The ID of the CMK for BYOK. Example: f5136b95-2420-ab31-xxxxxxxxx.
          "arn" :  "",               # The ARN of the RAM role that you created in Step 1.
          "region_id" : ""           # The region ID where the CMK is located.
    }
}

Documentos relacionados

Para obtener más información, consulte las siguientes operaciones de API: