メインコンテンツへスキップ
W&B Secret Manager を使用すると、アクセストークン、ベアラートークン、APIキー、パスワードなどの機密情報にあたる文字列である secrets を、安全かつ一元的に保存、管理、挿入できます。team settings でチームのシークレットを設定および管理します。W&B の機能はチームシークレットの値を読み取れるため、それらを貼り付けたり、コード、トレーニングスクリプト、または平文のオートメーション設定に保存したりする必要がなくなります。 シークレットは各チームの Secret Manager に保存・管理され、team settingsチームシークレット セクションにあります。
  • シークレットを作成、編集、削除できるのは W&B Admin のみです。
  • シークレットは W&B の中核機能の一部であり、Azure、Google Cloud、または AWS でホストする W&B Server のデプロイ にも含まれます。別のデプロイタイプを使用している場合に W&B でシークレットをどのように利用できるかについては、W&B の account team にご相談ください。
  • W&B Server では、セキュリティ要件を満たすためのセキュリティ対策を設定する責任はお客様にあります。
  • W&B では、AWS、Google Cloud、または Azure が提供する高度なセキュリティ機能を備えたクラウドプロバイダーの secrets manager 上の W&B インスタンスにシークレットを保存することを強く推奨しています。
  • W&B では、クラウド secrets manager (AWS、Google Cloud、または Azure) 上の W&B インスタンスを使用できず、かつ cluster を使用することで発生しうるセキュリティ脆弱性を防ぐ方法を理解している場合を除き、Kubernetes cluster をシークレットストアのバックエンドとして使用しないことを推奨しています。

チームシークレットが使用される場所

チームシークレットは、W&B の複数のコンテキストで使用できます。シークレットを追加すると、W&B Automations などの機能がそのシークレットに名前でアクセスできるようになります。
  • Webhook オートメーション: オートメーションが webhook に HTTP リクエストを送信するとき、認証ヘッダーやペイロード内で参照される値に使用するチームシークレットをアタッチできます。Automations は project または Registry をスコープとして設定できます。webhook を呼び出す Registry スコープの Automations は、project スコープの webhook オートメーションと同じチーム webhook およびチームシークレットを使用します。
  • Weave Playground: プロバイダーの認証情報は、名前付きのチームシークレットとして提供されます。プロバイダーの認証情報と情報を追加するを参照してください。
  • Sandboxes: チームシークレットを安全に sandbox に渡し、環境変数として使用できるようにします。Secrets in sandboxesを参照してください。
  • LLM 評価ジョブ: 一部のベンチマークでは、チームシークレットとして保存された APIキーやトークンが必要です。Evaluation benchmark catalogを参照してください。

シークレットを追加する

シークレットを追加するには、次の手順に従います。
  1. 外部サービスから token または APIキー が提供される場合は、そのサービスの通常の手順に従ってその値を取得します。必要に応じて、W&B Secret Manager に貼り付ける前に、その機密文字列をパスワードマネージャーなどの安全な場所に保存してください。
  2. W&B にログインし、Teams の Settings ページに移動します。
  3. Team Secrets セクションで、New secret をクリックします。
  4. 英字、数字、アンダースコア (_) を使用して、シークレット名を指定します。
  5. Secret フィールドに機密文字列を貼り付けます。
  6. Add secret をクリックします。
オートメーションの webhook を設定するときに、その webhook で使用を許可する チームシークレット を選択します。フィールド名、アクセストークン、および ペイロード 変数については、Create a webhook automation を参照してください。
シークレットを作成すると、webhook automation の ペイロード 内で ${SECRET_NAME} の形式を使用してそのシークレットを参照できます。

シークレットをローテーションする

シークレットをローテーションして値を更新するには、次の手順に従います。
  1. シークレットの行にある鉛筆アイコンをクリックして、シークレットの詳細を開きます。
  2. Secret に新しい値を設定します。必要に応じて Reveal secret をクリックし、新しい値を確認します。
  3. Add secret をクリックします。シークレットの値が更新され、以前の値は参照されなくなります。
シークレットを作成または更新すると、現在の値は表示できなくなります。代わりに、シークレットを新しい値にローテーションしてください。
シークレットをローテーションまたは置き換えると、引き続き古い値を想定しているすべての機能に影響する可能性があります。新しい値を全面的に使用する前に、webhook オートメーション、シークレットを挿入する sandboxes評価ジョブWeave Playground、またはその他の利用先を更新してください。

シークレットを削除する

シークレットを削除するには:
  1. シークレットの行にあるごみ箱アイコンをクリックします。
  2. 確認ダイアログの内容を確認し、Delete をクリックします。シークレットは即座に完全に削除されます。

シークレットへのアクセスを管理する

チームのシークレットは、webhook オートメーションWeave PlaygroundサンドボックスLLM 評価ジョブ など、シークレット名で選択するチーム単位の機能で参照できます。 シークレットを削除する前に、それを使用しているすべてのオートメーション、ジョブ、サンドボックスの設定、または Playground フローを更新または削除し、機能しなくならないようにしてください。