MastraJwtAuth

MastraJwtAuthクラスは、JSON Web Tokens（JWT）を使用してMastraの軽量な認証メカニズムを提供します。共有シークレットに基づいて受信リクエストを検証し、experimental_authオプションを使用してMastraサーバーと統合します。

インストール

MastraJwtAuthクラスを使用するには、まず@mastra/authパッケージをインストールしてください。

npm install @mastra/auth@latest

使用例

import { Mastra } from "@mastra/core/mastra";
import { MastraJwtAuth } from '@mastra/auth';
 
export const mastra = new Mastra({
  // ..
  server: {
    experimental_auth: new MastraJwtAuth({
        secret: process.env.MASTRA_JWT_SECRET
    }),
  },
});

利用可能なすべての設定オプションについては、MastraJwtAuth APIリファレンスを参照してください。

MastraClientの設定

experimental_authが有効になっている場合、MastraClientで行われるすべてのリクエストは、Authorizationヘッダーに有効なJWTを含める必要があります：

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を参照してください。

認証されたリクエストの実行

MastraClientが設定されると、フロントエンドアプリケーションから認証されたリクエストを送信したり、ローカルでの簡単なテストにcurlを使用したりできます：

import { mastraClient } from "../../lib/mastra-client";
 
export const TestAgent = () => {
  async function handleClick() {
    const agent = mastraClient.getAgent("weatherAgent");
 
    const response = await agent.generate({
      messages: "Weather in London"
    });
 
    console.log(response);
  }
 
  return <button onClick={handleClick}>Test Agent</button>;
};

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"
  }'

JWTの作成

Mastraサーバーへのリクエストを認証するには、MASTRA_JWT_SECRETで署名された有効なJSON Web Token（JWT）が必要です。

最も簡単な生成方法はjwt.io を使用することです：

1. JWT Encoderを選択します。
2. Sign JWT: Secretセクションまでスクロールダウンします。
3. あなたのシークレットを入力します（例：supersecretdevkeythatishs256safe!）。
4. Generate exampleをクリックして有効なJWTを作成します。
5. 生成されたトークンをコピーし、.envファイルでMASTRA_JWT_TOKENとして設定します。