サンドボックスに AI Object Storage へのアクセスを許可する

​

仕組み

​

始める前に

• AI Object Storage が有効化された CoreWeave 組織と、少なくとも 1 つのバケット。作成方法については、バケットを作成する を参照してください。
• 組織の管理者権限: IAM Admin および Object Storage Admin のロール、または同等のレガシーアクセス。
• アイデンティティとアクセス管理 (IAM) における SANDBOX_ADMIN action。これにより、サンドボックスの WIF 設定を設定できます。Access Policies ページの Cloud Console で付与します。
• CoreWeave 組織 ID。Settings ページの Cloud Console に表示されます。
• CoreWeave API アクセストークン。Tokens ページで生成し、Token Secret の値をコピーします。詳細については、API アクセストークンを管理する を参照してください。

export TOKEN="[API-ACCESS-TOKEN]"

​

ステップ 1: OIDC ワークロードフェデレーション設定の作成

1. Cloud console で Workload Federation ページに移動します。
2. Create OIDC configuration をクリックします。
3. 次の値を指定します。
   • Name: この設定を識別する名前 (例: coreweave-sandboxes) 。
   • Issuer URL: https://oidc.cwsandbox.com
   • Client ID (Audience): https://oidc.cwsandbox.com
   • Description (オプション): この設定の説明。
4. Create をクリックします。

​

ステップ 2: サンドボックスロールに権限を付与する

{
  "policy": {
    "version": "v1alpha1",
    "name": "allow-sandbox-oidc-key-creation",
    "statements": [
      {
        "name": "allow-create-access-key-from-sandbox-oidc",
        "effect": "Allow",
        "actions": [
          "cwobject:CreateAccessKeyOIDC"
        ],
        "resources": ["*"],
        "principals": [
          "role/https://oidc.cwsandbox.com:user:[USER-ID]"
        ]
      }
    ]
  }
}

{
  "policy": {
    "version": "v1alpha1",
    "name": "sandbox-read-write-bucket",
    "statements": [
      {
        "name": "allow-sandbox-rw-bucket",
        "effect": "Allow",
        "actions": [
          "s3:Get*",
          "s3:List*",
          "s3:Put*",
          "s3:DeleteObject"
        ],
        "resources": [
          "[BUCKET-NAME]",
          "[BUCKET-NAME]/*"
        ],
        "principals": [
          "role/https://oidc.cwsandbox.com:*"
        ]
      }
    ]
  }
}

​

ステップ 3: WIF 設定をサンドボックス コントロールプレーンに登録する

curl -X PUT "https://api.cwsandbox.com/v1beta2/object-storage/wif-config" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wifConfigId": "[WIF-CONFIG-ID]",
    "enabled": true,
    "allowedBuckets": ["[BUCKET-NAME]"],
    "maxPermission": "OBJECT_STORAGE_PERMISSION_READ_WRITE"
  }'

curl "https://api.cwsandbox.com/v1beta2/object-storage/wif-config" \
  -H "Authorization: Bearer $TOKEN"

curl -X DELETE "https://api.cwsandbox.com/v1beta2/object-storage/wif-config" \
  -H "Authorization: Bearer $TOKEN"

​

ステップ 4: サンドボックスの起動時にオブジェクトストレージへのアクセスをリクエストする

curl -X POST "https://api.cwsandbox.com/v1beta2/sandboxes" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "containerImage": "[CONTAINER-IMAGE]",
    "command": "sleep",
    "args": ["3600"],
    "objectStorageAccess": {
      "buckets": ["[BUCKET-NAME]"],
      "permission": "OBJECT_STORAGE_PERMISSION_READ_WRITE"
    }
  }'

​

ステップ 5: サンドボックス内で認証情報を使用する

export AWS_REGION="[AVAILABILITY-ZONE]"

aws configure set s3.addressing_style virtual

aws s3 ls s3://[BUCKET-NAME]/

import os

import boto3
from botocore.client import Config

boto_config = Config(
    region_name=os.environ['AWS_REGION'],
    s3={'addressing_style': 'virtual'}
)

s3 = boto3.client(
    's3',
    endpoint_url=os.environ['AWS_ENDPOINT_URL_S3'],
    config=boto_config
)

response = s3.list_objects_v2(Bucket=os.environ['BUCKET_NAME'])

for item in response.get('Contents', []):
    print(item['Key'], item['Size'])

export BUCKET_NAME="[BUCKET-NAME]"

python list_objects.py

datasets/train/shard-00000.tar 268435456
datasets/train/shard-00001.tar 268435456
datasets/val/shard-00000.tar 67108864

​

トークンの有効期間

• サンドボックスの OIDC トークン: デフォルトは 1 時間で、最大 12 時間です。サンドボックスの起動時にコントロールプレーンが発行します。
• AI Object Storage の一時的な認証情報: トークンから必要に応じて発行されます。交換時の応答には Expiration タイムスタンプが含まれ、AWS SDK はその時刻より前に認証情報を更新するため、コード側での対応は不要です。

​

トークンのクレーム

​

トラブルシューティング

​

起動リクエストが拒否される

• 組織に、enabled が true に設定された設定があること。この設定は、ステップ 3 の Get リクエストで取得できます。
• リクエスト内のすべてのバケットが allowedBuckets に含まれていること、または allowedBuckets が空であること。
• リクエストした permission が maxPermission を超えていないこと。

​

認証情報の交換でアクセス拒否が返される

• 組織のアクセスポリシーが、独立したステートメントでサンドボックスのロールに "resources": ["*"] に対する cwobject:CreateAccessKeyOIDC を許可していること。
• ポリシーのプリンシパルが、サブジェクトの user: 接頭辞も含め、導出されたロールと完全に一致していること。プリンシパルは role/https://oidc.cwsandbox.com:[USER-ID] ではなく、role/https://oidc.cwsandbox.com:user:[USER-ID] です。
• Cloud Console のワークロードフェデレーション設定が有効で、発行者 URL がハイフンを含まない https://oidc.cwsandbox.com であること。
• サンドボックスの OIDC トークンが期限切れになっていないこと。新しいトークンを発行するには、サンドボックスを再起動してください。

​

認証情報の交換は成功したが、S3 操作で AccessDenied が返される

​

認証情報リクエストがタイムアウトする

​

ワークロードが大量のアクセスキーを作成する

​

関連ページ

• Workload Identity Federation for AI Object Storage: CoreWeave 全体での WIF の仕組みについて。
• Use Workload Identity Federation with OIDC: サンドボックス以外のアイデンティティプロバイダー向けの一般的な OIDC フェデレーションガイド。
• 組織のアクセスポリシー: ステップ 2 で使用されるポリシースキーマ。
• Sandboxes architecture: サンドボックスリクエストパスにおけるゲートウェイとランナーの位置について。