第三方应用让用户登录外部应用,并安全授权其访问你的 API。为已注册的 OIDC / OAuth 应用配置独立权限与授权同意页用户后续可随时在账户中心撤销已授予的访问权限完整支持 SAML Name ID、属性映射、签名证书与断言加密支持直接将元数据 URL 作为客户端 ID 接入的 MCP 客户端相关文档第三方应用(OAuth / OIDC)权限管理SAML 应用MCP 服务器认证动态应用 (CIMD)Invoicing app wants to access your Ordervale accountSigned in as [email protected]Your name and emailView ordersread:ordersView invoicesread:invoicesChoose an organizationAcmeGlobexCancelAuthorizeExpense portalSAML appName ID formatPersistentSigning certificateActiveAttribute mappingemailEmailAddressnameDisplayNameEncrypt assertionsAI agentCIMD clientClient IDMetadata URLPre-registrationNot needed
M2M 与 API Key让服务以自身身份获权,让脚本以用户身份运行。为机器对机器应用分配全局角色与组织角色为代用户运行的脚本签发个人访问令牌,并可按需交换为访问令牌相关文档机器对机器个人访问令牌Order sync jobMachine-to-machineGrant typeclient_credentialsRolesOrdervaleOrder syncAcmeOrder readerPersonal access tokensSam ChenCI deployExpires Aug 20, 2027Nightly exportNever expirespat_••••••••••••••••••••
令牌交换实现安全的 API 委托访问,并支持客服以客户身份排查问题。委托授权:签发保留用户身份且严格不越权的 API 令牌用户模拟:经你后端审批后,允许客服人员临时以客户身份操作模拟令牌不附带刷新令牌,严格限制有效期若你传入相关上下文,令牌中可记录客服人员身份与工单详情相关文档服务间委托授权用户模拟自定义令牌声明POST /oidc/token Order service grant token-exchange subject Sam Chen resource api.ordervale.com scope read:orders 200 OK for Sam, read:orders onlyPriya NairSupportTicket4821// actor token + custom claims { "sub": "u_8k2f", "act": { "sub": "u_3pn7" }, "ticketId": "4821", "reason": "Can't see invoices" }
Management API在自己的代码中直接管理身份数据。全面覆盖用户、应用、角色与组织的增删改查接口支持从你的后端直接发起成员邀请与角色分配支持用户检索与身份认证日志查询提供内置令牌自动续期能力的 Node.js SDK相关文档调用 Management API高级用户搜索API 参考import { createManagementApi } from '@logto/api/management'; const { apiClient } = createManagementApi('ordervale', { clientId, clientSecret, }); await apiClient.GET('/api/organizations');RequestsManagement APIGET/api/users?search=%[email protected]200POST/api/organizations/org_acme/users201POST/api/users/u_8k2f/roles201
Webhooks 与 Actions实时接收身份事件,并在登录流程中运行你的自定义代码。为注册、登录以及用户、角色或组织变更提供带签名的 Webhook 推送Webhook 异步执行不阻塞登录流程,遇到 5xx 响应最多自动重试三次提供最近 24 小时的 Webhook 投递成功率与请求统计Actions 会在登录过程中同步等待执行结果,例如向你的旧系统校验密码Actions 面向 Cloud Enterprise 方案提供相关文档WebhooksWebhook 事件ActionsIdentity eventsWebhookEndpointhttps://api.ordervale.com/hooksEventsPostRegisterPostSignInUser.CreatedOrganization.Membership.Updated99.8%Success rate, 24h1,204Requests, 24hSend test payloadPassword checkActionRuns whenLocal password failsSign-inWaits for resultContinue sign-in
Secret Vault为每位用户加密保存并自动刷新第三方令牌。加密存储来自社交登录与 OIDC 企业级 SSO 连接器的 OAuth 访问令牌和刷新令牌在令牌过期前自动完成刷新,彻底告别手动维护令牌的繁琐通过 Account API 代表用户实时获取最新的第三方提供商令牌严格按用户隔离存储,应用和 AI 代理只能访问当前已登录用户自己的令牌相关文档Secret Vault联合令牌集将你的代理接入第三方 APISecret VaultSam ChenEncryptionAES-GCMFederated token setGoogleAuto-refreshGitHubAuto-refreshMicrosoft Entra IDAuto-refreshEncrypted per user · Access via Account APIGET /api/my-account/identities/google/access-token Authorization Bearer <sam_access_token> 200 OK fresh Google token for Sam