API 리소스 & 스코프각 API마다 권한을 분리해 관리하세요.각 API가 고유한 리소스 식별자와 권한 목록을 보유특정 API를 대상으로 발급되며 권한이 스코프로 담긴 액세스 토큰API별로 설정 가능한 액세스 토큰 유효 기간문서API 리소스Ordervale APIIdentifierhttps://api.ordervale.comToken lifetime3600 sPermissionsread:ordersView orderswrite:ordersCreate and edit ordersdelete:ordersCancel orders
역할 기반 액세스 제어 (RBAC)사용자와 백엔드 서비스를 위한 역할 체계.여러 API의 권한을 조합한 전역 역할사용자용 역할과 M2M(Machine-to-machine) 앱용 역할 분리회원가입 또는 생성 시 신규 사용자에게 자동 부여되는 기본 역할콘솔 또는 Management API를 통한 역할 할당문서역할 기반 액세스 제어 (RBAC)RoleOrder managerPermissionsread:ordersOrdervale APIwrite:ordersOrdervale APIread:invoicesBilling APIAssign to new usersAssigned toSSam ChenPPriya NairKKen Ito
조직 역할 & 권한하나의 공통 템플릿으로 조직마다 다른 역할을 부여하세요.모든 조직이 공유하는 역할 및 권한 템플릿동일한 사용자에게 조직별로 서로 다른 역할 부여 가능멤버 초대 등 앱 내 기능을 위한 조직 권한특정 조직으로 범위가 제한된 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 신원 데이터를 스크립트에서 활용 가능토큰 발급 시 자체 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 내부에서 수행하는 스코프 검사조직 범위 토큰에 포함된 조직 컨텍스트로 어떤 고객의 요청인지 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