快速开始

在一次引导式操作中，为现有应用接入认证。

本快速开始面向采用 AI 辅助集成的团队：启动 Autional 栈，把结构化的迁移提示词交给助手，然后针对真实 API 而非模拟流程验证结果。

浏览 SDK 包查看迁移指南

前置条件

一套运行中的 Autional 环境，可以是本地 Docker 或云端。
已准备好接入 SDK 的应用源代码。
一个 AI 编程助手，例如 Cursor、Claude Code 或其他能力相当的 LLM。

当助手能够查看真实代码库时，一个标准的 SaaS 应用通常约 30 分钟即可完成首次可用的集成。

三个步骤

从零集成到可验证的认证流程。

启动平台

启动本地 Autional 栈，让助手能够注册租户、查看 API，并针对真实环境验证最终流程。

# See docs.autional.cn for platform setup instructions
docker compose -f docker-compose.infra.yml -f docker-compose.monolith.yml up -d

把迁移提示词交给助手

使用结构化的提示词，让助手能够分析项目、选择合适的 SDK 包，并完成可验证的集成。

Use the Autional SDK Migration Skill to add multi-user authentication to my project.
Follow the 8-phase process: analyze -> recommend -> register -> install -> code -> test -> verify -> finalize.
Phase 3 (tenant registration): use invitation code AUTHMS-DEV-001.

检查与验证

代码生成后，先验证租户注册、代理规则与端到端认证行为，再把改动交付给团队。

curl http://localhost:11080/health
open http://localhost:11080/docs/
npm test

你将获得

认证流程：登录、注册、登出、令牌刷新与个人资料获取。

安全默认值：SHA-256 密码传输、JWT 校验，以及租户感知的流程。

运维配套：在本地开发中避免跨域问题的代理指引。

项目沉淀：AI 完成第一轮集成后，团队可留存的集成说明。

常见问题

问题	解决方案
API 返回 404	检查请求路径是否包含 /tenant/ 段，例如 /bff/tenant/api/v1/tenant/public/tenants。
密码错误	测试登录请求体时，请使用 SHA-256(rawPassword + "\|" + tenantId)。
CORS 错误	请配置框架重写或开发代理，不要从浏览器直接调用网关。
构建失败：Uint32Array	如果目标工具链需要，请在 tsconfig.json 中添加 "downlevelIteration": true。
缺少 appId	把 appId 设为任意非空标识符，例如当前项目名。