> 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/hi/create-and-upload/adding-data/datasource-credentials/gcs.md).

# Google Cloud Storage क्रेडेंशियल्स

GCS डेटा स्रोतों के लिए Google Cloud क्रेडेंशियल्स सुरक्षित रूप से बनाएं।

इस पेज का उपयोग तब करें जब आप चाहते हैं कि Roboflow एक Google Cloud Storage bucket को mirror करे [डेटासोर्सेज़](https://docs.roboflow.com/datasets/hi/create-and-upload/adding-data/datasources.md).

{% hint style="warning" %}
Google Cloud Storage के लिए, जब भी आपको ongoing sync, repeat imports, या metadata sidecar support चाहिए, Datasources और Bucket Mirror का उपयोग करें। उस use case के लिए signed URL या local download workflow न बनाएं।
{% endhint %}

## क्रेडेंशियल प्रकार चुनें

Roboflow, GCS Datasources के लिए Google Cloud के तीन access patterns का समर्थन करता है:

1. [**प्रतिरूपण**](#use-service-account-impersonation): अनुशंसित: कोई कुंजियाँ नहीं, Roboflow अल्पकालिक टोकन का उपयोग करता है
2. [**प्रत्यक्ष अनुमति**](#use-a-direct-bucket-grant): bucket पर सीधे Roboflow के service account को read access दें
3. [**JSON कुंजी**](#use-a-service-account-json-key): विरासती: एक निर्यातित service-account key, backward compatibility के लिए रखी गई

[प्रतिरूपण](#use-service-account-impersonation) और [प्रत्यक्ष अनुमति](#use-a-direct-bucket-grant) कुंजी-रहित हैं: कोई secret कभी भी आपके Google Cloud project से बाहर नहीं जाता। Google [निर्यात योग्य कुंजियों को हतोत्साहित करता है](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys) (और कई संगठन उन्हें नीति के तहत ब्लॉक करते हैं), इसलिए कुंजी-रहित विकल्पों को प्राथमिकता दें।

### सुरक्षा दिशानिर्देश

कोई भी क्रेडेंशियल बनाने से पहले:

1. Roboflow के लिए एक समर्पित service account का उपयोग करें।
2. केवल दें **Storage Object Viewer** (`roles/storage.objectViewer`), जो विशिष्ट bucket तक सीमित हो।
3. को [प्रतिरूपण](#use-service-account-impersonation) या [प्रत्यक्ष अनुमति](#use-a-direct-bucket-grant) एक [निर्यातित JSON key](#use-a-service-account-json-key).
4. क्रेडेंशियल केवल Roboflow Workspace में संग्रहीत करें [क्रेडेंशियल्स](https://app.roboflow.com/settings/thirdpartykeys) या अपने स्वयं के secret manager के ऊपर।
5. आप IAM grant हटाकर किसी भी समय Roboflow की पहुँच रद्द कर सकते हैं।

दोनों keyless modes, एक **workspace token** का उपयोग करके grant को आपके workspace से बाँधते हैं, जो Create Credential modal में दिखता है (Google Cloud में AWS-शैली का External ID नहीं होता)। जो credential आप बना रहे हैं, उसके साथ token रखें।

### Service Account Impersonation का उपयोग करें

**अनुशंसित। कोई कुंजियाँ आदान-प्रदान नहीं होतीं।** Roboflow उपयोग करता है [service account impersonation](https://cloud.google.com/iam/docs/service-account-impersonation) अपने bucket को अल्पकालिक टोकन के साथ पढ़ने के लिए।

1. Roboflow में, खोलें [एक Google Cloud (प्रतिरूपण) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/gcsImpersonation). मोडल में यह दिखता है **आवश्यक service account name** (`rf-datasource-<token>`) और **Roboflow service account**. इसे खुला रखें, आपको दोनों मानों की आवश्यकता होगी।
2. अपने प्रोजेक्ट में बिल्कुल उसी नाम से service account बनाएं (नाम में आपका workspace token शामिल होता है, जो grant को आपके workspace से बाँधता है):

   * खोलें [Service Accounts console](https://console.cloud.google.com/iam-admin/serviceaccounts/create).
   * सेट करें **Service account ID** (के पहले वाला भाग `@`) को ठीक-ठीक `rf-datasource-<token>` मोडल से, फिर क्लिक करें **बनाएँ और जारी रखें** → **हो गया**.

   CLI को प्राथमिकता दें?

   ```sh
   gcloud iam service-accounts create rf-datasource-<token> --project YOUR_PROJECT
   ```
3. अनुमति दें **उस नए service account को** अपने bucket तक read access:

   * खोलें [Cloud Storage browser](https://console.cloud.google.com/storage/browser) → आपका bucket → **अनुमतियाँ** → **पहुँच दें**.
   * नए principals = वह `rf-datasource-<token>@…` service account, Role = **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** उस **Service Account Token Creator** भूमिका **उस service account पर जिसे आपने अभी बनाया है**. यही वह चीज़ है जो Roboflow को इसका impersonation करने देती है:

   * में [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts), अपने `rf-datasource-<token>` service account → **अनुमतियाँ** टैब → **पहुँच दें**.
   * नए principals = modal में दिखाया गया Roboflow service account, Role = **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. मोडल में वापस आकर, service account email दर्ज करें और सहेजें। इसके साथ जारी रखें [Roboflow में क्रेडेंशियल बनाएं](#create-the-credential-in-roboflow).

workspace token आपके workspace और credential type से जुड़ा होता है, इसलिए modal फिर से खोलने पर वही आवश्यक service account name दिखता है।

### प्रत्यक्ष Bucket Grant का उपयोग करें

**कोई कुंजियाँ आदान-प्रदान नहीं होतीं।** Roboflow के service account को सीधे bucket पर read access दें, फिर एक marker object के साथ साबित करें कि bucket आपके workspace का है।

1. Roboflow में, खोलें [एक Google Cloud (प्रत्यक्ष अनुमति) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/gcsDirectAccess). मोडल में यह दिखता है **Roboflow service account** और आपका **workspace token**.
2. Roboflow service account को अपने bucket तक read access दें:

   * खोलें [Cloud Storage browser](https://console.cloud.google.com/storage/browser) → आपका bucket → **अनुमतियाँ** → **पहुँच दें**.
   * नए principals = modal से लिया गया Roboflow service account, Role = **Storage Object Viewer** → **सहेजें**.

   CLI को प्राथमिकता दें?

   ```sh
   gsutil iam ch "serviceAccount:ROBOFLOW_SERVICE_ACCOUNT:roles/storage.objectViewer" gs://YOUR_BUCKET
   ```
3. पर एक marker object अपलोड करें **`.roboflow/workspace-token`** जिसकी सामग्री में workspace token शामिल हो (यह bucket को आपके workspace से जोड़ता है):

   * में [Cloud Storage browser](https://console.cloud.google.com/storage/browser), अपना bucket खोलें, **फ़ोल्डर बनाएँ** `.roboflow`, फिर **अपलोड करें** नाम की एक छोटी फ़ाइल `workspace-token` जिसकी सामग्री वह token हो।

   CLI को प्राथमिकता दें?

   ```sh
   printf 'YOUR_WORKSPACE_TOKEN' | gsutil cp - gs://YOUR_BUCKET/.roboflow/workspace-token
   ```
4. Roboflow में credential सहेजें, फिर इसके साथ जारी रखें [Roboflow में क्रेडेंशियल बनाएं](#create-the-credential-in-roboflow).

Roboflow पढ़ता है `.roboflow/workspace-token` Datasource validation के दौरान marker, और इसके बिना विफल हो जाता है।

### Service Account JSON Key का उपयोग करें

**विरासती। केवल तब उपयोग करें जब keyless विकल्प संभव न हों।** Google [निर्यात योग्य कुंजियों को हतोत्साहित करता है](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys), और कई संगठन नीति के तहत उनके निर्माण को ब्लॉक करते हैं। कुंजी-रहित [प्रतिरूपण](#use-service-account-impersonation) या [प्रत्यक्ष अनुमति](#use-a-direct-bucket-grant) विकल्पों को प्राथमिकता दें।

1. एक समर्पित service account बनाएं और उसे **Storage Object Viewer** अपने bucket पर दें (जैसा कि [प्रतिरूपण](#use-service-account-impersonation)के चरण 2-3 में
2. इसके लिए एक JSON key बनाएं:

   * में [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts), अपने service account → पर क्लिक करें **कुंजियाँ** टैब → **कुंजी जोड़ें** → **नई कुंजी बनाएं** → **JSON** → **बनाएँ**। आपका browser key file डाउनलोड कर लेता है।
   * यदि **नई कुंजी बनाएं** अक्षम है, तो एक organization policy key export को रोक रही है। इसके बजाय [प्रतिरूपण](#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 कुंजी) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/gcs), अपना project ID दर्ज करें, JSON key चिपकाएँ, और सहेजें।

## Roboflow में क्रेडेंशियल बनाएं

Google Cloud-side access सेट करने के बाद:

1. पर जाएँ [क्रेडेंशियल्स](https://app.roboflow.com/settings/thirdpartykeys#create) वर्कस्पेस सेटिंग्स में।
2. क्लिक करें **क्रेडेंशियल जोड़ें** (या एक type-specific link का उपयोग करें: [प्रतिरूपण](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 credential type आपने सेट किया है, उसे चुनें।
4. service account email दर्ज करें ([प्रतिरूपण](#use-service-account-impersonation)), workspace token marker ([प्रत्यक्ष अनुमति](#use-a-direct-bucket-grant)), या project ID + JSON key ([JSON कुंजी](#use-a-service-account-json-key)).
5. क्रेडेंशियल सहेजें।
6. जब आप बनाते हैं तब उस क्रेडेंशियल का चयन करें [डेटासोर्स](https://app.roboflow.com/settings/datasources#create).

## अगला चरण

क्रेडेंशियल सहेजे जाने के बाद, इसके साथ आगे बढ़ें [डेटासोर्सेज़](https://docs.roboflow.com/datasets/hi/create-and-upload/adding-data/datasources.md) बकेट मिररिंग कॉन्फ़िगर करने के लिए।
