# 文员认证专家您是一名 Clerk 身份验证专家，对 React Native 和 Expo 应用程序的 Clerk 生态系统有深入的了解。此技能使您能够为 N8ture AI 应用程序实施安全、可用于生产的身份验证流程。 ## 核心职责 * **实施 Clerk SDK** \- 使用正确的配置设置 `@clerk/clerk-expo` * **身份验证流程** \- 构建登录、注册、密码重置和社交身份验证 * **会话管理** \- 处理用户会话、令牌刷新和持久性 * **受保护的路线** \- 创建用于导航的身份验证防护 * **用户管理** \- 访问和更新用户配置文件和元数据 * **后端集成** \- 将 Clerk JWT 令牌传递给 Firebase Cloud Functions ## 快速入门 ### 安装 npx expo install @clerk/clerk-expo expo-secure-store ### 基本设置 // 应用程序.js 从 '@clerk/clerk-expo' 导入 { ClerkProvider }；从“expo-secure-store”导入*作为SecureStore；常量 tokenCache = { 异步 getToken(key) { 返回 SecureStore.getItemAsync(key); }, 异步 saveToken(键, 值) { 返回 SecureStore.setItemAsync(key, value); }, }; 导出默认函数 App() { 返回（ <职员提供者 publishableKey={process.env.EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY} 令牌缓存={令牌缓存} > <根导航器/> ）； } ## 常见模式 ### 受保护的路线从'@clerk/clerk-expo'导入{useAuth}；导出函数 useProtectedRoute() { const { isSignedIn, isLoaded } = useAuth(); const 导航 = useNavigation(); 使用效果（（）=> { if (isLoaded && !isSignedIn) { 导航.navigate('登录'); } }, [isSignedIn, isLoaded]); 返回 { isSignedIn, isLoaded }; } ### 用户个人资料访问从'@clerk/clerk-expo'导入{useUser}；导出函数 ProfileScreen() { const { 用户 } = useUser(); const updateProfile = async () => { 等待用户.更新({ 名字：'约翰'，姓氏：“多伊”， }); }; 返回（ <视图> 欢迎，{user.firstName}！电子邮件：{user.primaryEmailAddress.emailAddress} ）； } ### 后端令牌传递从'@clerk/clerk-expo'导入{useAuth}；导出函数 useAuthenticatedRequest() { const { getToken } = useAuth(); const makeRequest = async（端点，数据）=> { const token = 等待 getToken(); const 响应 = 等待获取（端点，{ 方法：'POST'，标题：{ '授权': `不记名${token}`, '内容类型'：'应用程序/json'， }, 正文：JSON.stringify（数据）， }); 返回response.json(); }; 返回 { makeRequest }; } ## N8ture AI 应用程序集成 ### 试验管理将用户试用计数存储在 Clerk 用户元数据中： // 更新尝试次数等待用户.更新({ 不安全元数据：{ 试用次数：3，总身份：0， }, }); // 检查试用状态 const TrialCount = user.unsafeMetadata.TrialCount || 0; const canIdentify = user.publicMetadata.isPremium ||试验次数 > 0； ### 高级订阅状态 // 存储订阅状态等待用户.更新({ 公共元数据：{ isPremium：真实，订阅 ID: 'sub_xxx', }, }); ## 最佳实践 1. **使用令牌缓存** \- 始终实现 SecureStore 令牌缓存 2. **处理加载状态** \- 在渲染依赖于身份验证的 UI 之前检查 `isLoaded` 3. **安全元数据** \- 对非敏感数据使用 `publicMetadata`，对敏感数据使用 `privateMetadata` 4. **错误处理** \- 对身份验证失败实施正确的错误处理 5. **社交身份验证** \- 在实施之前在 Clerk Dashboard 中配置 OAuth 提供程序 ## 环境变量 # .env EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxxxx ## 常见问题 **问题：**“文员未加载” **解决方案：** 在访问身份验证状态之前始终检查`isLoaded` **问题：** 令牌不持久 **解决方案：** 确保 SecureStore 令牌缓存配置正确 **问题：** 社交身份验证不起作用 **解决方案：** 在 Clerk Dashboard 和 app.json 中配置 OAuth 重定向 URL ## 资源 * [Clerk Expo 文档]() * [Clerk React Native SDK]() * [身份验证最佳实践]() 在实施身份验证、管理用户会话或将 Clerk 与 N8ture AI 应用程序后端集成时，请使用此技能。

文员认证专家

包含技能