プロバイダーキーを使用すると、Coroid経由のモデルではなく、ご自身のモデルプロバイダーアカウントを利用できます。利用料金はそのプロバイダーから直接請求され、あなたが交渉した料金が適用されます。
これらは「設定」内で管理します。設定 → プロバイダーキー。
自社所有のキーを利用するタイミング
すでにプロバイダーとの契約が成立している、確定した利用料金がある、またはモデルベンダーを直接サプライヤーとする調達要件がある場合、BYOKの利用は有益です。
それらの条件に当てはまらない場合は、プリペイドクレジット付きのCoroid経由モデルの方が簡単で、Coroidは追加機能も提供します。マークアップなしいずれの場合もプロバイダートークンの料金は変わりません。選択のポイントは契約内容であり、価格ではありません。
キーの取り扱い方法
- 組織独自のキーで暗号化されます。各組織のプロバイダーキーは、それぞれ独自のデータキーで暗号化されます。そのデータキーはキー管理サービス（OVHcloud KMS）によってさらに暗号化されます。
- 一箇所でのみ復号化されます。プロバイダーキーを復号化できるのはCoroidの認証情報ブローカーのみです。ブローカーが直接モデル呼び出しを行うため、キーがエージェントやCoroidの他のサービスに渡ることは決してありません。
- 決して返却されません。一度保存されたキーは、インターフェースやAPIを通じて読み取ることはできません。置き換えることは可能ですが、取得することはできません。
- 決してエクスポートされません。設定エクスポートパッケージにはシークレットではなくプレースホルダーが含まれます。詳細は「設定のエクスポートとインポート」をご覧ください。設定のエクスポートとインポート。
- すべての利用履歴が記録されます。Coroidは、あなたのキーを使った各呼び出しを記録します。キーの行には、最後に利用された日時と呼び出しを実行したタスクが表示されます。漏洩が疑われる場合、Coroidのサポート担当者がどのタスクでキーが使用されたか、およびその時期を教えてくれます。
書き込み専用の仕様にしているのは意図的なものです。読み取り可能な認証情報は、読み取り権限を持つ誰でも抽出できてしまうからです。
ローテーション
キーを新しい値に置き換えます。実行中の作業は開始時に使用した接続のまま続行し、新しい作業には新しいキーが使用されます。キーを追加・置き換え・削除できるのは組織のオーナーと管理者のみで、すべての変更は組織の監査ログに記録されます。
プロバイダーが定めるスケジュールに合わせて、また管理者権限を持つ人が退職した際にローテーションを行ってください。キーが他で使用されたかどうかをCoroidで判断することはできません。それはプロバイダー自身の監査ログで確認するべき事項です。
スコープ設定
プロバイダーがスコープ付きまたは制限付きのキーをサポートしている場合は、それを利用してください。Coroid向けに設定したモデルと利用料金上限に限定されたキーであれば、万が一漏洩しても影響ははるかに小さくなります。
プロバイダー側で利用料金上限を設定してください。これが唯一の厳密な上限であり、Coroid自身の制限は処理能力を管理するためのもので、プロバイダーへの請求額とは関係ありません。
フォールバック処理
キーが無効、有効期限切れ、またはプロバイダーが定める上限を超えた場合、そのキーを使ったモデル呼び出しは失敗します。作業が別のプロバイダーで黙って続行されることはありません。他人のお金を使ってそんなことをするのは不適切だからです。
キーを修正すれば、キューに入っていた作業が再開されます。