# java-aes-crypto

**Repository Path**: chinasoft_ohos/java-aes-crypto

## Basic Information

- **Project Name**: java-aes-crypto
- **Description**: 用于简单加密解密的类.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2021-04-14
- **Last Updated**: 2022-11-08

## Categories & Tags

**Categories**: harmonyos-toolkit

**Tags**: None

## README

# java-aes-crypto
#### 项目介绍
- 项目名称：java-aes-crypto
- 所属系列：openharmony的第三方组件适配移植
- 功能：用于简单加密解密的类
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 beta1
- 基线版本：Release 1.1.0

#### 效果演示
![avatar](screenshot/aes.gif)

#### 安装教程
1.在项目根目录下的build.gradle文件中,
 ```
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/release/'
    }
}
 ```

2.在entry模块的build.gradle文件中，
 ```
dependencies {
    implementation 'com.gitee.chinasoft_ohos:java-aes-crypto:1.0.0'
}
 ```

在sdk6，DevEco Studio2.2 beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明

生产一个新的密钥

```java
  AesCbcWithIntegrity.SecretKeys keys = AesCbcWithIntegrity.generateKey();
```

根据密码生成密钥
```java
  EXAMPLE_PASSWORD = // 从用户输入获取密码
  String salt = saltString(generateSalt());
  // 您可以储存salt，这不是私密的。 但不要存储key。 每次都从密码中产生
  key = generateKeyFromPassword(EXAMPLE_PASSWORD, salt);
```

加密

```java
   AesCbcWithIntegrity.CipherTextIvMac cipherTextIvMac = AesCbcWithIntegrity.encrypt("some test", keys,getContext());
   //存储或发送到服务器
   String ciphertextString = cipherTextIvMac.toString();
```

解密

```java
  //通过字符串使用构造函数重新创建CipherTextIvMac类：
  CipherTextIvMac cipherTextIvMac = new CipherTextIvMac (cipherTextString);
  String plainText = AesCbcWithIntegrity.decryptString(cipherTextIvMac, keys);
```

#### 测试信息
CodeCheck代码测试无异常  

CloudTest代码测试无异常  

安全病毒安全检测通过  

当前版本demo功能与原组件基本无差异

#### 版本迭代
- 1.0.0

#### 版权和许可信息
The included MIT license is compatible with open source or commercial products. Tozny also offers custom support 
and licensing terms if your organization has different needs. Contact us at info@tozny.com for more details.