依拠当事者

依拠当事者とは、あなたの顧客、またはあなたが説明責任を負うその他の相手で、あなたの AI システムの各バージョンを自ら固定した評価で審査する者です。ワークスペースはあなた自身のゲートと並べて、各バージョンを相手の固定に照らして判定し、相手は各バージョンの判定記録を取得して自分のマシンで検証します。相手があなたのケース、ラベル、トレースを見ることはなく、あなたが自分の要件に何をしても相手の固定は変わりません。

記録は第二者が検証できる証拠であり、認証ではありません。

依拠当事者を招待する

ホストされたプロジェクトで Relying parties を開きます(コマンドパレットの Assurance グループ、または Governance から)。招待できるのは Owner だけです。組織名を入力し、表示されたリンクをあなた自身が一度だけ送ってください。リンクは 7 日間有効です。

依拠当事者は、自分の組織のアカウントでサインインしてリンクを開きます。あなたのワークスペースのメンバーであるアカウントは承諾できず、後からあなたのワークスペースに参加したアカウントは依拠当事者のページを失います。双方に承諾したアカウントのメールアドレスが表示されます。想定どおりのものか確認してください。

依拠当事者が行うこと

1. 送られた記録を検証する。 管理された実行のページから記録をエクスポートし(Download the decision record)、送ります。相手は次を実行します:

``bash oloproof record verify record.json --key KEY_ID=PUBLIC_KEY --workspace-keys keys.json ``

使うのは、あなたのランナーの運用者が直接渡すランナーの公開鍵と、/api/workspace-statement-key から保存した、デプロイメントが公開するワークスペース声明の鍵です。

依拠当事者の id(あなたのページに表示)がわかったら、以後のすべての確認に --relying-party RP_ID を加えてください。そうすると、別の依拠当事者の記録や提供者自身の記録は不合格になります。

2. 評価を固定する。 自分のページに、記録の evaluation.digest、evaluation.policy_digest、判定された実行の id を貼り付けます。評価ダイジェストはスイート(すべてのケースとその内容)、内容による評価器、メトリクスの仕様、ポリシーを束縛するため、削られたスイートや緩いポリシーは別のダイジェストになります。ポリシーはワークスペースが確認済みのものでなければなりません。この実行は、すべての比較ルールの判定基準となるベースラインで、相手のページに表示されます。そのため、push する順序でそれを選ぶことはできません。固定は置き換えられません。新しい固定が追加され、最新のものが有効になります。

3. ランナーの鍵を承認する。 相手のページには、プロジェクトのランナー鍵の登録と失効がすべて、起きたとおりに、誰も編集できないログから一覧表示されます。鍵が相手の固定に対して有効になるのは、相手がその登録を承認してからです。そのため、あなたが後から登録した鍵は、相手がその公開鍵を運用者から渡されたものと照合するまで、相手にとって何も判定しません。Oloproof のマネージドワーカーでの実行には承認は不要です。その鍵はあなたが登録もローテーションもしないからです。

4. すべての記録を取得する。 ページには、相手の固定に照らして判定されたすべてのシステムバージョンが、各ルールの状態と記録の Download リンクとともに一覧表示されます。相手は記録を自分で取得するため、あなたが選んで送る記録に依存しません。

各バージョンの判定方法

ワーカーは、固定された実行が相手の承認した鍵で署名された検証済み実行であれば、それをベースラインとし、各システムバージョンをその評価の最も早い開始で判定します。どの鍵が署名したか、その後どうなったかは問いません。失敗した最初の実行を、より運の良い再実行で置き換えることはできず、相手が承認していない鍵で最初に開始されたバージョンは保留されたままです。ルールはあなた自身のゲートと同じコードで、検証済み実行として判定されます。

判定は、その根拠より長く生き残りません。ベースラインの鍵が侵害されたとして失効した場合、または相手が固定し直した場合、有効な固定がもはや判定しないすべてのゲートは、理由とともに保留されます(MANUAL_REVIEW)。鍵は相手が承認した公開鍵とともにある場合にのみ有効で、Oloproof のマネージドワーカーでの実行はデプロイメント自身の鍵の下でのみ有効です。

相手の記録に加わるもの

依拠当事者向けにエクスポートされた記録は、ワークスペースの署名付き声明の中に次を含みます:

• 記録の宛先である依拠当事者と、要件としてのその固定;
• 評価におけるバージョンのすべての開始。それぞれにランナー自身の署名付きリクエストが付き、record verify が相手の渡した鍵で照合します;
• バージョンの開始または実行に署名したすべての鍵の鍵ログ: 公開鍵、登録、承認、および失効があればその記録。

record verify は、署名付きの開始が成り立たないか別の実行、バージョン、スイート、ワークスペース、プロジェクトを指している場合、ログにある鍵の公開鍵が相手の渡したものでない場合、合格したゲートが相手の承認していない鍵や侵害されたとログにある鍵に依拠している場合、または --relying-party を付けたときに記録が相手のものでないか、その声明が相手の渡したワークスペース声明の鍵で署名されていない場合に、記録を不合格にします。--relying-party を付けない場合、署名されていない声明は、検証済みではなく not checked と表示されます。終了コードは変わりません。実行できたすべての確認に合格すれば 0、いずれかが失敗すれば 5、鍵またはファイルを読めなければ 2 です。

わからないこと

• 固定と承認を行ったアカウントが依拠当事者のものであること。メールアドレスは表示されますが、証明はされません。
• ランナーが運用者の管理するコードだけを実行したこと、または評価されたバージョンが本番で稼働しているものであること。
• 評価が正しいものであること。依拠当事者がスイートを提供するか、本番から抽出したトラフィック評価を固定しない限り、スイートの選択は依然として提供者のものです。
• エクスポート後に言われたこと。記録はエクスポート時点でのワークスペースの言葉です。疑わしいときは新しいものを取得してください。
• 運用者が関係を終了した後のこと。あなたからは終了できません。依拠当事者が紐付いている間は、プロジェクトも、そのワークスペースの最後の Owner としてのあなたのアカウントも削除できません。それでも、各記録は判定されるたびに取得してください。
• PPI 区間。人手サンプルの背後にあるラベルは記録に含まれません。