Nostr WoT

Authentifier une session HTTP

Authentifier une session HTTP

Utilisez @nostr-wot/auth sur le serveur et /client dans le navigateur. Montez les quatre routes, puis appelez loginWithSigner depuis un bouton. La session repose sur un événement NIP-98 de type 27235.

terminal
$npm install @nostr-wot/auth@5.0.0 nostr-wot-sdk@3.0.0 nostr-tools

Exemple

typescript
// Server only: lib/auth.ts
import { createAuthService } from "@nostr-wot/auth";
import { createNextHandlers } from "@nostr-wot/auth/next";

const secret = process.env.NOSTR_AUTH_SECRET;
if (!secret) throw new Error("Configure NOSTR_AUTH_SECRET on the server");
export const handlers = createNextHandlers(createAuthService({
  secret, expectedVerifyUrl: "https://example.com/api/auth/verify",
  jwtIssuer: "https://example.com", jwtTtlSec: 3600,
}), { cookie: true, cookieAttrs: { secure: true, sameSite: "Lax" } });

// Each export belongs in its own Next.js route.ts file:
// app/api/auth/challenge/route.ts: export const POST = handlers.challenge;
// app/api/auth/verify/route.ts:    export const POST = handlers.verify;
// app/api/auth/me/route.ts:        export const GET = handlers.me;
// app/api/auth/logout/route.ts:    export const POST = handlers.logout;
// Import { handlers } from "@/lib/auth" in each route.

// Separate browser module, called by a login button:
// import { loginWithSigner } from "@nostr-wot/auth/client";
// import { Nip07Signer } from "nostr-wot-sdk/signers";
// await loginWithSigner({ baseUrl: "/api/auth", signer: new Nip07Signer() });

Notes d’intégration

Remplacez example.com par l’origine et l’URL de vérification exactes. Gardez un secret aléatoire robuste côté serveur, jamais dans NEXT_PUBLIC. Vérifiez session et permissions sur les routes protégées. Le défi est sans état ; un usage strictement unique exige un stockage de consommation. Le type 22242 concerne les relais, pas HTTP.

Référence et options supplémentaires