第三方應用讓用戶登入外部應用,並授權訪問你的 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 密鑰授權服務以自身身份運作,並讓腳本以用戶身份執行。為機器對機器應用設定全局與組織角色讓代表用戶執行的腳本使用個人訪問令牌,並交換為訪問 token文檔機器對機器(M2M)個人訪問令牌Order sync jobMachine-to-machineGrant typeclient_credentialsRolesOrdervaleOrder syncAcmeOrder readerPersonal access tokensSam ChenCI deployExpires Aug 20, 2027Nightly exportNever expirespat_••••••••••••••••••••
Token 交換委託 API 訪問權限,並讓客服團隊模擬客戶操作。委託模式:取得保留用戶身份且僅限該用戶權限的 API token模擬模式:經由你的後端核准後,由客服代表客戶執行操作模擬用的 token 不附帶刷新 token若你有傳入,token 中可記錄客服人員身份與工單詳情文檔服務對服務委託用戶模擬自訂 Token 聲明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從你自己的代碼中管理身份數據。涵蓋用戶、應用程式、角色與組織管理端點從你的後端發送成員邀請與指派角色用戶搜尋與認證日誌查詢提供具備自動續期 token 機制的 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接收身份事件並在登入過程中執行自訂代碼。為註冊、登入以及用戶、角色或組織變更發送已簽署的 WebhookWebhook 不會阻塞登入流程,遇到 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為每位用戶加密儲存並自動刷新第三方 Token。加密儲存來自社交與 OIDC 企業級 SSO 連接器的 OAuth 訪問與刷新 token在過期前自動刷新 token,無需手動維護更新流程透過 Account API 代表用戶取得最新有效的第三方供應商 token嚴格的單一用戶隔離,確保應用與 AI agent 只能訪問已登入用戶本人的 token文檔Secret Vault聯合令牌集將 agent 連接至第三方 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