> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/toappurdo/adding-data/datasource-credentials/gcs.md).

# Google Cloud Storage の認証情報

GCS データソース用の Google Cloud 認証情報を安全に作成します。

Roboflow に Google Cloud Storage バケットをミラーリングさせたいときは、このページを使用します [データソース](/datasets/ja/toappurdo/adding-data/datasources.md).

{% hint style="warning" %}
Google Cloud Storage では、継続的な同期、繰り返しインポート、またはメタデータのサイドカー対応が必要なときは、Datasources と Bucket Mirror を使用してください。その用途では署名付き URL やローカル ダウンロードのワークフローを作成しないでください。
{% endhint %}

## 認証情報の種類を選択

Roboflow は、GCS Datasources 向けに 3 つの Google Cloud アクセス パターンをサポートしています:

1. [**なりすまし**](#use-service-account-impersonation): 推奨: キー不要。Roboflow は短命トークンを使用します
2. [**直接付与**](#use-a-direct-bucket-grant): Roboflow のサービス アカウントにバケット上での読み取りアクセスを直接付与します
3. [**JSON キー**](#use-a-service-account-json-key): レガシー: エクスポートされたサービス アカウント キー。後方互換性のために保持されています

[なりすまし](#use-service-account-impersonation) と [直接付与](#use-a-direct-bucket-grant) はキー不要です。秘密情報が Google Cloud プロジェクトの外に出ることはありません。Google [はエクスポート可能なキーを推奨していません](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys) （そして多くの組織はポリシーでそれらをブロックしています）ので、キー不要のオプションを優先してください。

### セキュリティガイドライン

認証情報を作成する前に：

1. Roboflow 用に専用のサービス アカウントを使用してください。
2. 付与するのは **Storage Object Viewer** (`roles/storage.objectViewer` のみで、対象は特定のバケットに限定してください。
3. を優先してください [なりすまし](#use-service-account-impersonation) または [直接付与](#use-a-direct-bucket-grant) ではなく [エクスポートされた JSON キー](#use-a-service-account-json-key).
4. 認証情報は Roboflow Workspace にのみ保存してください [認証情報](https://app.roboflow.com/settings/thirdpartykeys) またはご自身のシークレット マネージャー。
5. IAM 付与を削除すれば、いつでも Roboflow のアクセス権を取り消せます。

両方のキー不要モードでは、 **ワークスペーストークン** を使用して付与をワークスペースに紐付けます。このトークンは Create Credential モーダルに表示されます（Google Cloud には AWS 風の External ID はありません）。作成する認証情報と一緒にこのトークンを保管してください。

### サービス アカウントのなりすましを使用する

**推奨。キーは交換されません。** Roboflow は [サービス アカウントのなりすまし](https://cloud.google.com/iam/docs/service-account-impersonation) を使用して、短命トークンでバケットを読み取ります。

1. Roboflow で [Google Cloud（なりすまし）認証情報を追加する](https://app.roboflow.com/settings/thirdpartykeys#create/gcsImpersonation)。モーダルには **必要なサービス アカウント名** (`rf-datasource-<token>`）と **Roboflow サービス アカウント**が表示されます。開いたままにしておき、両方の値が必要です。
2. その正確な名前でプロジェクト内にサービス アカウントを作成してください（名前にはワークスペーストークンが埋め込まれており、付与がワークスペースに紐付けられます）。

   * を開きます [サービス アカウント コンソール](https://console.cloud.google.com/iam-admin/serviceaccounts/create).
   * を設定します **サービス アカウント ID** （ `@`の前の部分）を正確に `rf-datasource-<token>` モーダルの値にしてから、 **作成して続行** → **完了**.

   CLI を使いますか？

   ```sh
   gcloud iam service-accounts create rf-datasource-<token> --project YOUR_PROJECT
   ```
3. 付与してください **その新しいサービス アカウントに** バケットへの読み取りアクセスを:

   * を開きます [Cloud Storage ブラウザ](https://console.cloud.google.com/storage/browser) → あなたのバケット → **権限** → **アクセスを許可**.
   * 新しいプリンシパル = `rf-datasource-<token>@…` サービス アカウント、ロール = **Storage Object Viewer** → **保存**.

   CLI を使いますか？

   ```sh
   gsutil iam ch "serviceAccount:rf-datasource-<token>@YOUR_PROJECT.iam.gserviceaccount.com:roles/storage.objectViewer" gs://YOUR_BUCKET
   ```
4. 付与してください **Roboflow サービス アカウント** その **Service Account Token Creator** ロールを **作成したばかりのサービス アカウントに**。これにより Roboflow がそのアカウントになりすませるようになります:

   * で [サービス アカウント](https://console.cloud.google.com/iam-admin/serviceaccounts)、あなたの `rf-datasource-<token>` サービス アカウント → **権限** タブ → **アクセスを許可**.
   * 新しいプリンシパル = モーダルに表示される Roboflow サービス アカウント、ロール = **Service Account Token Creator** → **保存**.

   CLI を使いますか？

   ```sh
   gcloud iam service-accounts add-iam-policy-binding rf-datasource-<token>@YOUR_PROJECT.iam.gserviceaccount.com \\
     --member="serviceAccount:ROBOFLOW_SERVICE_ACCOUNT" \\
     --role="roles/iam.serviceAccountTokenCreator" --project YOUR_PROJECT
   ```
5. モーダルに戻ってサービス アカウントのメールアドレスを入力し、保存します。続行してください [Roboflow で認証情報を作成](#create-the-credential-in-roboflow).

ワークスペーストークンはワークスペースと認証情報の種類に紐付いているため、モーダルを再度開いても同じ必要なサービス アカウント名が表示されます。

### 直接バケット付与を使用する

**キーは交換されません。** Roboflow のサービス アカウントにバケット上での読み取りアクセスを直接付与し、その後マーカーオブジェクトでそのバケットがワークスペースのものだと証明します。

1. Roboflow で [Google Cloud（直接付与）認証情報を追加する](https://app.roboflow.com/settings/thirdpartykeys#create/gcsDirectAccess)。モーダルには **Roboflow サービス アカウント** とあなたの **ワークスペーストークン**.
2. Roboflow のサービス アカウントにバケットへの読み取りアクセスを付与してください:

   * を開きます [Cloud Storage ブラウザ](https://console.cloud.google.com/storage/browser) → あなたのバケット → **権限** → **アクセスを許可**.
   * 新しいプリンシパル = モーダルの Roboflow サービス アカウント、ロール = **Storage Object Viewer** → **保存**.

   CLI を使いますか？

   ```sh
   gsutil iam ch "serviceAccount:ROBOFLOW_SERVICE_ACCOUNT:roles/storage.objectViewer" gs://YOUR_BUCKET
   ```
3. 次の場所にマーカーオブジェクトをアップロードします **`.roboflow/workspace-token`** その内容にワークスペーストークンを含めます（これによりバケットがワークスペースに紐付けられます）:

   * の [Cloud Storage ブラウザ](https://console.cloud.google.com/storage/browser)でバケットを開き、 **フォルダを作成** `.roboflow`を作成し、次に **アップロード** 次の名前の小さなファイルを `workspace-token` として作成し、その内容をトークンにします。

   CLI を使いますか？

   ```sh
   printf 'YOUR_WORKSPACE_TOKEN' | gsutil cp - gs://YOUR_BUCKET/.roboflow/workspace-token
   ```
4. Roboflow で認証情報を保存し、その後 [Roboflow で認証情報を作成](#create-the-credential-in-roboflow).

Roboflow は `.roboflow/workspace-token` データソースの検証時にこのマーカーを読み取り、ない場合は失敗します。

### サービス アカウント JSON キーを使用する

**レガシー。キー不要オプションが使えない場合にのみ使用してください。** Google [はエクスポート可能なキーを推奨していません](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys)は、そして多くの組織はポリシーで作成をブロックしています。キー不要の [なりすまし](#use-service-account-impersonation) または [直接付与](#use-a-direct-bucket-grant) オプションを優先してください。

1. 専用のサービス アカウントを作成し、 **Storage Object Viewer** をバケットに付与します（ [なりすまし](#use-service-account-impersonation)手順 2〜3 と同じですが、名前は何でも構いません）。
2. その JSON キーを作成します:

   * で [サービス アカウント](https://console.cloud.google.com/iam-admin/serviceaccounts)、サービス アカウント → **キー** タブ → **キーを追加** → **新しいキーを作成** → **JSON** → **作成**。ブラウザがキー ファイルをダウンロードします。
   * もし **新しいキーを作成** が無効になっている場合、組織ポリシーがキーのエクスポートをブロックしています。代わりに [なりすまし](#use-service-account-impersonation) または [直接付与](#use-a-direct-bucket-grant) を使用してください。

   CLI を使いますか？

   ```sh
   gcloud iam service-accounts keys create key.json --iam-account SA_EMAIL
   ```
3. Roboflow で [Google Cloud Storage（JSON キー）認証情報を追加する](https://app.roboflow.com/settings/thirdpartykeys#create/gcs)、プロジェクト ID を入力し、JSON キーを貼り付けて、保存します。

## Roboflow で認証情報を作成

Google Cloud 側のアクセスを設定したら、次の手順に進みます:

1. へ移動します [認証情報](https://app.roboflow.com/settings/thirdpartykeys#create) をワークスペース設定で
2. クリックします **認証情報を追加** （または種類固有のリンクを使用: [なりすまし](https://app.roboflow.com/settings/thirdpartykeys#create/gcsImpersonation), [直接付与](https://app.roboflow.com/settings/thirdpartykeys#create/gcsDirectAccess), [JSON キー](https://app.roboflow.com/settings/thirdpartykeys#create/gcs)).
3. 設定した Google Cloud Storage の認証情報タイプを選択します。
4. サービス アカウントのメールアドレスを入力し（[なりすまし](#use-service-account-impersonation)）、ワークスペーストークン マーカー（[直接付与](#use-a-direct-bucket-grant)）、またはプロジェクト ID + JSON キー（[JSON キー](#use-a-service-account-json-key)).
5. 認証情報を保存します。
6. 作成時にその認証情報を選択します [Datasource](https://app.roboflow.com/settings/datasources#create).

## 次のステップ

認証情報を保存したら、次に進んで [データソース](/datasets/ja/toappurdo/adding-data/datasources.md) バケットミラーリングを構成してください。
