跳到主内容
Autional 徽标

5 分钟快速开始

运行 27 个微服务、为你的应用接入认证,或部署到生产环境。门户、设计系统与 SDK 开源,核心身份服务为商业授权。

1

启动平台

# 完整步骤见快速开始指南:https://developer.autional.cn/quickstart
docker compose -f docker-compose.infra.yml -f docker-compose.monolith.yml up -d

# 等待约 2-3 分钟,全部 27 个服务启动
2

安装 SDK

npm install @autional/react
3

为你的应用接入认证

import { AutionalProvider } from '@autional/react';

const config = { appId: 'my-app', issuer: 'https://api.autional.cn' };

function App() {
  return (
    <AutionalProvider config={config}>
      <YourApp />
    </AutionalProvider>
  );
}
4

本地演示与控制台

# 查看本地服务状态
docker compose ps

# 管理控制台:http://localhost:11001
# 示例账号(仅限本地演示,请勿用于生产):admin@admin.com / admin123

访问完整文档门户 →

API 参考

全部 27 个微服务都提供交互式 Swagger/OpenAPI 文档。以下是关键服务及其基础路径:

Identity:11001

认证、注册、密码管理、SSO、RBAC

/api/v1/auth/login
MFA:11005

TOTP、WebAuthn/FIDO2、短信、邮件 OTP、自适应 MFA

/api/v1/mfa/totp/setup
OAuth:11006

OAuth 2.1、OIDC、DPoP、令牌交换、设备码

/oauth/token
Tenant:11003

多租户 CRUD、部门、品牌定制、邀请

/api/v1/tenants
RBAC:11025

角色、权限、SoD、审批流

/api/v1/admin/roles
Audit:11013

Merkle 哈希链审计、异常检测、SIEM

/api/v1/internal/audit-logs
Session:11004

会话 CRUD、令牌黑名单、设备信任、分析

/api/v1/sessions
Profile:11002

用户资料、隐私、标签、同意管理、数据导出

/api/v1/profiles

完整 OpenAPI 规范: reference.autional.cn

常见问题

使用了哪些端口?+

服务运行在 11001–11025(HTTP)与 12001–12025(gRPC)端口。网关端口为 11080,PostgreSQL 为 15432,Redis 为 16379。完整端口对照表见文档。

默认凭据是什么?+

示例账号(仅限本地演示,请勿用于生产):admin@admin.com / admin123。生产环境请务必修改密码,并配置 JWT_SECRET、PASSWORD_PEPPER 等密钥。

如何启用 HTTPS?+

参见 docker/nginx/certs/ 中的 100 年有效期自签名证书。生产环境请使用 Let's Encrypt 或你自己的 CA。SSL 终止由 nginx 网关处理。