# 认证鉴权
DocZip开放API提供的所有接口都需要通过认证之后才可以访问。认证方式为：通过认证接口获取access_token，在请求消息头上设置"Authorization"携带access_token进行鉴权。
Token在计算机系统中代表令牌（临时）的意思，拥有Token代表拥有某种权限。Token认证是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
**认证流程**
1. **应用配置** ：租户管理员在[DocZip控制台](https://console.huaweicloud.com/doczip/#/console/overview)中新建应用，并按要求进行身份提供商配置。
2. **获取Token** ：集成方后端使用 client_id（appid）和 client_secret（appsecret）完成客户端认证，通过Token Exchange接口获取 access_token。详见[申请令牌](https://support.huaweicloud.com/api-doczip/CreateEmbedAuthToken.html)。
3. **携带Token调用API**：在请求消息头中添加 Authorization 字段，格式为 Bearer {access_token}。
4. **Token刷新** ：access_token 过期前，使用 refresh_token 刷新获取新的 access_token。详见[刷新令牌](https://support.huaweicloud.com/api-doczip/RefreshEmbedAuthToken.html)。
5. **Token撤销** ：如果想要撤销已经颁发的用户Token，可以将access_token 、refresh_token置失效。详见[撤销令牌](https://support.huaweicloud.com/api-doczip/RevokeEmbedAuthToken.html)。
6. **H5会话建立** ：如果您的应用需要集成H5页面，需要使用access_token换取一次性Ticket，由DocZip建立用户Session会话。详见[签发一次性会话 ticket](https://support.huaweicloud.com/api-doczip/CreateEmbedAuthSessionTicket.html)。
**请求消息头示例：**
```
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
```
**注意事项**
● access_token 默认有效期为**2小时**，过期后需使用 refresh_token 刷新。
● refresh_token 默认有效期为**30天**，过期后需重新进行Token Exchange获取新的凭证。
● access_token 和 refresh_token 须妥善保管，避免泄露。
● 集成方后端负责管理Token的生命周期，建议在 access_token 过期前主动刷新，避免业务中断。