앱과 API를 위한 역할, 권한 및 액세스 제어.

전역 및 조직 수준 RBAC, 앱별 액세스 규칙, 커스텀 토큰 클레임. 사용자와 M2M(Machine-to-machine) 앱 모두를 지원합니다.

API 리소스 & 스코프

각 API마다 권한을 분리해 관리하세요.

  • 각 API가 고유한 리소스 식별자와 권한 목록을 보유
  • 특정 API를 대상으로 발급되며 권한이 스코프로 담긴 액세스 토큰
  • API별로 설정 가능한 액세스 토큰 유효 기간

역할 기반 액세스 제어 (RBAC)

사용자와 백엔드 서비스를 위한 역할 체계.

  • 여러 API의 권한을 조합한 전역 역할
  • 사용자용 역할과 M2M(Machine-to-machine) 앱용 역할 분리
  • 회원가입 또는 생성 시 신규 사용자에게 자동 부여되는 기본 역할
  • 콘솔 또는 Management API를 통한 역할 할당

조직 역할 & 권한

하나의 공통 템플릿으로 조직마다 다른 역할을 부여하세요.

  • 모든 조직이 공유하는 역할 및 권한 템플릿
  • 동일한 사용자에게 조직별로 서로 다른 역할 부여 가능
  • 멤버 초대 등 앱 내 기능을 위한 조직 권한
  • 특정 조직으로 범위가 제한된 API 권한
  • 사용자와 M2M 앱 모두를 위한 조직 역할

앱별 액세스 제어

각 앱마다 독립적인 액세스 규칙을 설정하세요.

  • 사용자, 전역 역할, 조직, 또는 특정 조직 내 역할을 기준으로 액세스 규칙 구성
  • 앱의 규칙을 충족하지 않는 사용자에게 표시되는 접근 거부 페이지
  • 토큰 갱신 시에도 액세스 규칙을 다시 확인

커스텀 토큰 클레임

내장 권한과 함께 비즈니스 데이터를 토큰에 담으세요.

  • 내부 사용자 ID나 고객 플랜처럼 사용자 프로필 및 조직 데이터에서 가져온 커스텀 클레임
  • 디렉터리 그룹 등 엔터프라이즈 SSO 신원 데이터를 스크립트에서 활용 가능
  • 토큰 발급 시 자체 API에서 외부 데이터를 조회해 추가
  • 토큰 발급을 거부할 수 있는 커스텀 검증 로직
  • 기본 내장 클레임은 그대로 유지

API용 토큰 검증

요청마다 Logto를 호출하지 않는 로컬 토큰 검증.

  • Logto의 공개 키로 검증되는 서명된 JWT
  • 각 요청에 대해 API 내부에서 수행하는 스코프 검사
  • 조직 범위 토큰에 포함된 조직 컨텍스트로 어떤 고객의 요청인지 API가 즉시 확인
  • Node.js, Python, Go, Java, .NET, PHP, Ruby, Rust용 검증 가이드 제공
  • 권한 변경 사항은 새로 발급되는 토큰부터 적용

액세스를 제어하는 더 많은 방법.

  • 조직 (Organizations)

    모든 고객이 이미 정의해 둔 템플릿의 역할을 사용하는 자체 멤버를 갖게 됩니다.

  • M2M (Machine-to-machine) 앱

    제품 전체 또는 특정 조직 내에서 백엔드 서비스에 고유한 역할을 부여하세요.

  • 파트너 앱 동의 화면

    서드파티 OIDC / OAuth 앱의 경우 사용자가 동의 화면에서 데이터와 API 접근을 승인합니다.

역할을 정의하고, 앱과 API에서 권한을 일관되게 적용하세요.