system:ory-keto@ja

エコシステム

Ory Keto

Ory のオープンソースの権限サーバー。2021 年に Zanzibar モデルの上に作り直され、TypeScript のサブセットで設定する。snaptoken フィールドはまだ実装されていない。

事実確認日 論文の該当節 §2.1, §2.2, §2.3.1, §2.4

開発元
Ory Corp
ライセンス
Apache-2.0
言語
Go
状況
開発継続中、リリース間隔は長め
最新リリース
v26.2.0 (2026-03-20)
リポジトリ
github.com/ory/keto
ドキュメント
www.ory.com/docs/keto

Ory Keto は Ory Corp が Go で書いた権限サーバーである。README は Keto を “an open source implementation of ‘Zanzibar: Google’s Consistent, Global Authorization System’” (「Zanzibar: Google の一貫性を備えたグローバル認可システム」のオープンソース実装) と呼んでいる (README)。Ory はこれをマネージドサービスとしても提供しており、Ory Network 上では “Ory Permissions is powered by the open source Ory Keto” (Ory Permissions はオープンソースの Ory Keto で動いている) とされている (同じ README)。

Keto は Zanzibar 型のシステムとして始まったわけではない。Zanzibar の設計が入ったのは 2021-04-07 の v0.6.0-alpha.1 であり、リリースノートには、それ以前の Keto は legacy-0.5 ブランチに移り、“the architectures are vastly different” (アーキテクチャは大きく異なる) とある (リリースノート)。Ory Permission Language で書くユーザーセット書き換えは、2022-09-27 の v0.10.0-alpha.0 で続いて導入された (リリースノート)。

論文と Keto の対応

論文 Ory Keto
名前空間設定 (§2.3) Ory Permission Language (OPL) で implements Namespace する class。OPL は TypeScript のサブセットである (OPL reference)
リレーションタプル object#relation@user (§2.1) namespace:object#relation@subject。例: Group:eng#members@User:beto (relation tuples、パーサー)
_this this.related.viewers.includes(ctx.subject)
computed_userset this.permits.edit(ctx)。“A permission can call another permission defined on the same namespace” (permission は同じ名前空間に定義された別の permission を呼び出せる)
tuple_to_userset this.related.parents.traverse((p) => p.permits.view(ctx))
和集合、積集合、除外 ||、&&、!
zookie (§2.2, §2.4) API には snaptoken フィールドがあるが、いずれも “not implemented yet and has no effect” (まだ実装されておらず効果はない) (check_service.proto)
Check (§2.4.4) CheckService.Check、BatchCheck
Read (§2.4.1) ReadService.ListRelationTuples (read_service.proto)
Write (§2.4.2) WriteService.TransactRelationTuples、DeleteRelationTuples (write_service.proto)
Watch (§2.4.3) API にはない
Expand (§2.4.5) ExpandService.Expand (expand_service.proto)
Leopard (§3.2.4) 相当するものは文書化されていない
Spanner (§3.1) PostgreSQL、MySQL、CockroachDB。SQLite は開発用のみ (production guide)

OPL で書いた共通の例

論文の図 1 は、所有者を編集者に、編集者を閲覧者に、親フォルダの閲覧者をそのドキュメントの閲覧者にする (§2.3.1)。OPL では各名前空間がクラスである。related は関係と、それが受け付ける主体の型を宣言し、permits は ctx.subject について true か false を返す関数を保持する。

import { Namespace, SubjectSet, Context } from "@ory/keto-namespace-types"

class User implements Namespace {}

class Group implements Namespace {
  related: {
    members: User[]
  }
}

class Folder implements Namespace {
  related: {
    viewers: (User | SubjectSet<Group, "members">)[]
  }

  permits = {
    view: (ctx: Context): boolean => this.related.viewers.includes(ctx.subject),
  }
}

class Doc implements Namespace {
  related: {
    parents: Folder[]
    owners: User[]
    editors: (User | SubjectSet<Group, "members">)[]
    viewers: (User | SubjectSet<Group, "members">)[]
  }

  permits = {
    edit: (ctx: Context): boolean =>
      this.related.owners.includes(ctx.subject) ||
      this.related.editors.includes(ctx.subject),

    view: (ctx: Context): boolean =>
      this.related.viewers.includes(ctx.subject) ||
      this.permits.edit(ctx) ||
      this.related.parents.traverse((p) => p.permits.view(ctx)),
  }
}

SubjectSet<Group, "members"> は「グループのメンバー」を表す OPL の型であり、論文のユーザーセットにあたる。“an object can have many subjects” (1 つのオブジェクトは多くの主体を持ちうる) ので、関係は常に配列である (OPL reference)。

共通の例の 5 つのタプルを Keto のテキスト形式で示す。User:anne と書いた主体は、関係が空の主体集合 (subject set) である。メンテナーによるサンプルのタプルもユーザーをこの形で書いている (tuples.json)。

Doc:readme#owners@User:anne
Group:eng#members@User:beto
Doc:readme#viewers@Group:eng#members
Doc:readme#parents@Folder:A
Folder:A#viewers@User:chen

各人の readme へのアクセスを決めるのは、どのタプルとどの OPL 式か。

Keto のリレーションタプルで表した共通の例5 つのリレーションタプル。User:anne は Doc:readme の owners に含まれる。User:beto は Group:eng の members に含まれる。Group:eng#members は Doc:readme の viewers に含まれる。Folder:A は Doc:readme の parents に含まれる。User:chen は Folder:A の viewers に含まれる。Chen から Folder:A を経る経路が強調されており、これは parents に対する traverse によって解決される。User:anneUser:betoUser:chenGroup:engFolder:ADoc:readmeownersmembersviewers(#members)viewersparents
Anne: owners → permits.edit → view。Beto: 主体集合 Group:eng#members。Chen: parents.traverse(p => p.permits.view)。破線は主体集合を表す。

格納されているのは矢印だけである点に注意されたい。所有者を閲覧者に、フォルダの閲覧者をドキュメントの閲覧者に変える各ステップは、すべて permits の関数の中にあり、チェック時に実行される。

アーキテクチャ

Keto のデプロイでは、どの部分がどこと通信するのか。

ドキュメントに記述された Ory Keto のデプロイKeto の各コンテナは、デフォルトでポート 4466 の Read API とポート 4467 の Write API を提供する。外部に面したクライアントはゲートウェイの背後で Read API にのみ到達する。あなたのバックエンドは Write API を使う。すべてのコンテナが 1 つの SQL データベースを共有する。スケールするにはコンテナを追加する。API ゲートウェイ経由のクライアントあなたのバックエンドKeto コンテナRead :4466 · Write :4467Keto コンテナRead :4466 · Write :4467SQL データベースRead API のみWrite + ReadSQLSQL
黄: Keto コンテナ。緑: 共有データベース。青: クライアント。コンテナ間のピア通信は文書化されていない。
  • 各コンテナは Read API (デフォルトのポート 4466)、Write API (4467)、OPL 構文 API (4469) を、それぞれ HTTP と gRPC で提供する (config schema)。
  • “A good practice is to not expose the Write API at all to the public internet” (Write API はパブリックなインターネットにまったく公開しないのがよい慣行である)、また “The Read API should also be protected” (Read API も保護すべきである) (production guide)。
  • スケーリング: “There are no additional requirements for scaling when self-hosting Ory Keto, just spin up another container!” (Ory Keto をセルフホストする場合、スケーリングに追加の要件はない。コンテナをもう 1 つ起動するだけだ) (同じガイド)。コンテナはデータベースを共有する。

一貫性

論文の zookie により、クライアントは “at a consistent snapshot no earlier than the given zookie” (与えられた zookie より前でない一貫したスナップショットで) チェックを要求できる (§2.4.4)。Keto の protobuf API はフィールド名に同じ考えを持ち込んでいる。Check、Expand、ListRelationTuples の snaptoken、TransactRelationTuples の snaptokens、そしてコンテンツ変更チェック用の latest フラグである。これらのフィールドはどれも “not implemented yet and has no effect” (まだ実装されておらず効果はない) と文書化されている (check_service.proto)。

現在クライアントが送るトークンはどう扱われるのか。

効果のない snaptoken フィールドサービスが TransactRelationTuples でタプルを書き込み、Keto はそれを SQL データベースに格納する。レスポンスには snaptokens フィールドがあるが、実装されていない。後でサービスが snaptoken 付きの Check を送ると、Keto はそのフィールドを無視するので、トークンは新しさを何も保証しない。時間あなたのサービスKetoSQL データベースTransact: Doc:readmeに viewer を追加行を書き込みsnaptokens:未実装snaptoken 付きのCheckフィールドは効果なし
API の形は論文の zookie プロトコルに倣っているが、その挙動はまだない。

したがって、論文が zookie の上に築く保証、すなわちコンテンツを「new enemy」問題から守ること (§2.2) は、その下にある SQL データベースの振る舞いに依存する点に注意されたい。ここで確認した Keto のドキュメントのページは、一貫性について何も述べていない。

論文との違い

  • zookie がない。 フィールドはあるが、挙動はない (上記参照)。
  • Watch がない。 v1alpha2 API には Check、Expand、Read、Write、Namespaces、Version の各サービスと、別の OPL 構文サービス (opl/v1alpha1) があるが、変更ストリームはない (proto ディレクトリ)。論文の Watch は二次インデックスと Leopard にデータを供給する (§2.4.3, §3.2.4)。
  • Leopard がない。 非正規化された集合インデックスは文書化されていない。
  • プログラミング言語の構文。 OPL は “users can get context help from their IDE” (ユーザーが IDE からコンテキストヘルプを得られる) ように TypeScript のサブセットになっている (OPL specification)。論文の図 1 はプロトコルバッファ風のテキスト構文で設定を書いている (§2.3.1)。論文はその形式の名前を挙げていない。
  • SQL ストレージ。 Spanner (§3.1) ではなく、共有された 1 つの SQL データベースを使う。
  • チェックの深さ。 Check リクエストは max_depth、すなわち “The maximum depth to search for a relation” (関係を探索する最大の深さ) を持つ (check_service.proto)。

現状

  • 最初のリリースは 2018-11-13 (Zanzibar 以前の設計)。Zanzibar の設計は 2021-04-07 の v0.6.0-alpha.1 から、OPL は 2022-09-27 の v0.10.0-alpha.0 から (releases)。
  • バージョン番号の体系は v0.14.0 (2025-03-06) の後で変わった。次のリリースは v25.4.0 (2025-11-07)、続いて v26.2.0 (2026-03-20) で、これが 2026-11-13 時点の最新である。
  • デフォルトブランチへの最後のコミットは 2026-07-29。スター数は約 5.4k (GitHub API、2026-11-13)。

出典