Roboflow के साथ साइन इन करें (शुरुआत)

आप ऐसे एप्लिकेशन बना सकते हैं जो PKCE के साथ OAuth 2.1 प्राधिकरण कोड प्रवाह का उपयोग करके उपयोगकर्ताओं को उनके Roboflow खाते से प्रमाणित करते हैं। इससे आपका ऐप Roboflow उपयोगकर्ता की ओर से कार्य कर सकता है, केवल उन अनुमतियों तक सीमित जो वे स्वीकृत करते हैं।

OAuth एक्सेस टोकन काम करते हैं api.roboflow.com के साथ Authorization: Bearer. देखें REST API से प्रमाणीकरण करें विवरण के लिए।

एंडपॉइंट तालिकाओं, दृश्यता, त्रुटियों, और एक चलाने योग्य नमूना ऐप के लिए, देखें Roboflow के साथ साइन इन करें (डेवलपर संदर्भ).

एक OAuth ऐप बनाएं

अपने एप्लिकेशन को पंजीकृत करने के लिए:

1

डेवलपर सेटिंग्स खोलें

पर जाएँ Workspace Settings > Developer अपने Roboflow डैशबोर्ड में app.roboflow.com.

2

एक नया OAuth ऐप बनाएं

क्लिक करें OAuth ऐप बनाएं (या नया ऐप) और भरें:

फ़ील्ड

विवरण

नाम

सहमति स्क्रीन और आपकी OAuth ऐप सूची में प्रदर्शित नाम

होमपेज URL

आपका उत्पाद URL (सहमति पर दिखाया जाता है; सूचनात्मक)

रीडायरेक्ट URI

एक या अधिक कॉलबैक URL (आपके कोड से बिल्कुल मेल खाने चाहिए)

टोकन एंडपॉइंट प्रमाणीकरण

क्लाइंट अपने सीक्रेट को टोकन एंडपॉइंट पर कैसे भेजता है: client_secret_post (अनुरोध बॉडी में सीक्रेट, डिफ़ॉल्ट) या client_secret_basic (HTTP Basic Authorization हेडर में सीक्रेट). अधिकांश MCP गेटवे (Azure, TrueFoundry) उपयोग करते हैं client_secret_basic.

अनुमत स्कोप

साइन-इन पर आप जिन भी स्कोप का अनुरोध करेंगे, वे सभी

दृश्यता

आंतरिक, सूचीबद्ध नहीं, या सार्वजनिक - देखें डेवलपर संदर्भ - दृश्यता

आपको एक क्लाइंट ID और क्लाइंट सीक्रेट (rfcs_…). सीक्रेट केवल एक बार दिखाया जाता है, इसलिए इसे अपने सर्वर पर सुरक्षित रूप से संग्रहीत करें।

रीडायरेक्ट URI उदाहरण

सार्वजनिक होस्ट के लिए HTTPS आवश्यक है। HTTP केवल लूपबैक (localhost, 127.0.0.1, ::1).

प्राधिकरण प्रवाह

Roboflow PKCE (Proof Key for Code Exchange) के साथ authorization code grant का उपयोग करता है। सभी क्लाइंट्स के लिए PKCE आवश्यक है।

1

एक PKCE code verifier और challenge जनरेट करें

एक यादृच्छिक code_verifier (43–128 वर्ण) बनाएं और उससे एक code_challenge SHA-256 का उपयोग करके इसे व्युत्पन्न करें:

कॉपी करें

import hashlib, base64, secrets

code_verifier = secrets.token_urlsafe(32)
code_challenge = base64.urlsafe_b64encode(
    hashlib.sha256(code_verifier.encode()).digest()
).rstrip(b"=").decode()

2

उपयोगकर्ता को अधिकृत करने के लिए पुनर्निर्देशित करें

उपयोगकर्ता को Roboflow प्राधिकरण एंडपॉइंट पर भेजें:

कॉपी करें

https://app.roboflow.com/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://yourapp.com/callback&
  response_type=code&
  scope=openid profile email workspace:read&
  code_challenge=YOUR_CODE_CHALLENGE&
  code_challenge_method=S256&
  state=YOUR_STATE_VALUE

क्रिप्टोग्राफ़िक रूप से यादृच्छिक state का उपयोग करें और कॉलबैक पर सत्यापित करें। इसे code_verifier सर्वर-साइड पर तब तक संग्रहीत करें जब तक आप कोड का आदान-प्रदान न कर लें।

उपयोगकर्ता को उन अनुमतियों के साथ एक सहमति स्क्रीन दिखाई देती है जिनका आपके ऐप ने अनुरोध किया था।

उनके स्वीकृत करने के बाद, Roboflow आपके redirect_uri के साथ कोड और state.

3

के लिए कोड का आदान-प्रदान करें

अपने सर्वर पर (कभी भी ब्राउज़र में नहीं), टोकन एंडपॉइंट पर POST करें:

कॉपी करें

curl -X POST https://app.roboflow.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=https://yourapp.com/callback" \
  -d "code_verifier=YOUR_CODE_VERIFIER"

प्रतिक्रिया में शामिल हैं:

• access_token - Roboflow APIs कॉल करें (1 घंटे के लिए मान्य, या MCP क्लाइंट्स के लिए 24 घंटे)

• refresh_token - नए access tokens प्राप्त करें (30 दिनों के लिए मान्य)

• id_token - पहचान दावों वाला JWT (जब openid का अनुरोध किया जाता है)

OAuth टोकन का उपयोग

एक बार आपके पास access token हो, इसे Authorization हेडर में भेजें:

एक टोकन सत्यापित करें

यदि आपके पास एक अपारदर्शी rfoa_ access token है और आपको client credentials के बिना इसकी स्थिति या expiry की जांच करनी है, तो validate endpoint को कॉल करें:

प्रतिक्रिया (हमेशा HTTP 200):

एक समाप्त या निरस्त टोकन लौटाता है { "active": false, "exp": null, ... } HTTP त्रुटि के बजाय, ताकि कॉलर यह भेद कर सकें कि टोकन निष्क्रिय है या प्राधिकरण सर्वर तक पहुँचा नहीं जा सकता।

एक टोकन रीफ़्रेश करें

एक्सेस टोकन 1 घंटे के बाद समाप्त हो जाते हैं (MCP क्लाइंट्स के लिए 24 घंटे)। नया टोकन पाने के लिए refresh token का उपयोग करें:

एक टोकन रद्द करें

एक access या refresh token को रद्द करने के लिए:

उपयोगकर्ता जानकारी

प्रमाणित उपयोगकर्ता के लिए प्रोफ़ाइल जानकारी प्राप्त करें (आवश्यक है openid):

उपलब्ध स्कोप

आपका ऐप निम्नलिखित में से किसी भी संयोजन के स्कोप का अनुरोध कर सकता है। प्रत्येक स्कोप को आपके OAuth ऐप की अनुमत स्कोप सूची में भी सक्षम होना चाहिए।

पहचान स्कोप

API स्कोप

OIDC खोज

Roboflow मानक OpenID Connect खोज दस्तावेज़ प्रकाशित करता है:

• OpenID कॉन्फ़िगरेशन: https://app.roboflow.com/.well-known/openid-configuration

• JWKS (ID टोकन सत्यापित करने के लिए): https://app.roboflow.com/.well-known/jwks.json

अगले चरण

• Roboflow के साथ साइन इन करें (डेवलपर संदर्भ) - होस्ट, दृश्यता, त्रुटियाँ, उदाहरण ऐप

• REST API से प्रमाणीकरण करें