> Discover all available pages from the documentation index: https://mastra.zisheng.pro/llms.txt

# JSON Web Token

`MastraJwtAuth` 类使用 JSON Web Token (JWT) 为 Mastra 提供轻量级身份验证机制。它基于共享密钥验证传入请求，并通过 `auth` 选项与 Mastra 服务器集成。

## 安装

在使用 `MastraJwtAuth` 类之前，必须安装 `@mastra/auth` 包。

**npm**:

```bash
npm install @mastra/auth@latest
```

**pnpm**:

```bash
pnpm add @mastra/auth@latest
```

**Yarn**:

```bash
yarn add @mastra/auth@latest
```

**Bun**:

```bash
bun add @mastra/auth@latest
```

## 创建 JWT

要对发送至 Mastra 服务器的请求进行身份验证，你需要一个使用 `MASTRA_JWT_SECRET` 签名的有效 JSON Web Token (JWT)。

最简单的生成方式是使用 [jwt.io](https://www.jwt.io/)：

1. 选择 **JWT Encoder**。
2. 向下滚动到 **Sign JWT: Secret** 部分。
3. 输入密钥（例如：`supersecretdevkeythatishs256safe!`）。
4. 单击 **Generate example** 创建有效的 JWT。
5. 复制生成的令牌，并在 `.env` 文件中将其设置为 `MASTRA_JWT_TOKEN`。

## 用法示例

使用生成的 JWT 在 Mastra 服务器中配置 `MastraJwtAuth`：

```typescript
import { Mastra } from '@mastra/core'
import { MastraJwtAuth } from '@mastra/auth'

export const mastra = new Mastra({
  server: {
    auth: new MastraJwtAuth({
      secret: process.env.MASTRA_JWT_SECRET,
    }),
  },
})
```

有关所有可用的配置选项，请参阅 [MastraJwtAuth](https://mastra.zisheng.pro/reference/auth/jwt)。

在 [Studio](https://mastra.zisheng.pro/docs/studio/overview) 中，前往 **Settings**，然后在 **Headers** 下选择 **"Add Header"** 按钮。输入 `Authorization` 作为标头名称，并输入 `Bearer <your-jwt>` 作为值。

## 配置 `MastraClient`

启用 `auth` 后，使用 `MastraClient` 发出的所有请求都必须在 `Authorization` 标头中包含有效的 JWT：

```typescript
import { MastraClient } from '@mastra/client-js'

export const mastraClient = new MastraClient({
  baseUrl: 'https://<mastra-api-url>',
  headers: {
    Authorization: `Bearer ${process.env.MASTRA_JWT_TOKEN}`,
  },
})
```

有关更多配置选项，请参阅 [Mastra Client SDK](https://mastra.zisheng.pro/docs/server/mastra-client)。

### 发出经过身份验证的请求

配置 `MastraClient` 后，可以从前端应用发送经过身份验证的请求，或使用 `curl` 快速进行本地测试：

**React**:

```tsx
import { mastraClient } from '../../lib/mastra-client'

export const TestAgent = () => {
  async function handleClick() {
    const agent = mastraClient.getAgent('weatherAgent')

    const response = await agent.generate('Weather in London')

    console.log(response)
  }

  return <button onClick={handleClick}>Test Agent</button>
}
```

**cURL**:

```bash
curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-jwt>" \
  -d '{
    "messages": "Weather in London"
  }'
```