El SDK de Alibaba Cloud admite operaciones de gestión (creación de instancias y claves) y operaciones de negocio (cifrado, descifrado y recuperación de secretos) para KMS. Las operaciones de gestión usan únicamente el gateway compartido, mientras que las operaciones de negocio son compatibles tanto con el gateway compartido como con el dedicado.
Descripción general del acceso
Las operaciones de gestión solo se pueden acceder a través del gateway compartido. Las operaciones de negocio admiten tanto el gateway compartido como el dedicado.
Gateway compartido frente a gateway dedicado
A continuación se comparan los gateways compartido y dedicado para las operaciones de negocio de KMS.
Elemento | Gateway compartido | Gateway dedicado | |
Red | Red pública o red VPC. | Red privada de KMS. | |
Rendimiento | Las solicitudes de API están sujetas a cuotas por segundo. Ejemplo: el QPS de cifrado y descifrado es fijo en 1,000. | No existe cuota por solicitud. Las solicitudes se procesan en modo best-effort con todos los recursos de cómputo y almacenamiento disponibles. Usted selecciona la capacidad de QPS al comprar una instancia de KMS. | |
API compatibles | Todas las operaciones criptográficas y las API de recuperación de secretos. | Todas las operaciones criptográficas y las API de recuperación de secretos, excepto ReEncrypt. | |
Control de acceso a la red | Admite el ID de VPC (clave de condición: acs:SourceVpc) y las direcciones IP de VPC (clave de condición: acs:VpcSourceIp) para el control de acceso a la red. | No admite el ID de VPC (clave de condición: acs:SourceVpc) ni las direcciones IP de origen dentro de una VPC (clave de condición: acs:VpcSourceIp) para el control de acceso a la red. Si requiere esta función, comuníquese con su administrador de cuenta. | |
Autorización | Con la autenticación STS, la autorización aplica solo a GetSecretValue y no a Decrypt. Otros métodos de autenticación autorizan ambas operaciones. |
Tanto GetSecretValue como Decrypt se autorizan durante la recuperación del secreto. | |
Auditoría de registros | ActionTrail | Simple Log Service (SLS) | |
Configuraciones del SDK | Endpoint | Durante la inicialización del cliente, configure el shared gateway endpoint en uno de los siguientes formatos:
| Durante la inicialización del cliente, configure el dedicated gateway endpoint con el formato: |
Certificado de CA | No es obligatorio. |
| |
API compatibles
Las operaciones de gestión usan únicamente el gateway compartido. Las operaciones de negocio admiten tanto el gateway compartido como el dedicado.
Operaciones de gestión
Gestión del servicio
|
API |
Título |
Descripción |
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
Gestión de instancias
|
API |
Título |
Descripción |
|
DescribeAccountKmsStatus |
Consulta el estado de Key Management Service (KMS) en su cuenta de Alibaba Cloud. |
|
|
OpenKmsService |
Activa Key Management Service (KMS) para su cuenta de Alibaba Cloud. |
Gestión de claves
|
API |
Título |
Descripción |
|
CreateKey |
Crea una clave maestra del cliente (CMK) para cifrado de sobre, firmas digitales u otras operaciones criptográficas. |
|
|
ListKeys |
Consulta los ID y ARN de todas las CMK en la región actual. |
|
|
DescribeKey |
Consulta los metadatos de una CMK, como el estado de la clave, el uso y la configuración de rotación. |
|
|
UpdateKeyDescription |
Actualiza la descripción de una CMK. |
|
|
EnableKey |
Habilita una clave para cifrar y descifrar datos. |
|
|
DisableKey |
Deshabilita una clave. |
|
|
CreateAlias |
Crea un alias para una clave. |
|
|
ListAliases |
Consulta todos los alias de la región actual para la cuenta actual. |
|
|
ListAliasesByKeyId |
Consulta todos los alias vinculados a una clave. |
|
|
DeleteAlias |
Elimina un alias. |
|
|
UpdateAlias |
Vincula un alias existente a un ID de clave maestra del cliente (CMK) diferente. |
|
|
GetParametersForImport |
Consulta los parámetros que se utilizan para importar material de clave a una clave maestra del cliente (CMK). |
|
|
ImportKeyMaterial |
Importa material de clave generado externamente a una CMK cuyo origen es EXTERNAL. |
|
|
DeleteKeyMaterial |
Elimina el material de clave importado de una CMK. Después de la eliminación, la CMK entra en el estado PendingImport hasta que vuelva a importar el material de clave. |
|
|
ScheduleKeyDeletion |
Elimina una clave maestra del cliente (CMK) específica. |
|
|
CancelKeyDeletion |
Cancela la tarea de eliminación de una CMK. |
|
|
SetDeletionProtection |
Habilita o deshabilita la protección contra eliminación para una clave maestra del cliente (CMK). |
|
|
UpdateRotationPolicy |
Actualiza la directiva de rotación automática de una CMK. |
|
|
DescribeKeyVersion |
Consulta los metadatos de una versión específica de CMK. |
|
|
CreateKeyVersion |
Crea una versión para una clave maestra del cliente (CMK). |
|
|
ListKeyVersions |
Consulta todas las versiones de una CMK específica. |
|
|
SetKeyPolicy |
Establece la directiva de clave para una CMK en una instancia de KMS. |
|
|
GetKeyPolicy |
Consulta la directiva de clave de una CMK en una instancia de KMS. |
Gestión de secretos
|
API |
Título |
Descripción |
|
ListSecrets |
Consulta todos los secretos de la región actual. |
|
|
DeleteSecret |
Elimina un secreto. |
|
|
CreateSecret |
Crea un secreto y almacena su versión inicial. |
|
|
UpdateSecret |
Actualiza los metadatos de un secreto. |
|
|
UpdateSecretVersionStage |
Mueve una etiqueta de etapa de versión a otra versión de un secreto. |
|
|
UpdateSecretRotationPolicy |
Actualiza la directiva de rotación de un secreto. |
|
|
DescribeSecret |
Consulta los metadatos de un secreto. |
|
|
ListSecretVersionIds |
Consulta todos los ID de versión y las etiquetas de etapa de un secreto específico. |
|
|
GetRandomPassword |
Genera una cadena de contraseña aleatoria. |
|
|
PutSecretValue |
Almacena una nueva versión del valor de un secreto genérico. |
|
|
RestoreSecret |
Restaura un secreto eliminado. |
|
|
RotateSecret |
Rota un secreto de inmediato. |
|
|
SetSecretPolicy |
Establece la directiva de acceso para un secreto en una instancia de KMS. |
|
|
GetSecretPolicy |
Consulta la directiva de acceso de un secreto específico en una instancia de KMS. |
Gestión de etiquetas
|
API |
Título |
Descripción |
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
Gestión de aplicaciones
|
API |
Título |
Descripción |
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
|
|
DeleteClientKey |
Deletes a client key. |
Operaciones de negocio-Operaciones criptográficas
Para ejecutar operaciones criptográficas a través del gateway compartido, primero debe enable public access.
|
API |
Descripción |
Gateway compartido |
Gateway dedicado |
|
Genera una clave de datos aleatoria para el cifrado de sobre. La clave de datos se devuelve tanto en texto plano como en texto cifrado. |
|
|
|
|
Genera una clave de datos aleatoria, la cifra mediante una CMK y una clave pública que usted especifique, y devuelve ambos textos cifrados. |
|
|
|
|
Cifra texto plano mediante una CMK simétrica. |
|
|
|
|
Descifra texto cifrado que se generó con una CMK. |
|
|
|
|
Vuelve a cifrar texto cifrado con otra CMK sin exponer el texto plano. |
|
|
|
|
Exporta una clave de datos cifrada por una CMK. La clave de datos se vuelve a cifrar con una clave pública que usted especifique para garantizar una transmisión segura. |
|
|
|
|
Genera una clave de datos aleatoria solo en formato de texto cifrado, sin la copia en texto plano. |
|
|
|
|
Genera una firma digital mediante una CMK asimétrica. |
|
|
|
|
Verifica una firma digital mediante la clave pública de una CMK asimétrica. |
|
|
|
|
Cifra datos mediante la clave pública de una CMK asimétrica. |
|
|
|
|
Descifra datos mediante la clave privada de una CMK asimétrica. |
|
|
|
|
Recupera la clave pública de una clave asimétrica. Puede usar la clave pública para cifrar datos o verificar una firma en su dispositivo. |
|
|
Operaciones de negocio: Recuperación de valores de secretos
|
API |
Descripción |
Gateway compartido |
Gateway dedicado |
|
Recupera el valor de un secreto. |
|
|
Lenguajes de programación compatibles
A continuación se muestran los enlaces de descarga del SDK y la documentación para cada lenguaje compatible.