阿里云用户在云上部署IT资产,需要对敏感数据进行加密保护。如果被加密的数据对象较小(小于6KB),则可以通过密钥管理服务(Key Management Service,简称:KMS)的密码运算API,在线对数据直接加解密。
典型的场景包括(但不限于):
对配置文件的加密
对SSL私钥的加密
本文以加密SSL证书私钥为例,介绍如何调用KMS API实现对数据的在线加密、解密。
用户的数据会通过安全信道传递到KMS服务端,服务端完成加密、解密后,操作结果通过安全信道返回给用户。具体架构如下图所示:
操作流程如下:
通过
KMS控制台
或者调用CreateKey接口,创建一个用户主密钥。具体操作请参见
创建用户主密钥
。
调用KMS服务的Encrypt接口,将明文证书加密为密文证书。具体操作请参见
加密证书私钥
。
将密文证书部署在云服务器上。
当服务器启动需要使用证书时,调用KMS服务的Decrypt接口将密文证书解密为明文证书。具体操作请参见
解密证书私钥
。
"CreationDate": "2019-04-08T07:45:54Z",
"Description": "",
"KeyId": "1234abcd-12ab-34cd-56ef-12345678****",
"KeyState": "Enabled",
"KeyUsage": "ENCRYPT/DECRYPT",
"DeleteDate": "",
"Creator": "111122223333",
"Arn": "acs:kms:cn-hangzhou:111122223333:key/1234abcd-12ab-34cd-56ef-12345678****",
"Origin": "Aliyun_KMS",
"MaterialExpireTime": ""
"RequestId": "2a37b168-9fa0-4d71-aba4-2077dd9e80df"
可选:
给主密钥添加别名。
别名是用户主密钥的可选标识。如果用户不创建别名,也可以直接使用密钥的ID。
$ aliyun kms CreateAlias --AliasName alias/Apollo/WorkKey --KeyId 1234abcd-12ab-34cd-56ef-12345678****
说明
其中,
Apollo/WorkKey
表示Apollo项目中的工作密钥(当前被用于加密的密钥),并在后续示例代码中使用此别名。即表示应用可以使用
alias/Apollo/WorkKey
调用加密API。
from aliyunsdkcore import client
from aliyunsdkkms.request.v20160120 import EncryptRequest
from aliyunsdkkms.request.v20160120 import DecryptRequest
def KmsEncrypt(acsClient, plaintext, key_alias):
request = EncryptRequest.EncryptRequest()
request.set_accept_format('JSON')
request.set_KeyId(key_alias)
request.set_Plaintext(plaintext)
response = json.loads(acsClient.do_action(request))
return response.get("CiphertextBlob")
def ReadTextFile(in_file):
file = open(in_file, 'r')
content = file.read()
file.close()
return content
def WriteTextFile(out_file, content):
file = open(out_file, 'w')
file.write(content)
file.close()
acsClient = client.AcsClient('<Access-Key-Id>','Access-Key-Secret','<Region-Id>')
key_alias = 'alias/Apollo/WorkKey'
in_file = './certs/key.pem'
out_file = './certs/key.pem.cipher'
# Read private key file in text mode
in_content = ReadTextFile(in_file)
# Encrypt
ciphertext = KmsEncrypt(acsClient, in_content, key_alias)
# Write encrypted key file in text mode
WriteTextFile(out_file, ciphertext)
解密证书私钥(业务系统对部署在云上的密文证书私钥进行解密)。
示例代码中:
部署的密文证书文件:
./certs/key.pem.cipher
输出的明文证书文件:
./certs/decrypted_key.pem
#!/usr/bin/env python
#coding=utf-8
import json
from aliyunsdkcore import client
from aliyunsdkkms.request.v20160120 import EncryptRequest
from aliyunsdkkms.request.v20160120 import DecryptRequest
def KmsDecrypt(client, ciphertext):
request = DecryptRequest.DecryptRequest()
request.set_accept_format('JSON')
request.set_CiphertextBlob(ciphertext)
response = json.loads(clt.do_action(request))
return response.get("Plaintext")
def ReadTextFile(in_file):
file = open(in_file, 'r')
content = file.read()
file.close()
return content
def WriteTextFile(out_file, content):
file = open(out_file, 'w')
file.write(content)
file.close()
clt = client.AcsClient('<Access-Key-Id>','Access-Key-Secret','<Region-Id>')
in_file = './certs/key.pem.cipher'
out_file = './certs/decrypted_key.pem'
# Read encrypted key file in text mode
in_content = ReadTextFile(in_file)
# Decrypt
ciphertext = KmsDecrypt(clt, in_content)
# Write Decrypted key file in text mode
WriteTextFile(out_file, ciphertext)