Sanka
Sankaへ戻るログイン

ポリシーの管理

自動化の書き込みを検証するポリシーと、プリンシパル別の適用（バインディング）の運用方法

最終更新日: 2026/5/16

このページでわかること

このガイドでは、ワークスペースの「ポリシー」の役割と、基本的な運用方法を説明します。 ログの確認・ダウンロードについては、こちらをご参照ください： ワークスペースログ

概要

ポリシーは、AIエージェントやワークフロー、外部連携などによる「自動的な書き込み」が、社内ルールに沿っているかを実行前に検証するための仕組みです。例:
  • 「必須項目が入っていないレコード作成を防ぐ」
  • 「金額が一定以上の場合は承認が必要」
  • 「特定のステータス遷移だけ許可する」

ポリシーの適用順（基本）

1回の判定で使われるポリシーは1つです。対象の操作（オブジェクト / アクション）に対して、次の順で選ばれます。
  1. プリンシパルにバインドされたポリシー（あれば優先）
  2. ワークスペースのデフォルトポリシー（なければこちら）
  3. どちらもない場合は、その操作に対するポリシーが見つからない状態になります
プリンシパルは「だれ/なにが実行したか」を表す概念で、UIユーザー、APIトークン、統合アプリ、ワークフローなどを指します。補足（現時点）:
  • ポリシーは、対象範囲を限定しながら段階的に対応を広げています（対象外の操作は、ポリシーがまだ適用されない場合があります）。
  • ルール条件の詳細設定（例: 上限金額、必須項目など）は、順次拡張していきます。

ポリシー画面を開く

  1. Sanka を開きます
  2. 左サイドバーの「ワークスペース」を開きます
  3. 「ポリシー & ログ」をクリックします
  4. 画面上部で「ポリシー」タブを選びます
権限がない場合はアクセス不可の画面が表示されます。通常、ワークスペース管理者が管理します。

ポリシーを作成する

  1. 「ポリシー」タブで「ポリシーを追加」を開きます
  2. 主要な入力項目を設定します
入力項目の意味:
  • ポリシーキー: ワークスペース内で一意の識別子です（ログや自動化で参照されることがあるため、基本は後から変更しません。変えたい場合は新しいキーで作り直すのがおすすめです）
  • 名前: 管理用の表示名です
  • 対象（オブジェクト / アクション）: どの操作に対するポリシーかを指定します
  • 優先度: 複数のポリシーが対象になり得る場合に、どれを先に評価するかを決めます（数値が小さいほど優先）
  1. 「作成」をクリックします
補足（現時点の挙動）:
  • 作成直後のポリシーは、**ルールなし（= 許可）**から始まります
  • まずは「どの操作をポリシーで扱うか」を整理し、次のフェーズで条件（ルール）を追加していく想定です

有効/無効と優先度

有効/無効の切り替え

  • Active（有効）: 検証に使われます
  • Inactive（無効）: 無視されます
運用のコツ:
  • いきなり厳しくすると運用が止まることがあるため、最初は少数の対象（例: 仕訳や請求書の作成）から始めるのがおすすめです

優先度（Priority）

候補が複数ある場合（例: 同じプリンシパルに複数のバインディングがある、誤って複数デフォルトが設定されている等）、優先度の数値が小さいものが優先されます。

デフォルト（ワークスペースの基本ポリシー）

デフォルトは、そのオブジェクト/アクションに対する「基本ルール」です。プリンシパルのバインディングがない場合に、デフォルトが適用されます。設定方法:
  1. 「ポリシー」タブの一覧で、対象のポリシーの「デフォルト」列を確認します
  2. デフォルトにしたいポリシーで「設定」をクリックします

プリンシパル別のバインディング

特定の実行主体（プリンシパル）だけ、デフォルトとは別のポリシーを適用したい場合は、バインディングを作成します。
  1. 画面上部の「プリンシパル」タブを開きます
  2. 「プリンシパル追加」で、対象のプリンシパルを作成します
    • UIユーザーは ui:user:<id>
    • APIトークンは token:api:<api_id>
  3. 「バインディング」で、プリンシパルとポリシーを紐づけて保存します
  4. 必要に応じて「プレビュー」で、どのポリシーが選ばれるか（選択理由）を確認します
プレビューで表示される「選択理由」の例:
  • policy_selected_principal_binding: プリンシパルのバインディングが使われた
  • policy_selected_workspace_default: デフォルトが使われた
  • no_policy_found: ポリシーが見つからない

運用ポイント

  • ポリシーは「自動的な書き込み」を安全にするための仕組みです。日常の画面操作には影響しない場合があります。
  • 「ポリシーが見えない/操作できない」場合は、ワークスペースの権限をご確認ください。
  • ログは「ポリシー & ログ」内の「ログ」タブ、および ワークスペースログ のガイドで確認できます。
補足:
  • まずは「デフォルト」を整備し、例外（特定のAPIトークンや統合アプリなど）だけをプリンシパルのバインディングで上書きする運用がシンプルです。