> 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/azure.md).

# Azure Blob Storage क्रेडेंशियल्स

Azure Blob Storage डेटा स्रोतों के लिए Azure क्रेडेंशियल्स सुरक्षित रूप से बनाएं।

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

{% hint style="warning" %}
Azure Blob Storage के लिए, जब भी आपको निरंतर सिंक, बार-बार इंपोर्ट, या मेटाडेटा साइडकार सपोर्ट चाहिए, Datasources और Bucket Mirror का उपयोग करें। उस उपयोग-केस के लिए signed URL या local download workflow न बनाएं।
{% endhint %}

Azure एक storage account के अंदर container का नाम देता है, इसलिए Datasource को दोनों चाहिए। Roboflow केवल container को पढ़ता है, और उसमें कभी लिखता नहीं है।

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

Roboflow Blob Storage Datasources के लिए तीन Azure access patterns का समर्थन करता है:

1. [**वर्कलोड आइडेंटिटी**](#use-workload-identity-federation): अनुशंसित: कोई key नहीं, घुमाने के लिए कुछ नहीं
2. [**कंटेनर SAS**](#use-a-container-sas-token): बनाने में सबसे तेज़, लेकिन समाप्त हो जाता है और उसे बदलना पड़ता है
3. [**सर्विस प्रिंसिपल**](#use-a-service-principal): एक client secret, उन tenants के लिए जो federated credentials को ब्लॉक करते हैं

[वर्कलोड आइडेंटिटी](#use-workload-identity-federation) keyless है: कोई secret कभी बनाया, संग्रहीत, या rotated नहीं किया जाता। Microsoft [इसे Azure के बाहर के workloads के लिए अनुशंसित करता है](https://learn.microsoft.com/entra/workload-id/workload-identity-federation), इसलिए इसे प्राथमिकता दें जब तक कि आपकी tenant policy federated credentials को ब्लॉक न करे।

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

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

1. Roboflow के लिए एक dedicated app registration का उपयोग करें।
2. केवल दें **Storage Blob Data Reader**, जिसे storage account के बजाय विशिष्ट container तक scoped किया गया हो।
3. को [वर्कलोड आइडेंटिटी](#use-workload-identity-federation) एक [SAS](#use-a-container-sas-token) या एक [client secret](#use-a-service-principal)से, क्योंकि ये दोनों चुपचाप expire हो जाते हैं और mirroring रोक देते हैं।
4. क्रेडेंशियल केवल Roboflow Workspace में संग्रहीत करें [क्रेडेंशियल्स](https://app.roboflow.com/settings/thirdpartykeys) या अपने स्वयं के secret manager के ऊपर।
5. आप किसी भी समय role assignment हटाकर, federated credential मिटाकर, या SAS revoke करके Roboflow की access रद्द कर सकते हैं।

Microsoft Entra issuer, subject, और audience पर federated credential को बिल्कुल और case-sensitively match करता है। यह ऐसे values स्वीकार करता है जो match नहीं करते और फिर error रिपोर्ट किए बिना sign-in fail कर देता है, इसलिए values को फिर से टाइप करने के बजाय Create Credential modal से copy करें।

### वर्कलोड आइडेंटिटी फेडरेशन का उपयोग करें

**अनुशंसित। कोई कुंजियाँ आदान-प्रदान नहीं होतीं।** Roboflow एक Google-issued token प्रस्तुत करता है, जिसे Entra आपके container तक scoped एक short-lived access token से exchange करता है। Roboflow कोई secret store नहीं करता और आपके पास rotate या renew करने के लिए कुछ नहीं होता। Entra केवल नीचे configure किया गया federated credential store करता है।

1. Roboflow में, खोलें [एक Azure (वर्कलोड आइडेंटिटी) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/azureWorkloadIdentity). modal एक **Issuer**, एक **Subject identifier**, और एक **Audience**दिखाता है। इसे खुला रखें, आपको तीनों की आवश्यकता होगी।

   Audience आपके Workspace के लिए unique है। यही grant को आपसे जोड़ता है, इसलिए same app registration की ओर pointing किया गया कोई दूसरा Workspace Entra द्वारा rejected कर दिया जाता है।
2. एक app registration बनाएँ, या एक ऐसा reuse करें जिसे आप Roboflow के लिए रखते हैं:

   * खोलें [App registrations](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade) → **नई registration** → इसका नाम दें → **Register**.
   * कॉपी करें **Directory (tenant) ID** और **Application (client) ID** Overview पेज से।

   CLI पसंद है? दूसरा कमांड service principal बनाता है जिसके विरुद्ध step 4 में role assignment किया जाता है।

   ```sh
   az ad app create --display-name roboflow-datasource
   az ad sp create --id YOUR_APP_CLIENT_ID
   ```
3. उस app registration में एक federated credential जोड़ें:

   * अपनी app registration खोलें → **Certificates & secrets** → **Federated credentials** → **Credential जोड़ें**.
   * Federated credential scenario = **Other issuer**.
   * Roboflow modal से तीनों values दर्ज करें: **Issuer**, **Subject identifier**, और **Audience**.
   * इसे एक नाम दें, फिर **जोड़ें**.

   CLI पसंद है? modal से values को substitute करें:

   ```sh
   az ad app federated-credential create --id YOUR_APP_OBJECT_ID --parameters '{
     "name": "roboflow-datasource",
     "issuer": "https://accounts.google.com",
     "subject": "SUBJECT_FROM_MODAL",
     "audiences": ["AUDIENCE_FROM_MODAL"]
   }'
   ```

   एक app registration अधिकतम 20 federated credentials का समर्थन करता है।
4. अपनी container तक read access देने के लिए app registration को असाइन करें:

   * खोलें [Storage accounts](https://portal.azure.com/#view/Microsoft_Azure_Storage/StorageAccountsBlade) → आपका account → **Containers** → आपका container → **Access Control (IAM)** → **जोड़ें** → **Role assignment जोड़ें**.
   * Role = **Storage Blob Data Reader**, Members = आपकी app registration → **Review + assign**.

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

   ```sh
   az role assignment create \
     --assignee YOUR_APP_CLIENT_ID \
     --role "Storage Blob Data Reader" \
     --scope "/subscriptions/SUB_ID/resourceGroups/RG/providers/Microsoft.Storage/storageAccounts/ACCOUNT/blobServices/default/containers/CONTAINER"
   ```
5. modal में वापस जाएँ, tenant ID और client ID दर्ज करें, और save करें। Audience आपके लिए भर दी जाती है। आगे बढ़ें [Roboflow में क्रेडेंशियल बनाएं](#create-the-credential-in-roboflow).

Role assignments को प्रभावी होने में कुछ मिनट लग सकते हैं। यदि role असाइन करने के तुरंत बाद Datasource validation विफल हो जाती है, तो प्रतीक्षा करें और फिर से validate करें।

### Container SAS Token का उपयोग करें

**बनाने में सबसे तेज़, लेकिन यह expire हो जाता है।** एक shared access signature को Entra setup की बिल्कुल आवश्यकता नहीं होती। SAS के expire होने पर mirroring रुक जाती है, और आपको एक नया जारी करना पड़ता है, इसलिए [वर्कलोड आइडेंटिटी](#use-workload-identity-federation) को लंबे समय तक चलने वाली किसी भी चीज़ के लिए प्राथमिकता दें।

1. एक container SAS जनरेट करें **Read** और **List** permissions के साथ:

   * खोलें [Storage accounts](https://portal.azure.com/#view/Microsoft_Azure_Storage/StorageAccountsBlade) → आपका account → **Containers** → आपका container → **Shared access tokens**.
   * Permissions = **Read** और **List**. अपनी rotation schedule के अनुसार एक expiry सेट करें।
   * क्लिक करें **SAS token और URL जनरेट करें** और token या पूरा URL कॉपी करें।

   CLI पसंद है? यह SAS को आपके storage account key के साथ sign करता है, ठीक वैसे ही जैसे portal करता है। key आपकी मशीन पर रहती है और कभी Roboflow को नहीं भेजी जाती।

   ```sh
   az storage container generate-sas \
     --account-name YOUR_ACCOUNT \
     --account-key YOUR_ACCOUNT_KEY \
     --name YOUR_CONTAINER \
     --permissions rl \
     --expiry 2027-01-01T00:00Z \
     --output tsv
   ```

   इसके बजाय अपनी Entra identity से sign करने के लिए, हटाएँ `--account-key` और जोड़ें `--auth-mode login --as-user`. इसके लिए **Storage Blob Delegator** role की storage account पर आवश्यकता होती है, और Azure expiry को सात दिनों तक सीमित करता है।
2. Roboflow में, खोलें [एक Azure (SAS Token) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/azureSasToken), token पेस्ट करें, और save करें। पूरा SAS URL पेस्ट करना भी काम करता है: Roboflow केवल query string रखता है।

Roboflow token से signed expiry पढ़ता है, इसलिए Datasource validation आपको सामान्य access error रिपोर्ट करने के बजाय वह तारीख बताती है जिस दिन SAS expire हुआ। एक SAS एक bearer token है: जिसके पास भी यह होता है उसे expire होने या आपके revoke करने तक वही read access मिलता है। Audience जिस तरह federated credential को आपकी Workspace से जोड़ता है, वैसे इससे कुछ नहीं जुड़ता, इसलिए configure करने के लिए कोई per-Workspace value नहीं है।

### सर्विस प्रिंसिपल का उपयोग करें

**केवल तभी उपयोग करें जब आपका tenant federated credentials को ब्लॉक करता हो।** एक client secret expire हो जाता है और उसे rotate करना पड़ता है, जो failure mode है [वर्कलोड आइडेंटिटी](#use-workload-identity-federation) जिससे बचा जाता है।

1. एक app registration बनाएँ और उसकी **Directory (tenant) ID** और **Application (client) ID**, जैसा कि [वर्कलोड आइडेंटिटी](#use-workload-identity-federation).
2. के step 2 में है, एक client secret बनाएँ:

   * अपनी app registration खोलें → **Certificates & secrets** → **Client secrets** → **New client secret**.
   * एक description और expiry सेट करें, फिर **जोड़ें**, और तुरंत **मान** कॉपी करें। Azure इसे केवल एक बार दिखाता है।

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

   ```sh
   az ad app credential reset --id YOUR_APP_OBJECT_ID --append
   ```
3. असाइन करें **Storage Blob Data Reader** container पर, जैसा कि [वर्कलोड आइडेंटिटी](#use-workload-identity-federation).
4. Roboflow में, खोलें [एक Azure (Service Principal) credential जोड़ें](https://app.roboflow.com/settings/thirdpartykeys#create/azureServicePrincipal), tenant ID, client ID, और secret दर्ज करें, और save करें।

secret expire होने से पहले calendar reminder सेट करें। तब mirroring रुक जाती है।

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

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

1. पर जाएँ [क्रेडेंशियल्स](https://app.roboflow.com/settings/thirdpartykeys#create) वर्कस्पेस सेटिंग्स में।
2. क्लिक करें **क्रेडेंशियल जोड़ें** (या एक type-specific link का उपयोग करें: [वर्कलोड आइडेंटिटी](https://app.roboflow.com/settings/thirdpartykeys#create/azureWorkloadIdentity), [SAS Token](https://app.roboflow.com/settings/thirdpartykeys#create/azureSasToken), [सर्विस प्रिंसिपल](https://app.roboflow.com/settings/thirdpartykeys#create/azureServicePrincipal)).
3. जो Azure credential type आपने सेट up किया है, उसे चुनें।
4. tenant ID और client ID दर्ज करें ([वर्कलोड आइडेंटिटी](#use-workload-identity-federation)), SAS token ([कंटेनर SAS](#use-a-container-sas-token)), या tenant ID, client ID, और secret ([सर्विस प्रिंसिपल](#use-a-service-principal)).
5. क्रेडेंशियल सहेजें।
6. जब आप बनाते हैं तब उस क्रेडेंशियल का चयन करें [डेटासोर्स](https://app.roboflow.com/settings/datasources#create).

जब आप Datasource बनाते हैं, तो पूरा container URL (`https://ACCOUNT.blob.core.windows.net/CONTAINER`) को container field में पेस्ट करें। Roboflow आपके लिए storage account भर देता है। केवल container name भी काम करता है, बशर्ते आप storage account स्वयं दर्ज करें।

## अगला चरण

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