> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/developers/llms.txt
> Use this file to discover all available pages before exploring further.

# User Info Tokens 

> 了解在 Cobo Portal Apps 中使用 User Info Tokens 进行用户验证和资源访问控制。

<Tip>
  即刻安装 [Cobo WaaS Skill](/developers/v2_cn/guides/overview/cobo-waas-skill)，在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API，显著提升开发效率 🚀
</Tip>

User Info Tokens 是由 Cobo Portal 签名的 JSON Web  Tokens  (JWT)。这些 Tokens 允许 Cobo Portal Apps 检索有关用户的信息，包括他们的用户 ID、电子邮件地址和权限。Cobo Portal Apps 可以使用这些信息来验证用户的身份并根据权限控制他们对团队资源的访问。

## 工作原理

```mermaid theme={null}
sequenceDiagram
    participant Cobo Portal
    participant Cobo Portal Apps
    participant User
    
    User->>Cobo Portal: 打开 Cobo Portal Apps 
    Cobo Portal->>Cobo Portal Apps: 在 iframe 中呈现 App 
    Cobo Portal Apps->>Cobo Portal: 请求User Info Tokens 
    Cobo Portal->>Cobo Portal Apps: 提供User Info Tokens 
    Cobo Portal Apps->>Cobo Portal: 请求 JWKS
    Cobo Portal->>Cobo Portal Apps: 提供 JWKS
    Cobo Portal Apps->>Cobo Portal Apps: 使用 JWKS 解码并验证User Info Tokens 
```

1. 用户在 Cobo Portal 上打开 Cobo Portal Apps 。
2. Cobo Portal 在 iframe 中呈现 App 。
3. App 从 Cobo Portal 请求User Info Tokens 。
4. Cobo Portal 提供User Info Tokens 。
5. App 从 Cobo Portal 请求 JSON Web 密钥集 (JWKS)。
6. Cobo Portal 提供 JWKS。
7. App 使用 JWKS 解码并验证User Info Tokens 。
   <Note>请使用 JWT 头中指定的 `alg` 字段中的算法进行验证。</Note>

## 请求User Info Tokens

要获取User Info Tokens ，请按照以下步骤操作：

1. 通过运行以下命令安装 Cobo UI Toolkit：
   ```shell theme={null}
   npm install cobo-ui-toolkit
   ```
2. 使用 Cobo UI Toolkit提供的 `getAuthInfo` 函数：
   ```javascript theme={null}
   import { getAuthInfo } from 'cobo-ui-toolkit';


   const authInfo = await getAuthInfo();

   /*
   type AuthInfo = {
       // User Info Tokens 
       token: string;
       // 用户的团队 ID
       orgID: string;
       // 用户 ID
       userID?: string;
   };
   */

   if (authInfo.data) {
       // 处理User Info Tokens 。
       // 处理团队 ID。
   } else if (authInfo.error) {
       // 处理错误。
   }
   ```

以下是一个解码后的User Info Tokens 示例：

```json theme={null}
{
    "sub": "1234",
    "email": "dev@cobo.com",
    "role_names": [
        "Viewer",
        "Spender",
        "Approver",
        "Operator",
        "Admin"
    ],
    "iss": "https://portal.dev.cobo.com/",
    "iat": 1723705170,
    "exp": 1723705470,
    "jti": "6a02090be57a4718bc1b0a3914d70584",
    "aud": "I5rK1KnSA9xtIbIrqdzJLVPrTc0EsaGG"
}
```

## 验证User Info Tokens

使用 JWKS 验证User Info Tokens 。要检索 JWKS，请根据 App 程序使用的环境发送 HTTP GET 请求到相应的 URL：

* 生产环境：`https://api.cobo.com/v2/oauth/authorize/jwks.json`
* 开发环境：`https://api.dev.cobo.com/v2/oauth/authorize/jwks.json`

此外，您需要验证 `iss`（发行者）、`exp`（过期时间）和 `aud`（受众）字段是否正确。