[fix]提供隧道加密和解密工具方法 review by songym

Author: luoxiao-supermap

src/common/index.common.js

@@ -324,7 +324,7 @@ import {
     FilterField,
     OnlineServiceBase
 } from './online';
-import { KeyServiceParameter, SecurityManager, ServerInfo, TokenServiceParameter } from './security';
+import { KeyServiceParameter, SecurityManager, ServerInfo, TokenServiceParameter, decrypt } from './security';
 import { ElasticSearch } from './thirdparty';
 import {
     isCORS,
@@ -745,7 +745,7 @@ export {
     FeatureTheme,
     Transform
 };
-export { KeyServiceParameter, SecurityManager, ServerInfo, TokenServiceParameter };
+export { KeyServiceParameter, SecurityManager, ServerInfo, TokenServiceParameter, decrypt };
 export { CartoCSS, ThemeStyle };
 export { ElasticSearch };
 export { Lang };

src/common/namespace.js

@@ -326,6 +326,7 @@ import {
   FilterField,
   OnlineServiceBase,
   KeyServiceParameter,
+  decrypt,
   SecurityManager,
   ServerInfo,
   TokenServiceParameter,
@@ -890,6 +891,7 @@ SuperMap.KeyServiceParameter = KeyServiceParameter;
 SuperMap.SecurityManager = SecurityManager;
 SuperMap.ServerInfo = ServerInfo;
 SuperMap.TokenServiceParameter = TokenServiceParameter;
+SuperMap.decrypt= decrypt;
 // style
 SuperMap.ThemeStyle = ThemeStyle;
 SuperMap.CartoCSS = CartoCSS;

src/common/package.json

@@ -16,6 +16,7 @@
   "dependencies": {
     "@antv/g2": "^4.2.11",
     "@antv/g6": "^4.8.14",
+    "@supermapgis/tile-decryptor": "^1.0.0",
     "@turf/meta": "^6.5.0",
     "echarts": "5.5.0",
     "fast-xml-parser": "^4.2.7",

src/common/security/decrypt.js

@@ -0,0 +1,39 @@
+/* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
+ * This program are made available under the terms of the Apache License, Version 2.0
+ * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
+import decryptUtil from '@supermapgis/tile-decryptor';
+
+/**
+ * @category Security
+ * @function decrypt
+ * @description 隧道解密ArrayBuffer数据。
+ * @param {Object} options - 参数。
+ * @param {ArrayBuffer} options.arrayBuffer - 解密数据，数据格式为ArrayBuffer。
+ * @param {string} options.key - 秘钥
+ * @param {string} options.algorithm - 加密算法， 可选值： "AES"、"AES/CTR"、"SM4"、"SM4/CTR"。
+ * @param {number} [options.decodeSize=256] - 需要解密的数据大小。
+ * @param {Array<number>} [options.ivKey] - 当algorithm为'AES'或者"AES/CTR", 默认值为：[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]；当algorithm为'SM4'或者"SM4/CTR", 默认值为：[48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 97, 98, 99, 100, 101, 102]。
+ * @returns {string} 解密后的数据。
+ * @usage
+ * ```
+ * // 浏览器
+ * <script type="text/javascript" src="{cdn}"></script>
+ * <script>
+ *   const result = {namespace}.decrypt(options);
+ *
+ * </script>
+ *
+ * // ES6 Import
+ * import { decrypt } from '{npm}';
+ *
+ * const result = decrypt(options);
+ * ```
+ */
+const decrypt = (options) => {
+  const res = decryptUtil({ ...options });
+  const decoder = new TextDecoder();
+  const decodeStr = decoder.decode(new Uint8Array(res));
+  return decodeStr;
+};
+
+export { decrypt };

src/common/security/index.js

@@ -1,12 +1,14 @@
 /* Copyright© 2000 - 2024 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
-import {KeyServiceParameter} from './KeyServiceParameter';
-import {SecurityManager} from './SecurityManager';
-import {ServerInfo} from './ServerInfo';
-import {TokenServiceParameter} from './TokenServiceParameter';
+import { KeyServiceParameter } from './KeyServiceParameter';
+import { SecurityManager } from './SecurityManager';
+import { ServerInfo } from './ServerInfo';
+import { TokenServiceParameter } from './TokenServiceParameter';
+import { decrypt } from './decrypt';
 
-export {KeyServiceParameter} ;
-export {SecurityManager} ;
-export {ServerInfo} ;
-export {TokenServiceParameter} ;
+export { KeyServiceParameter };
+export { SecurityManager };
+export { ServerInfo };
+export { TokenServiceParameter };
+export { decrypt };

test/common/security/decryptSpec.js

@@ -0,0 +1,14 @@
+import { decrypt } from '../../../src/common/security/decrypt';
+
+describe('decrypt', () => {
+  it('decrypt AFS', () => {
+    const unit8 = Uint8Array.from([65, 254, 189, 210, 176, 155, 38, 120, 236, 244]);
+    var options = {
+      arrayBuffer: unit8.buffer,
+      key: 'nSDXTzVXy93lc4dmhokTyWvMbiAroF8cSmIfulJG9bg=',
+      algorithm: 'AES'
+    };
+    var parameter = decrypt(options);
+    expect(parameter).toEqual('{"recordse');
+  });
+});