快速開始

                      
                      // Node / Express 範例
import express from 'express';
import { verifyWsa, WsaVerificationError } from '@gptbots/workspace-extension-verify';

const app = express();
app.use(express.json());

app.post('/session/exchange', (req, res) => {
  try {
    const identity = verifyWsa(req.body.wsa, {
      secret: process.env.EXTENSION_APP_SECRET, // 你的金鑰（只在後端）
      audience: 'app.example.com',              // 你的應用程式 host，必須等於令牌 aud
    });
    // identity = { accountId, role, workspaceId, username?, email?, avatar?, appName?, issuedAt?, expiresAt? }

    const sid = createYourSession(identity);    // 換成你自己的 session
    res.cookie('sid', sid, { httpOnly: true, secure: true, sameSite: 'lax' });
    res.json(identity);
  } catch (e) {
    const code = e instanceof WsaVerificationError ? e.code : 'Error';
    res.status(401).json({ code });             // 校驗失敗一律拒絕
  }
});

                    

                      
                      // 你的落地頁
import { consumeHandoff } from '@gptbots/workspace-extension-sdk';

const identity = await consumeHandoff({ exchangeUrl: '/session/exchange' });
// consumeHandoff 依序做了：
// 1) 讀取目前 URL 的 ?wsa=
// 2) POST { wsa } 到 /session/exchange（你的後端在這裡 verifyWsa）
// 3) 成功後用 history.replaceState 抹掉 URL 裡的 ?wsa=
// 4) 回傳你後端回傳的 identity

console.log('目前工作空間使用者：', identity.username, identity.role);
if (identity.role === 'MEMBER') hideAdminUI();

                    

                      
                      工作空間「擴充」頁                         GPTBots 平台                你的應用程式
────────────────                         ───────────                ────────
使用者點擊你的應用程式圖示 ───────────────▶ 校驗點擊人是該工作空間成員
                                          用金鑰簽一枚 5 分鐘有效的 wsa (JWT)
打開 https://app.example.com/?wsa=<JWT> ────────────────────────────▶ 落地頁
                                                                     consumeHandoff()
                                          ◀── POST /session/exchange { wsa } ──
                                                                     你的後端 verifyWsa() → identity
                                                                     建立自有 session
                                                                     抹掉 URL 裡的 ?wsa=

                    

                      
                      # 解壓後，兩個套件都自帶預建置 dist，可直接本地相依：
unzip workspace-extension-sdk-0.1.0.zip
npm i ./workspace-extension-sdk/packages/verify   # 後端
npm i ./workspace-extension-sdk/packages/browser  # 前端