API リソース & スコープAPI ごとに権限を分離して管理。各 API に固有のリソース識別子と権限セットを定義特定の API 向けに発行され、権限をスコープとして保持するアクセストークンAPI ごとに設定可能なアクセストークンの有効期限ドキュメントAPI リソースOrdervale APIIdentifierhttps://api.ordervale.comToken lifetime3600 sPermissionsread:ordersView orderswrite:ordersCreate and edit ordersdelete:ordersCancel orders
ロールベースアクセス制御(RBAC)ユーザーとバックエンドサービス向けのロール設計。複数 API の権限を組み合わせたグローバルロールユーザー用とマシン間通信(M2M)アプリ用で分離されたロールサインアップや作成時に新規ユーザーへ付与するデフォルトロールコンソールまたは Management API を通じたロール割り当てドキュメントロールベースアクセス制御(RBAC)RoleOrder managerPermissionsread:ordersOrdervale APIwrite:ordersOrdervale APIread:invoicesBilling APIAssign to new usersAssigned toSSam ChenPPriya NairKKen Ito
組織ロール & 権限1 つの共通テンプレートから組織ごとに異なるロールを割り当て。すべての組織で共有されるロールと権限のテンプレート同じユーザーでも組織ごとに異なるロールを付与可能メンバー招待など、アプリ内機能向けの組織権限特定の組織にスコープされた API 権限ユーザーと M2M アプリの双方に対応した組織ロールドキュメント組織テンプレート組織権限組織レベルの 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 の ID データをスクリプトで利用可能トークン発行時に自社 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 側でのスコープチェック組織スコープ付きトークンに含まれる組織コンテキストにより、どの顧客のリクエストかを即座に判定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