# 使用前必读 #### 概述 欢迎使用密码安全中心（Data Encryption Workshop，DEW）。密码安全中心是一个综合的云上数据加密服务。它可以提供专属加密、密钥管理、凭据管理、密钥对管理等服务，安全可靠地为用户解决了数据安全、密钥安全、密钥管理复杂等问题。其密钥由硬件安全模块（Hardware Security Module，HSM） 保护，并与多个华为云服务集成。您也可以借此服务开发自己的加密应用。 在调用密码安全中心API之前，请确保已经充分了解密码安全中心相关概念，详细信息请参见[产品介绍](https://support.huaweicloud.com/productdesc-dew/dew_01_0093.html)。 ![](https://support.huaweicloud.com/api-dew/public_sys-resources/notice_3.0-zh-cn.png) 对接KMS时，必须有重试，包括不限于504、502、500、429等错误码，且推荐重试3\~5次。针对502和504错误码，推荐超时时间5\~8秒。不建议配置过长超时时间，否则会造成客户侧无法响应。 #### 调用说明 密码安全中心提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0001.html)。 #### 终端节点 终端节点（Endpoint）即调用API的**请求地址** ，不同服务不同区域的终端节点不同，您可以从[地区和终端节点](https://developer.huaweicloud.com/endpoint?DEW)中查询服务的终端节点。 #### 约束与限制 您能创建的密钥的数量与配额有关系，具体请参见[服务配额](https://support.huaweicloud.com/usermanual-dew/dew_01_0351.html)。 密钥管理服务对单用户每秒可以请求的API操作数量设置为20，即密钥管理服务的TPS性能指标为20TPS。 #### 基本概念 - 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户来进行日常管理工作。 - 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在[我的凭证](https://console.huaweicloud.com/iam/?locale=zh-cn#/mine/apiCredential )下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 - 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见[区域和可用区](https://support.huaweicloud.com/usermanual-iaas/zh-cn_topic_0184026189.html)。 - 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 - 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1项目隔离模型 ![](https://support.huaweicloud.com/api-dew/zh-cn_image_0000002117690137.png "点击放大") - 企业项目 企业项目是项目的升级版，针对企业不同项目间资源的分组和管理，是逻辑隔离。企业项目中可以包含多个区域的资源，且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息，请参见[企业管理应用场景](https://support.huaweicloud.com/usermanual-em/em_am_0006.html)。 #### API版本选择建议 SSH密钥对提供了V3、V2.1和V2两个版本，建议您使用V3版本，能够更好的满足您的需求。