# ID, 테넌트 및 권한 부여

> Sites, team roles, API tokens, OAuth for assistants, service accounts and the activity log.

> Markdown version of https://kanorio.com/ko/developers/products/identity. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/identity.md

Status: **Available**

ID는 누가 호출을 수행하고 무엇을 할 수 있는지 정의합니다. 모든 요청은 하나의 사이트로 범위가 지정되며, 모든 토큰의 권한은 해당 토큰을 사용하는 사용자 또는 서비스 계정의 역할에 따라 제한됩니다.

## 핵심 객체

- **사이트:** 테넌트의 경계입니다. 데이터는 사이트 간에 공유되지 않습니다.
- **팀 멤버 및 역할:** 소유자, 관리자, 편집자 및 사용자 지정 역할이 포함되며, 액세스 요청 기능을 지원합니다.
- **토큰:** 개인 액세스 토큰, 어시스턴트용 OAuth 액세스 및 서비스 계정 토큰. 자세한 내용은 [인증](https://kanorio.com/ko/developers/authentication)을 참조하십시오.
- **활동 로그:** 관리 화면 또는 API를 통해 수행된 모든 변경 사항과 수행자가 기록됩니다.

## API의 역할

- `GET /whoami`는 현재 토큰으로 수행할 수 있는 작업을 보여줍니다.
- Management API를 사용하여 사이트 목록 조회 및 생성, 사용량 및 활동 로그 읽기가 가능합니다.
- 고객이 액세스할 수 있는 범위는 ID가 아닌 [고객, 멤버십 및 권한](https://kanorio.com/ko/developers/products/customers)에서 관리합니다.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Site team RBAC (custom roles, access requests), personal access tokens, service accounts and OAuth 2.1 for the Management API, customer session tokens | Available | PAT (`knr_pat_`), OAuth 2.1 (`knr_at_`) with site scope; `auth.whoami?websiteId=` reports role vs. token scope; Customer Bearer (`knr_cat_`) bound to `(websiteId, contactId)` | `<kanorio-login>` | `/settings/team`, `/settings/team/roles`, `/account/api-access` | `team.accessRequest.created` |
| Custom end-user application roles (e.g. teacher / TA / branch manager in your own app) | Not offered | — | — | — | — |
| Enterprise SSO (SAML / OIDC / SCIM) & custom contractual uptime SLA | Not offered | — | — | — | — |

## API reference

- Management API: [Sites](https://kanorio.com/en/developers/management-api/sites) (6 operations)
- Management API: [Auth](https://kanorio.com/en/developers/management-api/auth) (1 operations)

## Webhook events

- `site.subscription.upcomingRenewal`: Fired before an annual plan renews when annual add-ons or pending add-on / platform fees will be charged on the same invoice.
- `site.subscription.addOnPriceChange`: Fired at least 30 days before add-on prices change for the site, with the per-level price changes and effective date.
- `team.accessRequest.created`: Fired when a team member requests permissions they are missing, so people who manage the team can review it.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Recent changes

- 2026-10-28: Service account tokens (knr_sa_)
- 2026-10-24: Fine-grained scopes for publishing, domains, developer settings, media, orders and collection schemas
- 2026-10-23: Activity log redacts internal fields of platform actions
- 2026-10-14: OAuth client authentication, scope defaults and stability labels

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ko/help/team-permissions