# ID、テナント、および認可

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

> Markdown version of https://kanorio.com/ja/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は、誰が呼び出しを行っており、何ができるかを定義します。すべてのリクエストは1つのサイトにスコープされ、すべてのトークンの権限は、その背後にいるユーザーまたはサービスアカウントのロールによって制限されます。

## コアオブジェクト

- **サイト:** テナントの境界です。データがサイト間をまたぐことはありません。
- **チームメンバーとロール:** オーナー、管理者、編集者、およびカスタムロール。アクセスリクエスト機能も含まれます。
- **トークン:** パーソナルアクセストークン、アシスタント用のOAuthアクセス、およびサービスアカウントトークン。詳細は[認証](https://kanorio.com/ja/developers/authentication)を参照してください。
- **アクティビティログ:** 管理画面またはAPIを通じて行われたすべての変更と、その実行者が記録されます。

## APIの役割

- `GET /whoami` は、現在のトークンで何ができるかを表示します。
- Management APIを使用して、サイトの一覧取得や作成、使用状況やアクティビティログの読み取りが可能です。
- 顧客がアクセスできる範囲については、IDではなく[顧客、メンバーシップ、および権限](https://kanorio.com/ja/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/ja/help/team-permissions