<p class="shortdesc"></p> <section class="section" id="Usage__section_sfl_shd_flb"><h2 class="doc-tairway"><strong class="ph b">使用主密钥进行加解密数据</strong></h2> <p class="p">使用主密钥加解密数据主要适用于少量（小于4KB）数据的加解密。用户的数据会通过安全信道传递到KMS服务端，服务端完成加密、解密后，操作结果通过安全信道返回给用户。</p> <p class="p">关于使用主密钥进行加解密数据的步骤如下图所示。</p> <img class="image" id="Usage__image_jjt_3mt_3lb" src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20200807112324-17fffb399b21.png" width="750"> <p class="p"><strong class="ph b">加密：</strong></p> <ol class="ol" id="Usage__ol_zh1_rlt_3lb"> <li class="li">调用CreateKey API接口或通过控制台创建用户主密钥。</li> <li class="li">调用Encrypt接口，对敏感信息明文进行加密操作。</li> <li class="li">返回敏感信息加密后的密文。</li> </ol> <p class="p"><strong class="ph b">解密：</strong></p> <ol class="ol" id="Usage__ol_a31_rlt_3lb"> <li class="li">当需要使用敏感信息时，调用Decrypt接口，对密文进行解密；</li> <li class="li">返回敏感信息明文。</li> </ol> <p class="p">此外，在使用KMS服务时，您还应当确保本地网络和密钥管理服务所在网络是通的，因为加密后的密文和解密后的明文需要在本地和密钥管理服务之间进行传输。</p> </section> <section class="section" id="Usage__section_ogp_shd_flb"><h2 class="doc-tairway">场景二：使用信封本地加解密数据</h2> <p class="p">使用信封加密在本地加解密数据适用于大量数据的加解密。使用KMS创建一个主密钥，使用主密钥生成一个数据密钥，再使用数据密钥在本地加解密数据。数据无需通过网络传输即可实现加解密，在保证安全性的同时降低了成本。</p> <p class="p">关于使用信封加密进行本地加解密数据的步骤如下图所示。</p> <img class="image" id="Usage__image_lft_jmt_3lb" src="https://pcp-portal-sca.obs-cn-shenzhen.pinganyun.com/pcp-portal-sca/20200807112324-13916d339e87.png" width="750"> <p class="p"><strong class="ph b">数据信息加密：</strong></p> <ol class="ol" id="Usage__ol_ekc_vlt_3lb"> <li class="li">调用CreateKey API接口或通过控制台创建用户主密钥。</li> <li class="li">调用密钥管理服务提供的GenerateDataKey，产生数据密钥，返回结果中包含一个数据密钥明文和数据密钥密文。</li> <li class="li">利用得到的数据密钥明文对本地业务数据进行加密操作，得到业务数据密文，并删除数据密钥明文。</li> <li class="li">将业务数据密文和数据密钥密文持久化到本地。</li> </ol> <div class="note important note_important"><span class="note__title">重要：</span> <p class="p">下次进行数据信封加密操作时，可以跳过步骤1和步骤2，可以直接调用Decrypt接口解密步骤4存储的数据密钥密文，得到数据密钥明文，然后按照步骤3操作进行本地业务数据的加密操作。</p> <p class="p"><strong class="ph b">数据信封解密：</strong></p> <ol class="ol" id="Usage__ol_urj_zlt_3lb"> <li class="li">调用KMS的Decrypt接口，将数据密钥密文进行解密，得到数据密钥明文;</li> <li class="li">返回数据密钥明文；</li> <li class="li">获取本地业务数据密文；</li> <li class="li">利用数据密钥明文对本地业务数据密文进行解密操作，得到业务数据明文，并删除数据密钥明文。</li> </ol> </div> </section> <section class="section" id="Usage__section_tmt_zlt_3lb"><h2 class="doc-tairway">场景三：使用密码保险箱安全储存使用密码</h2> <p class="p">用户通过调用ImportKeychain接口或者KMS控制台中的密码保险箱页面将相关敏感信息导入平安云密码保险箱中托管。托管后，用户可以通过API接口获取到托管的密码，然后进行本地使用密码。</p> </section>