bk-crypto-python-sdk 1.1.0__tar.gz → 2.0.0__tar.gz

{bk-crypto-python-sdk-1.1.0 → bk_crypto_python_sdk-2.0.0}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.1
 Name: bk-crypto-python-sdk
-Version: 1.1.0
+Version: 2.0.0
 Summary: bk-crypto-python-sdk is a lightweight cryptography toolkit for Python applications based on Cryptodome / tongsuopy and other encryption libraries.
 Author: TencentBlueKing
 Author-email: contactus_bk@tencent.com
-Requires-Python: >=3.6.2,<3.11
+Requires-Python: >=3.8,<3.12
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Requires-Dist: dacite (>=1.8.1,<2.0.0)
 Requires-Dist: pycryptodomex (>=3.18.0,<4.0.0)
 Requires-Dist: tongsuopy-crayon (>=1.0.2b5,<2.0.0)
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 ---
 
-![Python](https://badgen.net/badge/python/%3E=3.6.2,%3C3.11/green?icon=github)
+![Python](https://badgen.net/badge/python/%3E=3.8,%3C3.12/green?icon=github)
 ![Django](https://badgen.net/badge/django/%3E=3.1.5,%3C=4.2.1/yellow?icon=github)
 [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE.txt)
 
@@ -60,22 +60,6 @@ $ pip install bk-crypto-python-sdk
 
 **非对称加密**
 
-```python
-import os
-
-from bkcrypto import constants
-from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
-from bkcrypto.contrib.basic.ciphers import get_symmetric_cipher
-
-symmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher(
-    cipher_type=constants.SymmetricCipherType.SM4.value,
-    common={"key": os.urandom(16)},
-)
-assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
-```
-
-**对称加密**
-
 ````python
 from bkcrypto import constants
 from bkcrypto.asymmetric import options
@@ -101,6 +85,22 @@ assert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))
 assert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))
 ````
 
+**对称加密**
+
+```python
+import os
+
+from bkcrypto import constants
+from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
+from bkcrypto.contrib.basic.ciphers import get_symmetric_cipher
+
+symmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher(
+    cipher_type=constants.SymmetricCipherType.SM4.value,
+    common={"key": os.urandom(16)},
+)
+assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
+```
+
 #### 2. 结合 Django 使用
 
 在 Django Settings 中配置加密算法类型
@@ -147,7 +147,7 @@ assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
 ```python
 from bkcrypto import constants
 from bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions
-from bkcrypto.asymmetric.options import RSAAsymmetricOptions
+from bkcrypto.asymmetric.options import RSAAsymmetricOptions, SM2AsymmetricOptions
 
 BKCRYPTO = {
     # 声明项目所使用的非对称加密算法
@@ -180,9 +180,9 @@ BKCRYPTO = {
             "common": {"public_key_string": "your key"},
             "cipher_options": {
                 constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(
-                    padding=constants.RSACipherPadding.PKCS1_OAEP
+                    padding=constants.RSACipherPadding.PKCS1_v1_5
                 ),
-                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()
+                constants.AsymmetricCipherType.SM2.value: SM2AsymmetricOptions()
             },
         },
     }
@@ -229,94 +229,6 @@ class IdentityData(models.Model):
     password = SymmetricTextField("密码", blank=True, null=True)
 ```
 
-#### 3. Using Django CipherManager
-
-Configure the encryption algorithm type in Django Settings
-
-```python
-from bkcrypto import constants
-from bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions
-from bkcrypto.asymmetric.options import RSAAsymmetricOptions
-
-BKCRYPTO = {
-    # Declare the asymmetric encryption algorithm used by the project
-    "ASYMMETRIC_CIPHER_TYPE": constants.AsymmetricCipherType.SM2.value,
-    # Declare the symmetric encryption algorithm used by the project
-    "SYMMETRIC_CIPHER_TYPE": constants.SymmetricCipherType.SM4.value,
-    "SYMMETRIC_CIPHERS": {
-        # default - The configured symmetric encryption instance can be configured with multiple instances depending on the project requirements
-        "default": {
-            # Optional, used in cases where settings cannot directly obtain the key
-            # "get_key_config": "apps.utils.encrypt.key.get_key_config",
-            # Optional, used for ModelField, encrypted with this prefix to store the database, decrypting and analyzing the prefix and selecting the appropriate decryption algorithm
-            # ⚠️ The prefix and cipher type must be in one-to-one correspondence, and there can be no prefix matching relationship
-            # "db_prefix_map": {
-            #     SymmetricCipherType.AES.value: "aes_str:::",
-            #     SymmetricCipherType.SM4.value: "sm4_str:::"
-            # },
-            # Common parameter configuration, sharing these parameters when initializing different ciphers
-            "common": {"key": "your key"},
-            "cipher_options": {
-                constants.SymmetricCipherType.AES.value: AESSymmetricOptions(key_size=16),
-                # Blue Whale recommended configuration
-                constants.SymmetricCipherType.SM4.value: SM4SymmetricOptions(mode=constants.SymmetricMode.CTR)
-            }
-        },
-    },
-    "ASYMMETRIC_CIPHERS": {
-        # Configuration same as SYMMETRIC_CIPHERS
-        "default": {
-            "common": {"public_key_string": "your key"},
-            "cipher_options": {
-                constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(
-                    padding=constants.RSACipherPadding.PKCS1_OAEP
-                ),
-                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()
-            },
-        },
-    }
-}
-```
-
-**Asymmetric Encryption**
-
-Use `asymmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.ASYMMETRIC_CIPHERS`
-
-```python
-from bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher
-from bkcrypto.contrib.django.ciphers import asymmetric_cipher_manager
-
-asymmetric_cipher: BaseAsymmetricCipher = asymmetric_cipher_manager.cipher(using="default")
-
-# Encrypt and Decrypt
-assert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))
-# Signature verification
-assert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))
-```
-
-**Symmetric Encryption**
-
-Use `symmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.SYMMETRIC_CIPHERS`
-
-```python
-from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
-from bkcrypto.contrib.django.ciphers import symmetric_cipher_manager
-
-# using - Specifies a symmetric encryption instance, defaults to 'default'
-symmetric_cipher: BaseSymmetricCipher = symmetric_cipher_manager.cipher(using="default")
-assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
-```
-
-**Django ModelField**
-
-```python
-from django.db import models
-from bkcrypto.contrib.django.fields import SymmetricTextField
-
-
-class IdentityData(models.Model):
-    password = SymmetricTextField("Password", blank=True, null=True)
-```
 
 ## Roadmap
 

{bk-crypto-python-sdk-1.1.0 → bk_crypto_python_sdk-2.0.0}/bkcrypto/contrib/django/ciphers.py

@@ -41,7 +41,7 @@ def get_symmetric_cipher(
     cipher_options: typing.Optional[typing.Dict[str, typing.Optional[SymmetricOptions]]] = None,
 ) -> BaseSymmetricCipher:
     return ciphers.get_symmetric_cipher(
-        cipher_type=cipher_type or crypto_settings.ASYMMETRIC_CIPHER_TYPE,
+        cipher_type=cipher_type or crypto_settings.SYMMETRIC_CIPHER_TYPE,
         common=common,
         cipher_options=cipher_options,
         symmetric_cipher_classes=crypto_settings.SYMMETRIC_CIPHER_CLASSES,

{bk-crypto-python-sdk-1.1.0 → bk_crypto_python_sdk-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "bk-crypto-python-sdk"
-version = "1.1.0"
+version = "2.0.0"
 description = "bk-crypto-python-sdk is a lightweight cryptography toolkit for Python applications based on Cryptodome / tongsuopy and other encryption libraries."
 authors = ["TencentBlueKing <contactus_bk@tencent.com>"]
 readme = "readme.md"
@@ -9,7 +9,7 @@ packages = [
 ]
 
 [tool.poetry.dependencies]
-python = ">=3.6.2,<3.11"
+python = ">=3.8,<3.12"
 tongsuopy-crayon = "^1.0.2b5"
 pycryptodomex = "^3.18.0"
 dacite = "^1.8.1"

{bk-crypto-python-sdk-1.1.0 → bk_crypto_python_sdk-2.0.0}/readme.md

@@ -2,7 +2,7 @@
 
 ---
 
-![Python](https://badgen.net/badge/python/%3E=3.6.2,%3C3.11/green?icon=github)
+![Python](https://badgen.net/badge/python/%3E=3.8,%3C3.12/green?icon=github)
 ![Django](https://badgen.net/badge/django/%3E=3.1.5,%3C=4.2.1/yellow?icon=github)
 [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE.txt)
 
@@ -42,22 +42,6 @@ $ pip install bk-crypto-python-sdk
 
 **非对称加密**
 
-```python
-import os
-
-from bkcrypto import constants
-from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
-from bkcrypto.contrib.basic.ciphers import get_symmetric_cipher
-
-symmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher(
-    cipher_type=constants.SymmetricCipherType.SM4.value,
-    common={"key": os.urandom(16)},
-)
-assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
-```
-
-**对称加密**
-
 ````python
 from bkcrypto import constants
 from bkcrypto.asymmetric import options
@@ -83,6 +67,22 @@ assert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))
 assert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))
 ````
 
+**对称加密**
+
+```python
+import os
+
+from bkcrypto import constants
+from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
+from bkcrypto.contrib.basic.ciphers import get_symmetric_cipher
+
+symmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher(
+    cipher_type=constants.SymmetricCipherType.SM4.value,
+    common={"key": os.urandom(16)},
+)
+assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
+```
+
 #### 2. 结合 Django 使用
 
 在 Django Settings 中配置加密算法类型
@@ -129,7 +129,7 @@ assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
 ```python
 from bkcrypto import constants
 from bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions
-from bkcrypto.asymmetric.options import RSAAsymmetricOptions
+from bkcrypto.asymmetric.options import RSAAsymmetricOptions, SM2AsymmetricOptions
 
 BKCRYPTO = {
     # 声明项目所使用的非对称加密算法
@@ -162,9 +162,9 @@ BKCRYPTO = {
             "common": {"public_key_string": "your key"},
             "cipher_options": {
                 constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(
-                    padding=constants.RSACipherPadding.PKCS1_OAEP
+                    padding=constants.RSACipherPadding.PKCS1_v1_5
                 ),
-                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()
+                constants.AsymmetricCipherType.SM2.value: SM2AsymmetricOptions()
             },
         },
     }
@@ -211,94 +211,6 @@ class IdentityData(models.Model):
     password = SymmetricTextField("密码", blank=True, null=True)
 ```
 
-#### 3. Using Django CipherManager
-
-Configure the encryption algorithm type in Django Settings
-
-```python
-from bkcrypto import constants
-from bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions
-from bkcrypto.asymmetric.options import RSAAsymmetricOptions
-
-BKCRYPTO = {
-    # Declare the asymmetric encryption algorithm used by the project
-    "ASYMMETRIC_CIPHER_TYPE": constants.AsymmetricCipherType.SM2.value,
-    # Declare the symmetric encryption algorithm used by the project
-    "SYMMETRIC_CIPHER_TYPE": constants.SymmetricCipherType.SM4.value,
-    "SYMMETRIC_CIPHERS": {
-        # default - The configured symmetric encryption instance can be configured with multiple instances depending on the project requirements
-        "default": {
-            # Optional, used in cases where settings cannot directly obtain the key
-            # "get_key_config": "apps.utils.encrypt.key.get_key_config",
-            # Optional, used for ModelField, encrypted with this prefix to store the database, decrypting and analyzing the prefix and selecting the appropriate decryption algorithm
-            # ⚠️ The prefix and cipher type must be in one-to-one correspondence, and there can be no prefix matching relationship
-            # "db_prefix_map": {
-            #     SymmetricCipherType.AES.value: "aes_str:::",
-            #     SymmetricCipherType.SM4.value: "sm4_str:::"
-            # },
-            # Common parameter configuration, sharing these parameters when initializing different ciphers
-            "common": {"key": "your key"},
-            "cipher_options": {
-                constants.SymmetricCipherType.AES.value: AESSymmetricOptions(key_size=16),
-                # Blue Whale recommended configuration
-                constants.SymmetricCipherType.SM4.value: SM4SymmetricOptions(mode=constants.SymmetricMode.CTR)
-            }
-        },
-    },
-    "ASYMMETRIC_CIPHERS": {
-        # Configuration same as SYMMETRIC_CIPHERS
-        "default": {
-            "common": {"public_key_string": "your key"},
-            "cipher_options": {
-                constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(
-                    padding=constants.RSACipherPadding.PKCS1_OAEP
-                ),
-                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()
-            },
-        },
-    }
-}
-```
-
-**Asymmetric Encryption**
-
-Use `asymmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.ASYMMETRIC_CIPHERS`
-
-```python
-from bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher
-from bkcrypto.contrib.django.ciphers import asymmetric_cipher_manager
-
-asymmetric_cipher: BaseAsymmetricCipher = asymmetric_cipher_manager.cipher(using="default")
-
-# Encrypt and Decrypt
-assert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))
-# Signature verification
-assert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))
-```
-
-**Symmetric Encryption**
-
-Use `symmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.SYMMETRIC_CIPHERS`
-
-```python
-from bkcrypto.symmetric.ciphers import BaseSymmetricCipher
-from bkcrypto.contrib.django.ciphers import symmetric_cipher_manager
-
-# using - Specifies a symmetric encryption instance, defaults to 'default'
-symmetric_cipher: BaseSymmetricCipher = symmetric_cipher_manager.cipher(using="default")
-assert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))
-```
-
-**Django ModelField**
-
-```python
-from django.db import models
-from bkcrypto.contrib.django.fields import SymmetricTextField
-
-
-class IdentityData(models.Model):
-    password = SymmetricTextField("Password", blank=True, null=True)
-```
 
 ## Roadmap
 

bk-crypto-python-sdk-1.1.0/setup.py

@@ -1,42 +0,0 @@
-# -*- coding: utf-8 -*-
-from setuptools import setup
-
-packages = \
-['bkcrypto',
- 'bkcrypto.asymmetric',
- 'bkcrypto.asymmetric.ciphers',
- 'bkcrypto.contrib',
- 'bkcrypto.contrib.basic',
- 'bkcrypto.contrib.django',
- 'bkcrypto.contrib.drf',
- 'bkcrypto.symmetric',
- 'bkcrypto.symmetric.ciphers',
- 'bkcrypto.utils']
-
-package_data = \
-{'': ['*']}
-
-install_requires = \
-['dacite>=1.8.1,<2.0.0',
- 'pycryptodomex>=3.18.0,<4.0.0',
- 'tongsuopy-crayon>=1.0.2b5,<2.0.0',
- 'wrapt>=1.15.0,<2.0.0']
-
-setup_kwargs = {
-    'name': 'bk-crypto-python-sdk',
-    'version': '1.1.0',
-    'description': 'bk-crypto-python-sdk is a lightweight cryptography toolkit for Python applications based on Cryptodome / tongsuopy and other encryption libraries.',
-    'long_description': '# BlueKing crypto-python-sdk\n\n---\n\n![Python](https://badgen.net/badge/python/%3E=3.6.2,%3C3.11/green?icon=github)\n![Django](https://badgen.net/badge/django/%3E=3.1.5,%3C=4.2.1/yellow?icon=github)\n[![License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE.txt)\n\n![Release](https://badgen.net/github/release/TencentBlueKing/crypto-python-sdk)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/TencentBlueKing/crypto-python-sdk/pulls)\n\n[![Publish to Pypi](https://github.com/TencentBlueKing/crypto-python-sdk/actions/workflows/release.yml/badge.svg)](https://github.com/TencentBlueKing/crypto-python-sdk/actions/workflows/release.yml)\n\n[(English Documents Available)](https://github.com/TencentBlueKing/crypto-python-sdk/blob/main/readme_en.md)\n\n## Overview\n\n️🔧 BlueKing crypto-python-sdk 是一个基于 pyCryptodome / tongsuopy 等加密库的轻量级密码学工具包，为 Python 应用统一的加解密实现，\n便于项目在不同的加密方式之间进行无侵入切换\n\n## Features\n\n* [Basic] 提供加密统一抽象层，对接 Cryptodome / tongsuopy 等加密库，提供统一的加解密实现\n* [Basic] 支持国际主流密码学算法：AES、RSA\n* [Basic] 支持中国商用密码学算法：SM2、SM4\n* [Basic] 非对称加密支持 CBC、CTR、GCM、CFB 作为块密码模式\n* [Contrib] Django Support，集成 Django settings、ModelField\n\n## Getting started\n\n### Installation\n\n```bash\n$ pip install bk-crypto-python-sdk\n```\n\n### Usage\n\n> 更多用法参考：[使用文档](https://github.com/TencentBlueKing/crypto-python-sdk/blob/main/docs/usage.md)\n\n#### 1. 基础用法\n\n**非对称加密**\n\n```python\nimport os\n\nfrom bkcrypto import constants\nfrom bkcrypto.symmetric.ciphers import BaseSymmetricCipher\nfrom bkcrypto.contrib.basic.ciphers import get_symmetric_cipher\n\nsymmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher(\n    cipher_type=constants.SymmetricCipherType.SM4.value,\n    common={"key": os.urandom(16)},\n)\nassert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))\n```\n\n**对称加密**\n\n````python\nfrom bkcrypto import constants\nfrom bkcrypto.asymmetric import options\nfrom bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher\nfrom bkcrypto.contrib.basic.ciphers import get_asymmetric_cipher\n\nasymmetric_cipher: BaseAsymmetricCipher = get_asymmetric_cipher(\n    cipher_type=constants.AsymmetricCipherType.SM2.value,\n    # 传入 None 将随机生成密钥，业务可以根据场景选择传入密钥或随机生成\n    cipher_options={\n        constants.AsymmetricCipherType.SM2.value: options.SM2AsymmetricOptions(\n            private_key_string=None\n        ),\n        constants.AsymmetricCipherType.RSA.value: options.SM2AsymmetricOptions(\n            private_key_string=None\n        ),\n    }\n)\n\n# 加解密\nassert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))\n# 验签\nassert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))\n````\n\n#### 2. 结合 Django 使用\n\n在 Django Settings 中配置加密算法类型\n\n```python\nfrom bkcrypto import constants\n\nBKCRYPTO = {\n    # 声明项目所使用的非对称加密算法\n    "ASYMMETRIC_CIPHER_TYPE": constants.AsymmetricCipherType.SM2.value,\n    # 声明项目所使用的对称加密算法\n    "SYMMETRIC_CIPHER_TYPE": constants.SymmetricCipherType.SM4.value,\n}\n```\n\n**非对称加密**\n\n```python\nfrom bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import get_asymmetric_cipher\n\nasymmetric_cipher: BaseAsymmetricCipher = get_asymmetric_cipher()\n\n# 加解密\nassert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))\n# 验签\nassert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))\n```\n\n**对称加密**\n\n```python\nfrom bkcrypto.symmetric.ciphers import BaseSymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import get_symmetric_cipher\n\nsymmetric_cipher: BaseSymmetricCipher = get_symmetric_cipher()\nassert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))\n```\n\n#### 3. 使用 Django CipherManager\n\n在 Django Settings 中配置加密算法类型\n\n```python\nfrom bkcrypto import constants\nfrom bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions\nfrom bkcrypto.asymmetric.options import RSAAsymmetricOptions\n\nBKCRYPTO = {\n    # 声明项目所使用的非对称加密算法\n    "ASYMMETRIC_CIPHER_TYPE": constants.AsymmetricCipherType.SM2.value,\n    # 声明项目所使用的对称加密算法\n    "SYMMETRIC_CIPHER_TYPE": constants.SymmetricCipherType.SM4.value,\n    "SYMMETRIC_CIPHERS": {\n        # default - 所配置的对称加密实例，根据项目需要可以配置多个\n        "default": {\n            # 可选，用于在 settings 没法直接获取 key 的情况\n            # "get_key_config": "apps.utils.encrypt.key.get_key_config",\n            # 可选，用于 ModelField，加密时携带该前缀入库，解密时分析该前缀并选择相应的解密算法\n            # ⚠️ 前缀和 cipher type 必须一一对应，且不能有前缀匹配关系\n            # "db_prefix_map": {\n            #     SymmetricCipherType.AES.value: "aes_str:::",\n            #     SymmetricCipherType.SM4.value: "sm4_str:::"\n            # },\n            # 公共参数配置，不同 cipher 初始化时共用这部分参数\n            "common": {"key": "your key"},\n            "cipher_options": {\n                constants.SymmetricCipherType.AES.value: AESSymmetricOptions(key_size=16),\n                # 蓝鲸推荐配置\n                constants.SymmetricCipherType.SM4.value: SM4SymmetricOptions(mode=constants.SymmetricMode.CTR)\n            }\n        },\n    },\n    "ASYMMETRIC_CIPHERS": {\n        # 配置同 SYMMETRIC_CIPHERS\n        "default": {\n            "common": {"public_key_string": "your key"},\n            "cipher_options": {\n                constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(\n                    padding=constants.RSACipherPadding.PKCS1_OAEP\n                ),\n                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()\n            },\n        },\n    }\n}\n```\n\n**非对称加密**\n\n使用 `asymmetric_cipher_manager` 获取 `BKCRYPTO.ASYMMETRIC_CIPHERS` 配置的 `cipher`\n\n```python\nfrom bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import asymmetric_cipher_manager\n\nasymmetric_cipher: BaseAsymmetricCipher = asymmetric_cipher_manager.cipher(using="default")\n\n# 加解密\nassert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))\n# 验签\nassert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))\n```\n\n**对称加密**\n\n使用 `symmetric_cipher_manager` 获取 `BKCRYPTO.SYMMETRIC_CIPHERS` 配置的 `cipher`\n\n```python\nfrom bkcrypto.symmetric.ciphers import BaseSymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import symmetric_cipher_manager\n\n# using - 指定对称加密实例，默认使用 `default`\nsymmetric_cipher: BaseSymmetricCipher = symmetric_cipher_manager.cipher(using="default")\nassert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))\n```\n\n**Django ModelField**\n\n```python\nfrom django.db import models\nfrom bkcrypto.contrib.django.fields import SymmetricTextField\n\n\nclass IdentityData(models.Model):\n    password = SymmetricTextField("密码", blank=True, null=True)\n```\n\n#### 3. Using Django CipherManager\n\nConfigure the encryption algorithm type in Django Settings\n\n```python\nfrom bkcrypto import constants\nfrom bkcrypto.symmetric.options import AESSymmetricOptions, SM4SymmetricOptions\nfrom bkcrypto.asymmetric.options import RSAAsymmetricOptions\n\nBKCRYPTO = {\n    # Declare the asymmetric encryption algorithm used by the project\n    "ASYMMETRIC_CIPHER_TYPE": constants.AsymmetricCipherType.SM2.value,\n    # Declare the symmetric encryption algorithm used by the project\n    "SYMMETRIC_CIPHER_TYPE": constants.SymmetricCipherType.SM4.value,\n    "SYMMETRIC_CIPHERS": {\n        # default - The configured symmetric encryption instance can be configured with multiple instances depending on the project requirements\n        "default": {\n            # Optional, used in cases where settings cannot directly obtain the key\n            # "get_key_config": "apps.utils.encrypt.key.get_key_config",\n            # Optional, used for ModelField, encrypted with this prefix to store the database, decrypting and analyzing the prefix and selecting the appropriate decryption algorithm\n            # ⚠️ The prefix and cipher type must be in one-to-one correspondence, and there can be no prefix matching relationship\n            # "db_prefix_map": {\n            #     SymmetricCipherType.AES.value: "aes_str:::",\n            #     SymmetricCipherType.SM4.value: "sm4_str:::"\n            # },\n            # Common parameter configuration, sharing these parameters when initializing different ciphers\n            "common": {"key": "your key"},\n            "cipher_options": {\n                constants.SymmetricCipherType.AES.value: AESSymmetricOptions(key_size=16),\n                # Blue Whale recommended configuration\n                constants.SymmetricCipherType.SM4.value: SM4SymmetricOptions(mode=constants.SymmetricMode.CTR)\n            }\n        },\n    },\n    "ASYMMETRIC_CIPHERS": {\n        # Configuration same as SYMMETRIC_CIPHERS\n        "default": {\n            "common": {"public_key_string": "your key"},\n            "cipher_options": {\n                constants.AsymmetricCipherType.RSA.value: RSAAsymmetricOptions(\n                    padding=constants.RSACipherPadding.PKCS1_OAEP\n                ),\n                constants.AsymmetricCipherType.SM2.value: SM4SymmetricOptions()\n            },\n        },\n    }\n}\n```\n\n**Asymmetric Encryption**\n\nUse `asymmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.ASYMMETRIC_CIPHERS`\n\n```python\nfrom bkcrypto.asymmetric.ciphers import BaseAsymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import asymmetric_cipher_manager\n\nasymmetric_cipher: BaseAsymmetricCipher = asymmetric_cipher_manager.cipher(using="default")\n\n# Encrypt and Decrypt\nassert "123" == asymmetric_cipher.decrypt(asymmetric_cipher.encrypt("123"))\n# Signature verification\nassert asymmetric_cipher.verify(plaintext="123", signature=asymmetric_cipher.sign("123"))\n```\n\n**Symmetric Encryption**\n\nUse `symmetric_cipher_manager` to get the `cipher` configured for `BKCRYPTO.SYMMETRIC_CIPHERS`\n\n```python\nfrom bkcrypto.symmetric.ciphers import BaseSymmetricCipher\nfrom bkcrypto.contrib.django.ciphers import symmetric_cipher_manager\n\n# using - Specifies a symmetric encryption instance, defaults to \'default\'\nsymmetric_cipher: BaseSymmetricCipher = symmetric_cipher_manager.cipher(using="default")\nassert "123" == symmetric_cipher.decrypt(symmetric_cipher.encrypt("123"))\n```\n\n**Django ModelField**\n\n```python\nfrom django.db import models\nfrom bkcrypto.contrib.django.fields import SymmetricTextField\n\n\nclass IdentityData(models.Model):\n    password = SymmetricTextField("Password", blank=True, null=True)\n```\n\n## Roadmap\n\n- [版本日志](https://github.com/TencentBlueKing/crypto-python-sdk/blob/main/release.md)\n\n## Support\n\n- [蓝鲸论坛](https://bk.tencent.com/s-mart/community)\n- [蓝鲸 DevOps 在线视频教程](https://bk.tencent.com/s-mart/video/)\n- [蓝鲸社区版交流群](https://jq.qq.com/?_wv=1027&k=5zk8F7G)\n\n## BlueKing Community\n\n- [BK-CMDB](https://github.com/Tencent/bk-cmdb)：蓝鲸配置平台（蓝鲸 CMDB）是一个面向资产及应用的企业级配置管理平台。\n- [BK-CI](https://github.com/Tencent/bk-ci)：蓝鲸持续集成平台是一个开源的持续集成和持续交付系统，可以轻松将你的研发流程呈现到你面前。\n- [BK-BCS](https://github.com/Tencent/bk-bcs)：蓝鲸容器管理平台是以容器技术为基础，为微服务业务提供编排管理的基础服务平台。\n- [BK-PaaS](https://github.com/Tencent/bk-paas)：蓝鲸 PaaS 平台是一个开放式的开发平台，让开发者可以方便快捷地创建、开发、部署和管理\n  SaaS 应用。\n- [BK-SOPS](https://github.com/Tencent/bk-sops)：标准运维（SOPS）是通过可视化的图形界面进行任务流程编排和执行的系统，是蓝鲸体系中一款轻量级的调度编排类\n  SaaS 产品。\n- [BK-JOB](https://github.com/Tencent/bk-job) 蓝鲸作业平台(Job)是一套运维脚本管理系统，具备海量任务并发处理能力。\n\n## Contributing\n\n如果你有好的意见或建议，欢迎给我们提 Issues 或 Pull Requests，为蓝鲸开源社区贡献力量。   \n[腾讯开源激励计划](https://opensource.tencent.com/contribution) 鼓励开发者的参与和贡献，期待你的加入。\n\n## License\n\n基于 MIT 协议， 详细请参考 [LICENSE](https://github.com/TencentBlueKing/crypto-python-sdk/blob/main/LICENSE.txt)\n',
-    'author': 'TencentBlueKing',
-    'author_email': 'contactus_bk@tencent.com',
-    'maintainer': 'None',
-    'maintainer_email': 'None',
-    'url': 'None',
-    'packages': packages,
-    'package_data': package_data,
-    'install_requires': install_requires,
-    'python_requires': '>=3.6.2,<3.11',
-}
-
-
-setup(**setup_kwargs)