API 资源与权限作用域为每个 API 独立划分权限边界。每个 API 都拥有独立的资源标识符与权限集合针对特定 API 签发访问令牌,并以 Scope 形式携带对应权限支持为每个 API 单独配置访问令牌的有效期相关文档API 资源Ordervale APIIdentifierhttps://api.ordervale.comToken lifetime3600 sPermissionsread:ordersView orderswrite:ordersCreate and edit ordersdelete:ordersCancel orders
基于角色的访问控制 (RBAC)同时面向用户与后端服务的角色体系。支持创建跨多个 API 组合权限的全局角色为用户与机器对机器应用分别设置独立的角色体系支持为新注册或新创建的用户自动分配默认角色既可在控制台手动分配角色,也可通过 Management API 自动化管理相关文档基于角色的访问控制 (RBAC)RoleOrder managerPermissionsread:ordersOrdervale APIwrite:ordersOrdervale APIread:invoicesBilling APIAssign to new usersAssigned toSSam ChenPPriya NairKKen Ito
组织角色与组织权限基于同一套共享模板,在不同组织中分配不同角色。所有组织共用一套标准化的角色与权限模板同一名用户可以在不同组织中担任截然不同的角色支持用于应用内功能的组织权限,例如邀请成员支持将 API 权限作用域严格限定在单个组织内用户与机器对机器应用均可被赋予组织角色相关文档组织模板组织权限组织级 API 资源Sam Chen[email protected]Global roleOrdervaleSupportOrganization rolesAcmeAdminGlobexViewerOrganization templateinvite:membersmanage:billing
应用级访问控制为每个应用设置独立的准入规则。支持按指定用户、全局角色、组织,或特定组织内的角色配置访问规则为不符合应用准入规则的用户展示拒绝访问提示页在刷新令牌时重新校验访问规则,确保权限变更及时生效相关文档应用级访问控制Ordervale AdminRulesAllow sign-in forUser roleSupportOrganizationAcmeOrganization roleGlobex · AdminAccess deniedYou don't have access to Ordervale Admin.Sign in with another account
自定义令牌声明将你的业务数据与内置权限一同写入令牌。从用户资料与组织数据中提取自定义声明,例如内部用户 ID 或客户订阅套餐脚本可直接读取企业级 SSO 身份数据,例如目录用户组信息签发令牌时可从你的自有 API 实时拉取外部业务数据支持编写自定义校验逻辑,在必要时拒绝签发令牌所有内置标准声明均保持原样不受影响相关文档自定义访问令牌常见使用场景const getCustomJwtClaims = async ({ context }) => { const org = context.organization; return { plan: org?.customData.plan, internal_org_id: org?.customData.internalId, }; };{ "aud": "https://api.ordervale.com", "scope": "read:orders write:orders", "organization_id": "org_acme", "plan": "enterprise", "internal_org_id": "acme-0042" }
面向你 API 的令牌校验本地即可完成令牌校验,无需每次请求都调用 Logto。使用 Logto 公钥直接验证签名 JWT 的合法性在你的 API 中针对每次请求精准校验 Scope 权限组织令牌内置组织上下文信息,方便你的 API 确认请求归属哪家客户提供 Node.js、Python、Go、Java、.NET、PHP、Ruby 和 Rust 的校验指南权限变更会在新签发的令牌中立即生效相关文档校验访问令牌{ "iss": "https://auth.ordervale.com/oidc", "sub": "u_8k2f", "aud": "https://api.ordervale.com", "scope": "read:orders write:orders", "organization_id": "org_acme", "exp": 1760630400 }Node.jsPythonGoJava.NETPHPRubyRust