clerk-auth

Status: Production Ready ✅ Last Updated: 2025-10-28 Dependencies: None Latest Versions: @clerk/nextjs@6.33.3, @clerk/backend@2.17.2, @clerk/clerk-react@5.51.0, @clerk/testing@1.4.4

\\\`typescript import React from 'react' import ReactDOM from 'react-dom/client' import { ClerkProvider } from '@clerk/clerk-react' import App from './App.tsx' import './index.css'

// Get publishable key from environment const PUBLISHABLEKEY = import.meta.env.VITECLERKPUBLISHABLEKEY

توفر هذه المهارة معرفة شاملة لدمج مصادقة Clerk في تطبيقات React وNext.js وCloudflare Workers. يجب استخدامه عند إعداد مصادقة المستخدم، أو تنفيذ المسارات المحمية، أو التحقق من رموز JWT، أو إنشاء قوالب JWT مخصصة مع بيانات تعريف المستخدم ومطالبات المؤسسة، أو تكوين البرامج الوسيطة لـ Clerk، أو التكامل مع مكونات shadcn/ui، أو اختبار تدفقات المصادقة، أو استكشاف أخطاء مصادقة Clerk وإصلاحها. يُستخدم عندما: إضافة Clerk إلى مشاريع React/Vite، وإعداد Clerk في Next.js App Router، وتنفيذ مصادقة Clerk في Cloudflare Workers، وتكوين clerkMiddleware لحماية المسار، وإنشاء قوالب JWT مخصصة برموز قصيرة (user.id، user.email، user.public_metadata.role)، والوصول إلى مطالبات الجلسة لـ RBAC، والتكامل مع Supabase/Grafbase، والتحقق من الرموز المميزة باستخدام @clerk/backend، ودمج Clerk مع Hono، واستخدام مكونات Clerk shadcn/ui، وكتابة اختبارات E2E باستخدام Playwright، وإنشاء رموز مميزة لجلسة الاختبار، واستخدام عناوين البريد الإلكتروني وأرقام الهواتف للاختبار، أو مواجهة أخطاء المصادقة. يمنع 11 مشكلة موثقة: أخطاء المفتاح السري المفقودة، وفشل ترحيل مفتاح واجهة برمجة التطبيقات، وحالات سباق ذاكرة التخزين المؤقت لـ JWKS، وثغرات CSRF من الأطراف المعتمدة المفقودة، وأخطاء مسار الاستيراد بعد ترقية Core 2، ومشكلات حدود حجم JWT، وتحذيرات إصدار واجهة برمجة التطبيقات المهملة، وأخطاء مكون ClerkProvider JSX، وارتباك مساعد async auth()، والتهيئة الخاطئة لمتغير البيئة، وأخطاء رأس وضع Vite dev 431. الكلمات الرئيسية: clerk، clerk auth، مصادقة الكاتب، @clerk/nextjs، @clerk/backend، @clerk/clerk-react، clerkMiddleware، createRouteMatcher، VereToken، useUser، useAuth، useClerk، قالب JWT، مطالبات JWT، رموز JWT القصيرة، JWT مخصص، مطالبات الجلسة، قالب getToken، user.public_metadata، org_id، org_slug، org_role، CustomJwtSessionClaims، بيانات تعريف sessionClaims، خطاف الويب للموظف، المفتاح السري للموظف، مفتاح الموظف القابل للنشر، المسارات المحمية، مصادقة Cloudflare Workers، Next.js auth، shadcn/ui auth، @hono/clerk-auth، "المفتاح السري للموظف مفقود"، "لا يمكن يمكن استخدامه كمكون JSX"، خطأ JWKS، الأطراف المعتمدة، البرامج الوسيطة للكاتب، ClerkProvider، UserButton، تسجيل الدخول، الاشتراك، اختبار الكاتب، اختبار رسائل البريد الإلكتروني، أرقام هواتف الاختبار، +clerk_test، 424242 OTP، رمز الجلسة، رمز الاختبار، @clerk/testing،… المصدر: jackspace/claudeskillz.