境界を越えない
利用組織ごとにデータを分ける。画面の出し分けだけでなく、取得・更新する経路で境界を評価します。
OUR TECHNOLOGY
声も、文書も、メールも、判断も。人ごと、ツールごと、個別のAIごとに点在すると、会社が積み重ねた知識や経験が共通の資産として残りません。
散らばっている仕事の経緯と結果を、権限に応じて共有し、次の仕事に生かせる会社の記憶へ変えていく。そのために私たちがつくっている基盤の、考え方と設計原則を紹介します。AIが変わっても、仕事は続く。その状態を目指しています。
本ページは開発している基盤の設計原則の説明です。採用する機構・構成や実装状況はサービスごとに異なり、全商品への一律の適用を示すものではありません。
01 / CONCEPT
日々の仕事は、いくつもの入口から生まれます。その経緯と結果を一つの記憶へつなぎ、必要な権限のもとで次の仕事に使えるようにする。私たちの基盤が目指す流れです。
声、紙、メール、会計など、日々の仕事が共通の入口につながる。
情報だけでなく、経緯、判断、決定、引き継ぎが組織の記憶になる。
使うAIが変わっても、同じ権限と記録の境界を通して仕事を続けられる。
個々の経験が組織の力になり、蓄積された力がまた一人ひとりを支える。
02 / PRINCIPLES
知識と仕事を引き継ぐために、情報の境界・実行の権限・失敗からの回復・判断の記録を設計する。開発の軸となるのは、次の四つの原則です。
利用組織ごとにデータを分ける。画面の出し分けだけでなく、取得・更新する経路で境界を評価します。
ログインできることと、操作できることは別。主体・対象・操作を照合し、明示的に許可できない処理は拒否します。
通信断、再送、同時操作は起きるもの。成功する経路だけでなく、重複や途中停止からの回復を設計します。
誰が、何に対して、どの判断で操作したか。調査に必要な記録と、残しすぎないためのルールを一緒に定めます。
03 / ARCHITECTURE
AIは、仕事を頼む入口。知識・決定・引き継ぎは会話の外に残し、共通の接続口を通じて参照する設計です。AIとの対話、記憶の保管、仕事の実行を分けてつなぎます。
基盤側で、情報を読める範囲と操作できる範囲を確認する。重要な操作は人の承認を経て業務サービスへつなぎ、結果を次の仕事へ引き継げる形で記録します。画面やAPIからの操作にも、同じ判断の境界を設けます。
認証情報を検証し、所属と操作対象の組織をサーバー側で照合する。
対象への権限と、現在の状態でその操作が成立するかを評価する。
データ境界、競合、再送を考慮し、必要な更新をトランザクションでまとめる。
操作IDで実行結果と記録を結び、失敗や再試行の経緯をたどれるようにする。
AIの出力は外部入力として扱い、形式と業務ルールを検証します。実行に進む場合も、同じ認可とデータ境界を通す。モデルに権限判断を委ねません。
役割を示す概念図です。実際の処理順序やトランザクションの範囲は、競合条件・外部連携・記録要件に合わせて設計します。
04 / BOUNDARIES
設計原則を、データ・操作・外部依存の境界に分けて考えます。仕組みを採用するだけでなく、何を保証し、何を保証しないかを明確にします。
01 / DATA ISOLATION
複数の組織が使うサービスでは、リクエストに書かれた組織IDをそのまま信頼しません。認証済みの主体と所属を照合し、取得・更新の対象範囲を決めます。
PostgreSQLの行レベルセキュリティ(RLS)は、DB側でも行単位の制約を適用する選択肢です。アプリ側の認可と組み合わせて考えます。
所有者やBYPASSRLS権限などの例外があるため、有効化だけで隔離が完成するわけではありません。接続ロール、ポリシー、接続プールでの文脈の寿命を含めて検証します。
PostgreSQL:Row Security Policies02 / AUTHORIZATION
認証は「誰か」の確認。認可は「その対象に、その操作をしてよいか」の判断です。画面上のボタンを隠すことだけを、アクセス制御にしません。
主体・対象・操作・文脈を入力にし、許可条件に一致しなければ拒否する。APIやジョブを含む各経路で評価し、管理者権限も必要な範囲に限定します。
判断後に対象の状態や所属が変わる競合も考慮します。重要な更新では、条件付き更新やトランザクション内の再確認などで、判断と実行のずれを抑えます。
OWASP:Authorization Cheat Sheet03 / RETRIES
応答が届かなくても、処理自体は完了しているかもしれません。同じ依頼の再送を識別し、二重登録や二重実行を防ぐための冪等性を設計します。
操作IDの有効範囲と保持期間を定義し、同じIDで異なる内容が届いた場合は拒否する。重複判定と状態変更は、競合しても矛盾しない形で保存します。
外部サービスを含む処理は、単一DBのトランザクションだけでは完結しません。送信待ち記録や受信側の重複排除、照合・復旧の手順を組み合わせます。「必ず一度だけ届く」こととは区別します。
AWS:Making retries safe with idempotent APIs04 / AUDIT
操作ID、主体、対象、判断、結果を結びつける。調査に必要な情報を定め、機密情報や個人情報を無条件にログへ流さない方針を取ります。
成功した変更と記録の取りこぼしをどう防ぐか、拒否や失敗をどこへ残すかを分けて設計します。記録へのアクセス権、保持期間、削除方針も対象です。
ハッシュだけで改ざん防止や匿名化が成立するわけではありません。改変検知には記録先や検証点の保護が必要で、低エントロピーの入力はハッシュから推測される可能性もあります。
05 / AI BOUNDARY
形式の整った出力でも、内容が正しいとは限りません。型の検証、業務ルール、実行権限を別々に確かめ、重要な操作には必要に応じて人の確認を挟みます。
モデルへの接続をアダプターに分け、タイムアウト・不正な出力・利用上限に達した場合の扱いを決めます。検証に失敗した出力は、成功した結果として扱いません。
モデルを交換できても、品質が同じとは限りません。代表入力での評価、失敗時の動作、費用と遅延を確認してから切り替える方針です。
06 / CONTRACTS
画面や外部サービスの都合を、そのまま中心の業務ルールへ持ち込みません。入出力の契約を定義し、変更の影響範囲を小さく保ちます。
共通化するのは、意味と責任が共通する部分です。見た目が似ているだけの処理を一つにまとめず、サービス固有の判断は分離します。
契約の変更では旧データ・旧クライアントとの互換性、移行順序、切り戻しを検討します。抽象化を増やすこと自体を目的にしません。
05 / VERIFICATION
設計原則は、書くだけでは保証になりません。実装した経路ごとに検証し、運用で観測する対象を決めます。
参照・更新・一覧・添付ファイルなど、異なる経路で境界を越えないか。
再送や競合で、重複した結果や矛盾した状態が生まれないか。
完了・未完了を判別し、再試行や照合によって回復できるか。
形式が正しくても、業務条件や権限を満たさない操作を止められるか。
テストは確認した条件での振る舞いを示すもので、あらゆる障害や攻撃への安全性を保証するものではありません。構成・権限・依存先の変更に合わせて、検証を更新します。
ITSUCARA'S FOUNDATION
プロダクトの紹介はトップページへ。技術に関するご相談は、共通の窓口からお寄せください。