crypto.py 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405
  1. # -*- coding: utf-8 -*-
  2. """
  3. oss2.encryption
  4. ~~~~~~~~~~~~~~
  5. 该模块包含了客户端加解密相关的函数和类。
  6. """
  7. import abc
  8. import hashlib
  9. import json
  10. import os
  11. import copy
  12. import logging
  13. import struct
  14. from functools import partial
  15. import six
  16. from Crypto.Cipher import PKCS1_OAEP, PKCS1_v1_5
  17. from Crypto.PublicKey import RSA
  18. from aliyunsdkcore import client
  19. from aliyunsdkcore.acs_exception.exceptions import ServerException, ClientException
  20. from aliyunsdkcore.http import format_type, method_type
  21. from aliyunsdkkms.request.v20160120 import GenerateDataKeyRequest, DecryptRequest, EncryptRequest
  22. from . import models
  23. from . import headers
  24. from . import utils
  25. from .utils import b64decode_from_string, b64encode_as_string
  26. from .compat import to_bytes, to_unicode
  27. from .exceptions import ClientError, OpenApiFormatError, OpenApiServerError
  28. logger = logging.getLogger(__name__)
  29. class EncryptionMaterials(object):
  30. def __init__(self, desc, key_pair=None, custom_master_key_id=None, passphrase=None):
  31. self.desc = {}
  32. if desc:
  33. if isinstance(desc, dict):
  34. self.desc = desc
  35. else:
  36. raise ClientError('Invalid type, the type of mat_desc must be dict!')
  37. if key_pair and custom_master_key_id:
  38. raise ClientError('Both key_pair and custom_master_key_id are not none')
  39. if key_pair and not isinstance(key_pair, dict):
  40. raise ClientError('Invalid type, the type of key_pair must be dict!')
  41. self.key_pair = key_pair
  42. self.custom_master_key_id = custom_master_key_id
  43. self.passphrase = passphrase
  44. def add_description(self, key, value):
  45. self.desc[key] = value
  46. def add_descriptions(self, descriptions):
  47. for key in descriptions:
  48. self.desc[key] = descriptions[key]
  49. @six.add_metaclass(abc.ABCMeta)
  50. class BaseCryptoProvider(object):
  51. """CryptoProvider 基类,提供基础的数据加密解密adapter
  52. """
  53. def __init__(self, cipher, mat_desc=None):
  54. if not cipher:
  55. raise ClientError('Please initialize the value of cipher!')
  56. self.cipher = cipher
  57. self.cek_alg = None
  58. self.wrap_alg = None
  59. self.mat_desc = None
  60. self.encryption_materials_dict = {}
  61. if mat_desc:
  62. if isinstance(mat_desc, dict):
  63. self.mat_desc = mat_desc
  64. else:
  65. raise ClientError('Invalid type, the type of mat_desc must be dict!')
  66. @abc.abstractmethod
  67. def get_key(self):
  68. pass
  69. def get_iv(self):
  70. return self.cipher.get_iv()
  71. @staticmethod
  72. def make_encrypt_adapter(stream, cipher):
  73. return utils.make_cipher_adapter(stream, partial(cipher.encrypt))
  74. @staticmethod
  75. def make_decrypt_adapter(stream, cipher, discard=0):
  76. return utils.make_cipher_adapter(stream, partial(cipher.decrypt), discard)
  77. @abc.abstractmethod
  78. def decrypt_encrypted_key(self, encrypted_key):
  79. pass
  80. @abc.abstractmethod
  81. def decrypt_encrypted_iv(self, encrypted_iv):
  82. pass
  83. @abc.abstractmethod
  84. def reset_encryption_materials(self, encryption_materials):
  85. pass
  86. def adjust_range(self, start, end):
  87. return self.cipher.adjust_range(start, end)
  88. @abc.abstractmethod
  89. def create_content_material(self):
  90. pass
  91. def add_encryption_materials(self, encryption_materials):
  92. if encryption_materials.desc:
  93. key = frozenset(encryption_materials.desc.items())
  94. self.encryption_materials_dict[key] = encryption_materials
  95. def get_encryption_materials(self, desc):
  96. if desc:
  97. key = frozenset(desc.items())
  98. if key in self.encryption_materials_dict.keys():
  99. return self.encryption_materials_dict[key]
  100. _LOCAL_RSA_TMP_DIR = '.oss-local-rsa'
  101. @six.add_metaclass(abc.ABCMeta)
  102. class LocalRsaProvider(BaseCryptoProvider):
  103. """使用本地RSA加密数据密钥。
  104. :param str dir: 本地RSA公钥私钥存储路径
  105. :param str key: 本地RSA公钥私钥名称前缀
  106. :param str passphrase: 本地RSA公钥私钥密码
  107. :param class cipher: 数据加密,默认aes256,用户可自行实现对称加密算法,需符合AESCipher注释规则
  108. """
  109. DEFAULT_PUB_KEY_SUFFIX = '.public_key.pem'
  110. DEFAULT_PRIV_KEY_SUFFIX = '.private_key.pem'
  111. def __init__(self, dir=None, key='', passphrase=None, cipher=utils.AESCTRCipher(),
  112. pub_key_suffix=DEFAULT_PUB_KEY_SUFFIX, private_key_suffix=DEFAULT_PRIV_KEY_SUFFIX):
  113. super(LocalRsaProvider, self).__init__(cipher=cipher)
  114. self.wrap_alg = headers.RSA_NONE_OAEPWithSHA1AndMGF1Padding
  115. keys_dir = dir or os.path.join(os.path.expanduser('~'), _LOCAL_RSA_TMP_DIR)
  116. priv_key_path = os.path.join(keys_dir, key + private_key_suffix)
  117. pub_key_path = os.path.join(keys_dir, key + pub_key_suffix)
  118. try:
  119. if os.path.exists(priv_key_path) and os.path.exists(pub_key_path):
  120. with open(priv_key_path, 'rb') as f:
  121. self.__decrypt_obj = PKCS1_OAEP.new(RSA.importKey(f.read(), passphrase=passphrase))
  122. with open(pub_key_path, 'rb') as f:
  123. self.__encrypt_obj = PKCS1_OAEP.new(RSA.importKey(f.read(), passphrase=passphrase))
  124. else:
  125. logger.warn('The file path of private key or public key is not exist, will generate key pair')
  126. private_key = RSA.generate(2048)
  127. public_key = private_key.publickey()
  128. self.__encrypt_obj = PKCS1_OAEP.new(public_key)
  129. self.__decrypt_obj = PKCS1_OAEP.new(private_key)
  130. utils.makedir_p(keys_dir)
  131. with open(priv_key_path, 'wb') as f:
  132. f.write(private_key.exportKey(passphrase=passphrase))
  133. with open(pub_key_path, 'wb') as f:
  134. f.write(public_key.exportKey(passphrase=passphrase))
  135. except (ValueError, TypeError, IndexError) as e:
  136. raise ClientError(str(e))
  137. def get_key(self):
  138. return self.cipher.get_key()
  139. def decrypt_encrypted_key(self, encrypted_key):
  140. try:
  141. return self.__decrypt_data(encrypted_key)
  142. except (TypeError, ValueError) as e:
  143. raise ClientError(str(e))
  144. def decrypt_encrypted_iv(self, encrypted_iv):
  145. try:
  146. return self.__decrypt_data(encrypted_iv)
  147. except (TypeError, ValueError) as e:
  148. raise ClientError(str(e))
  149. def reset_encryption_materials(self, encryption_materials):
  150. raise ClientError("do not support reset_encryption_materials!")
  151. def create_content_material(self):
  152. plain_key = self.get_key()
  153. encrypted_key = self.__encrypt_data(plain_key)
  154. plain_iv = self.get_iv()
  155. encrypted_iv = self.__encrypt_data(plain_iv)
  156. cipher = copy.copy(self.cipher)
  157. wrap_alg = self.wrap_alg
  158. mat_desc = self.mat_desc
  159. cipher.initialize(plain_key, plain_iv)
  160. content_crypto_material = models.ContentCryptoMaterial(cipher, wrap_alg, encrypted_key, encrypted_iv,
  161. mat_desc)
  162. return content_crypto_material
  163. def __encrypt_data(self, data):
  164. return self.__encrypt_obj.encrypt(data)
  165. def __decrypt_data(self, data):
  166. return self.__decrypt_obj.decrypt(data)
  167. @six.add_metaclass(abc.ABCMeta)
  168. class RsaProvider(BaseCryptoProvider):
  169. """使用本地RSA加密数据密钥。
  170. :param str dir: 本地RSA公钥私钥存储路径
  171. :param str key: 本地RSA公钥私钥名称前缀
  172. :param str passphrase: 本地RSA公钥私钥密码
  173. :param class cipher: 数据加密,默认aes256,用户可自行实现对称加密算法,需符合AESCipher注释规则
  174. """
  175. def __init__(self, key_pair, passphrase=None, cipher=utils.AESCTRCipher(), mat_desc=None):
  176. super(RsaProvider, self).__init__(cipher=cipher, mat_desc=mat_desc)
  177. self.wrap_alg = headers.RSA_NONE_PKCS1Padding_WRAP_ALGORITHM
  178. if key_pair and not isinstance(key_pair, dict):
  179. raise ClientError('Invalid type, the type of key_pair must be dict!')
  180. try:
  181. if 'public_key' in key_pair:
  182. self.__encrypt_obj = PKCS1_v1_5.new(RSA.importKey(key_pair['public_key'], passphrase=passphrase))
  183. if 'private_key' in key_pair:
  184. self.__decrypt_obj = PKCS1_v1_5.new(RSA.importKey(key_pair['private_key'], passphrase=passphrase))
  185. except (ValueError, TypeError) as e:
  186. raise ClientError(str(e))
  187. def get_key(self):
  188. return self.cipher.get_key()
  189. def decrypt_encrypted_key(self, encrypted_key):
  190. try:
  191. return self.__decrypt_data(encrypted_key)
  192. except (TypeError, ValueError) as e:
  193. raise ClientError(str(e))
  194. def decrypt_encrypted_iv(self, encrypted_iv):
  195. try:
  196. return self.__decrypt_data(encrypted_iv)
  197. except (TypeError, ValueError) as e:
  198. raise ClientError(str(e))
  199. def reset_encryption_materials(self, encryption_materials):
  200. return RsaProvider(encryption_materials.key_pair, encryption_materials.passphrase, self.cipher,
  201. encryption_materials.desc)
  202. def create_content_material(self):
  203. plain_key = self.get_key()
  204. encrypted_key = self.__encrypt_data(plain_key)
  205. plain_iv = self.get_iv()
  206. encrypted_iv = self.__encrypt_data(plain_iv)
  207. cipher = copy.copy(self.cipher)
  208. wrap_alg = self.wrap_alg
  209. mat_desc = self.mat_desc
  210. cipher.initialize(plain_key, plain_iv)
  211. content_crypto_material = models.ContentCryptoMaterial(cipher, wrap_alg, encrypted_key, encrypted_iv,
  212. mat_desc)
  213. return content_crypto_material
  214. def __encrypt_data(self, data):
  215. return self.__encrypt_obj.encrypt(data)
  216. def __decrypt_data(self, data):
  217. decrypted_data = self.__decrypt_obj.decrypt(data, object)
  218. if decrypted_data == object:
  219. raise ClientError('Decrypted data error, please check you key pair!')
  220. return decrypted_data
  221. class AliKMSProvider(BaseCryptoProvider):
  222. """使用aliyun kms服务加密数据密钥。kms的详细说明参见
  223. https://help.aliyun.com/product/28933.html?spm=a2c4g.11186623.3.1.jlYT4v
  224. 此接口在py3.3下暂时不可用,详见
  225. https://github.com/aliyun/aliyun-openapi-python-sdk/issues/61
  226. :param str access_key_id: 可以访问kms密钥服务的access_key_id
  227. :param str access_key_secret: 可以访问kms密钥服务的access_key_secret
  228. :param str region: kms密钥服务地区
  229. :param str cmkey: 用户主密钥
  230. :param str sts_token: security token,如果使用的是临时AK需提供
  231. :param str passphrase: kms密钥服务密码
  232. :param class cipher: 数据加密,默认aes256,当前仅支持默认实现
  233. """
  234. def __init__(self, access_key_id, access_key_secret, region, cmk_id, sts_token=None, passphrase=None,
  235. cipher=utils.AESCTRCipher(), mat_desc=None):
  236. super(AliKMSProvider, self).__init__(cipher=cipher, mat_desc=mat_desc)
  237. if not isinstance(cipher, utils.AESCTRCipher):
  238. raise ClientError('AliKMSProvider only support AES256 cipher now')
  239. self.wrap_alg = headers.KMS_ALI_WRAP_ALGORITHM
  240. self.custom_master_key_id = cmk_id
  241. self.sts_token = sts_token
  242. self.context = '{"x-passphrase":"' + passphrase + '"}' if passphrase else ''
  243. self.kms_client = client.AcsClient(access_key_id, access_key_secret, region)
  244. def get_key(self):
  245. plain_key, encrypted_key = self.__generate_data_key()
  246. return plain_key, encrypted_key
  247. def decrypt_encrypted_key(self, encrypted_key):
  248. return b64decode_from_string(self.__decrypt_data(encrypted_key))
  249. def decrypt_encrypted_iv(self, encrypted_iv, deprecated=False):
  250. if deprecated:
  251. return self.__decrypt_data(encrypted_iv)
  252. return b64decode_from_string(self.__decrypt_data(encrypted_iv))
  253. def reset_encryption_materials(self, encryption_materials):
  254. provider = copy.copy(self)
  255. provider.custom_master_key_id = encryption_materials.custom_master_key_id
  256. provider.context = '{"x-passphrase":"' + encryption_materials.passphrase + '"}' if encryption_materials.passphrase else ''
  257. provider.mat_desc = encryption_materials.desc
  258. return provider
  259. def create_content_material(self):
  260. plain_key, encrypted_key = self.get_key()
  261. plain_iv = self.get_iv()
  262. encrypted_iv = self.__encrypt_data(b64encode_as_string(plain_iv))
  263. cipher = copy.copy(self.cipher)
  264. wrap_alg = self.wrap_alg
  265. mat_desc = self.mat_desc
  266. cipher.initialize(plain_key, plain_iv)
  267. content_crypto_material = models.ContentCryptoMaterial(cipher, wrap_alg, encrypted_key, encrypted_iv,
  268. mat_desc)
  269. return content_crypto_material
  270. def __generate_data_key(self):
  271. req = GenerateDataKeyRequest.GenerateDataKeyRequest()
  272. req.set_accept_format(format_type.JSON)
  273. req.set_method(method_type.POST)
  274. req.set_KeyId(self.custom_master_key_id)
  275. req.set_KeySpec('AES_256')
  276. req.set_NumberOfBytes(32)
  277. req.set_EncryptionContext(self.context)
  278. if self.sts_token:
  279. req.set_STSToken(self.sts_token)
  280. resp = self.__do(req)
  281. return b64decode_from_string(resp['Plaintext']), resp['CiphertextBlob']
  282. def __encrypt_data(self, data):
  283. req = EncryptRequest.EncryptRequest()
  284. req.set_accept_format(format_type.JSON)
  285. req.set_method(method_type.POST)
  286. req.set_KeyId(self.custom_master_key_id)
  287. req.set_Plaintext(data)
  288. req.set_EncryptionContext(self.context)
  289. if self.sts_token:
  290. req.set_STSToken(self.sts_token)
  291. resp = self.__do(req)
  292. return resp['CiphertextBlob']
  293. def __decrypt_data(self, data):
  294. req = DecryptRequest.DecryptRequest()
  295. req.set_accept_format(format_type.JSON)
  296. req.set_method(method_type.POST)
  297. req.set_CiphertextBlob(data)
  298. req.set_EncryptionContext(self.context)
  299. if self.sts_token:
  300. req.set_STSToken(self.sts_token)
  301. resp = self.__do(req)
  302. return resp['Plaintext']
  303. def __do(self, req):
  304. try:
  305. body = self.kms_client.do_action_with_exception(req)
  306. return json.loads(to_unicode(body))
  307. except ServerException as e:
  308. raise OpenApiServerError(e.http_status, e.request_id, e.message, e.error_code)
  309. except ClientException as e:
  310. raise ClientError(e.message)
  311. except (KeyError, ValueError, TypeError) as e:
  312. raise OpenApiFormatError('Json Error: ' + str(e))