跳到主要内容

创建应用

开放平台应用代表调用方身份。应用创建完成后会获得用于换取访问令牌的应用 ID 和 Secret,后续 API 权限也绑定在该应用上。

准备工作​

  • 使用具备应用管理权限的企业管理员账号。
  • 明确应用负责人、使用环境和需要访问的业务资源。
  • 确认企业版本支持 API 开放平台,免费版不支持该能力。
  • 准备密钥管理服务或受控的运行时配置,用于保存 Secret。

创建步骤​

  1. 登录阿里邮箱管理后台,进入 高级应用 > API 开放平台。
  2. 选择 添加应用,填写能够识别调用方的应用名称和说明。
  3. 按业务范围选择 API 权限。首次配置只添加当前功能必需的权限。
  4. 保存应用,记录应用 ID(client_id 或 AppCode)和 Secret(client_secret)。
  5. 使用测试环境换取访问令牌,并调用一个只读接口完成连通性验证。

凭证管理​

  • Secret 只在密钥管理服务或运行时 Secret 中保存,不写入源码、镜像、聊天记录和日志。
  • 为测试、预发和生产分别创建应用,避免共用凭证和权限。
  • 记录应用负责人、权限用途和轮换时间。负责人变更或凭证疑似泄露时立即轮换。
  • 日志只记录应用标识、请求 ID、接口和结果,不记录 Secret、访问令牌或邮件内容。

完成检查​

  • 应用名称能够对应到具体系统和负责人。
  • 权限范围与当前需求一致,没有为方便调试授予无关写权限。
  • Secret 已进入受控配置,仓库和日志中不存在明文副本。
  • 测试调用使用正确地域的 API Server,并能返回预期的只读数据。

资料来源:阿里邮箱使用手册、阿里邮箱 API 开放平台。