पते की पुष्टि करने वाले एपीआई के साथ एपीआई पासकोड का इस्तेमाल करना

Google Maps Platform के प्रॉडक्ट को बिना अनुमति इस्तेमाल किए जाने से सुरक्षित रखा जाता है. इसके लिए, एपीआई कॉल को उन लोगों तक सीमित किया जाता है जो पुष्टि करने के लिए सही क्रेडेंशियल देते हैं. ये क्रेडेंशियल, एपीआई पासकोड के रूप में होते हैं - अक्षरों और अंकों से बनी एक यूनीक स्ट्रिंग, जो आपके Google बिलिंग खाते को आपके प्रोजेक्ट और एपीआई या SDK टूल से जोड़ती है.

इस गाइड में Google Maps Platform के लिए एपीआई पासकोड बनाने, उस पर पाबंदी लगाने, और उसे इस्तेमाल करने का तरीका बताया गया है.

एपीआई पासकोड बनाना

एपीआई पासकोड एक यूनीक आइडेंटिफ़ायर है, जो इस्तेमाल और बिलिंग के मकसद से आपके प्रोजेक्ट से जुड़े अनुरोधों की पुष्टि करता है. आपके पास अपने प्रोजेक्ट के साथ कम से कम एक एपीआई पासकोड होना ज़रूरी है.

एपीआई पासकोड बनाने के लिए:

कंसोल

  1. Google Maps Platform > क्रेडेंशियल पेज पर जाएं.

    क्रेडेंशियल पेज पर जाएं

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
    एपीआई पासकोड बनाया गया डायलॉग, आपकी नई बनाई गई एपीआई पासकोड दिखाता है.
  3. बंद करें पर क्लिक करें.
    नई एपीआई कुंजी, क्रेडेंशियल पेज पर एपीआई पासकोड में मौजूद होती है.
    (प्रोडक्शन में एपीआई कुंजी का इस्तेमाल करने से पहले, एपीआई कुंजी पर पाबंदी लगाना न भूलें.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

एपीआई पासकोड पर पाबंदी लगाना

Google का सुझाव है कि आप अपनी एपीआई कुंजियों को प्रतिबंधित करें. इसके लिए, उनके इस्तेमाल को सिर्फ़ उन एपीआई तक सीमित करें जो आपके ऐप्लिकेशन के लिए ज़रूरी हैं. एपीआई पासकोड पर पाबंदी लगाने से, आपके ऐप्लिकेशन को बिना अनुमति वाले अनुरोधों से सुरक्षित रखा जाता है. ज़्यादा जानकारी के लिए, एपीआई की सुरक्षा के सबसे सही तरीके देखें.

किसी एपीआई पासकोड पर पाबंदी लगाने के लिए:

कंसोल

  1. Google Maps Platform > क्रेडेंशियल पेज पर जाएं.

    क्रेडेंशियल पेज पर जाएं

  2. वह एपीआई पासकोड चुनें जिस पर पाबंदी सेट करनी है. आपको एपीआई पासकोड प्रॉपर्टी पेज दिखेगा.
  3. मुख्य पाबंदियां में जाकर, इन पाबंदियों को सेट करें:
    • ऐप्लिकेशन से जुड़ी पाबंदियां:
      1. आपने जो वेब सर्वर आईपी पते दिए हैं उनकी सूची से अनुरोधों को स्वीकार करने के लिए, ऐप्लिकेशन से जुड़ी पाबंदियों की सूची में से आईपी पते (वेब सर्वर, क्रॉन जॉब वगैरह) चुनें. सीआईडीआर नोटेशन का इस्तेमाल करके एक या उससे ज़्यादा आईपीवी4 या आईपीवी6 पता या सबनेट बताएं. आईपी पते, Google Maps Platform के सर्वर पर मौजूद सोर्स के पते से मेल खाने चाहिए. नेटवर्क अड्रेस ट्रांसलेशन (एनएटी) का इस्तेमाल करने पर, आम तौर पर यह आपकी मशीन के सार्वजनिक आईपी पते से मेल खाएगा.
    • एपीआई से जुड़ी पाबंदियां:
      1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
      2. एपीआई चुनें ड्रॉपडाउन से पते की पुष्टि करने वाला एपीआई चुनें. अगर पते की पुष्टि करने वाला एपीआई सूची में नहीं है, तो आपको उसे enable करना होगा.
  4. अपने बदलावों को पूरा करने के लिए, सेव करें पर क्लिक करें.

Cloud SDK

मौजूदा कुंजियों की सूची बनाएं.

gcloud services api-keys list --project="PROJECT"

मौजूदा कुंजी पर लागू पाबंदियां हटाएं.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

मौजूदा कुंजी पर नई पाबंदियां सेट करें.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="addressvalidation.googleapis.com"
    --allowed-ips="IP_ADDRESS"

Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

अपने अनुरोध में एपीआई पासकोड जोड़ना

आपको हर पते की पुष्टि करने वाले एपीआई अनुरोध के साथ, एपीआई पासकोड शामिल करना होगा. नीचे दिए गए उदाहरण में, YOUR_API_KEY को अपने एपीआई पासकोड से बदलें.

https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY

एचटीटीपीएस, एपीआई पासकोड का इस्तेमाल करने वाले अनुरोधों के लिए ज़रूरी है.