सुरक्षित स्टोर का इस्तेमाल करना

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़.
जानकारी

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

सुरक्षित स्टोर सेवा की मदद से, अपने स्टोर की संवेदनशील जानकारी सेव की जा सकती है. जैसे, बैक-एंड सेवाएं, एन्क्रिप्ट यानी सुरक्षित की गई हों, ताकि उन्हें बिना अनुमति के इस्तेमाल किए जाने से बचाया जा सके. ये सुरक्षित स्टोरेज की जगहों को "वॉल्ट" कहा जाता है. इनका दायरा Apigee Edge पर एनवायरमेंट के लेवल की जानकारी देता है.

उदाहरण के लिए, सिक्योर स्टोर का इस्तेमाल Node.js के लिए ज़रूरी पासवर्ड सेव करने के लिए किया जा सकता है ताकि आप डेटाबेस सर्वर जैसे किसी सुरक्षित संसाधन तक पहुंच सकें. आप में साइन-इन करने का विकल्प होता है, और ऐप्लिकेशन रनटाइम पर वैल्यू.

ऐसा करने से, सोर्स कोड कंट्रोल में पासवर्ड शामिल करने की ज़रूरत नहीं होती सिस्टम या Apigee Edge में इसे Node.js सोर्स कोड के साथ डिप्लॉय कर सकता है. इसके बजाय, वैल्यू यह है Apigee के ज़रिए एन्क्रिप्ट यानी सुरक्षित किए गए फ़ॉर्म में सेव किया जाता है और ऐप्लिकेशन को ज़रूरत के मुताबिक ही यह वापस लाया जाएगा इसे.

सुरक्षित स्टोर एपीआई से जुड़े दस्तावेज़ देखने के लिए, Vaults देखें. नीचे दिए सेक्शन में, .

इसके अनुसार डेटा संग्रहित किया जा रहा है संगठन

हर Apigee Edge संगठन के पास सुरक्षित स्टोर का एक सेट होता है. साथ ही, हर एनवायरमेंट में अतिरिक्त स्टोर. इस तरह, अलग-अलग संगठनों के लिए अलग-अलग पीछे के हिस्से में अलग-अलग सुरक्षित वैल्यू स्टोर की जा सकती हैं. इस सेक्शन में, संगठन के हिसाब से डेटा सेव करने के बारे में बताया गया है.

इस्तेमाल

  • सभी सुरक्षित स्टोर के नाम वापस पाएं:
GET /o/{organization}/vaults
  • नाम वाले वॉल्ट से एंट्री की सूची (लेकिन उनकी एन्क्रिप्ट की गई वैल्यू नहीं) वापस पाएं.
GET /o/{organization}/vaults/{name}
  • कोई एक एंट्री वापस पाएं (लेकिन उसकी एन्क्रिप्ट (सुरक्षित) की गई वैल्यू नहीं).

GET /o/{organization}/vaults/{name}/entries/{entryname}
  • "नाम" नाम से नया वॉल्ट बनाएं बिना किसी मान के:

POST /o/{organization}/vaults

{ "name": "{name}" }

curl https://api.enterprise.apigee.com/v1/o/testorg/vaults
  -H "Content-Type: application/json"
  -d '{"name": "test2" }' -X POST
  • तय किए गए नाम और सुरक्षित वैल्यू के साथ, वॉल्ट में नई एंट्री करें.

POST /o/{organization}/vaults/{vaultname}/entries

{ "name": "{entryname}", "value": "{securevalue}" }


curl https://api.enterprise.apigee.com/v1/o/testorg/vaults/test2/entries
  -H "Content-Type: application/json"
  -d '{"name": "value1", "value": "verysecret" }' -X POST
  • दर्ज की गई वैल्यू को नई वैल्यू से बदलें:

PUT /o/{organization}/vaults/{vaultname}/entries/{entryname}

curl https://api.enterprise.apigee.com/v1/o/testorg/vaults/test2/entries/value1

  -d 'verymoresecret' -X PUT
  • "सही" रिटर्न करें अगर बताई गई वैल्यू, स्टोर में पहले से मौजूद वैल्यू से मेल खाती है और "गलत" है अगर नहीं है. दोनों मामलों में, एचटीटीपी स्टेटस कोड 200 का इस्तेमाल किया जाता है. इसका इस्तेमाल पुष्टि करने के लिए किया जा सकता है स्टोर के कॉन्टेंट के लिए. ध्यान दें कि एक बार स्टोर हो जाने के बाद, एन्क्रिप्ट (सुरक्षित) नहीं किए गए डेटा को वापस पाने के लिए कोई एपीआई नहीं होता मान:

    POST /o/{organization}/vaults/{vaultname}/entries/{entryname}?action=verify
    
    curl https://api.enterprise.apigee.com/v1/o/testorg/vaults/test2/entries/value1?action=verify
      -d 'verymoresecret'  -X POST
    
  • चुनी गई Vault एंट्री मिटाएं:
DELETE /o/{organization}/vaults/{vaultname}/entries/{entryname}
  • पूरा वॉल्ट मिटाएं.

    DELETE /o/{organization}/vaults/{name}
    

एनवायरमेंट के हिसाब से डेटा सेव करना

Apigee Edge एनवायरमेंट के हिसाब से भी डेटा सेव किया जा सकता है. इस मामले में, डेटा का दायरा एनवायरमेंट (जैसे कि "प्रोडक्शन"). इस सुविधा की मदद से, रनटाइम के दौरान अलग-अलग वैल्यू सेव की जा सकती हैं यह इस बात पर निर्भर करता है कि Node.js स्क्रिप्ट कहां चल रही है.

इस्तेमाल

GET /o/{organization}/e/{env}/vaults

GET /o/{organization}/e/{env}/vaults/{name}

GET /o/{organization}/e/{env}/vaults/{name}/entries/{entryname}

POST /o/{organization}/e/{env}/vaults

POST /o/{organization}/e/{env}/vaults/{vaultname}/entries

PUT /o/{organization}/e/{env}/vaults/{vaultname}/entries/{entryname}

POST /o/{organization}/e/{env}/vaults/{vaultname}/entries/{entryname}?action=verify

DELETE /o/{organization}/e/{env}/vaults/{vaultname}/entries/{entryname}

DELETE /o/{organization}/e/{env}/vaults/{name}

इसमें सुरक्षित स्टोर से वैल्यू वापस लाई जा रही हैं Node.js

इंस्टॉल हो रहा है apigee-access

अपने Node.js कोड में apigee-access का इस्तेमाल करने के लिए, आपको इसे इंस्टॉल करना होगा चुनें. उदाहरण के लिए:

  1. cd अपने प्रोजेक्ट की रूट डायरेक्ट्री में जोड़ें.
  2. लागू करें: npm install apigee-access --save

फ़ंक्शन

किसी खास Vault को वापस पाने के लिए, apigee-access getVault() फ़ंक्शन का इस्तेमाल किया जाता है. इसके लिए, या तो संगठन या मौजूदा वातावरण के आधार पर जिसमें Node.js कोड चल रहा है.

getVault() दो पैरामीटर लेता है:

  • वापस पाने के लिए सुरक्षित स्टोर का नाम.
  • स्कोप जो organization या environment हो सकता है. अगर नहीं बताए गए हैं, तो organization माना जाता है.

getVault() से लौटाए गए ऑब्जेक्ट के दो फ़ंक्शन हैं:

  • getKeys(callback): वह अरे दिखाएं जिसमें सभी कुंजियों के नाम हों चुना गया वॉल्ट. कॉलबैक फ़ंक्शन को दो आर्ग्युमेंट के साथ कॉल किया जाएगा: एक गड़बड़ी अगर कार्रवाई नहीं हो सकी या "तय नहीं है" और दूसरे आर्ग्युमेंट के तौर पर असल अरे का इस्तेमाल करें.
  • get(key, कॉलबैक): किसी खास प्रॉपर्टी से जुड़ी सुरक्षित वैल्यू दिखाता है बटन दबाएं. कॉलबैक फ़ंक्शन को दो आर्ग्युमेंट के साथ कॉल किया जाएगा: कार्रवाई पूरी न होने पर एक गड़बड़ी, या "तय नहीं है" और दूसरा तर्क के रूप में वास्तविक मान का इस्तेमाल करें.

उदाहरण

यहां Node.js का सैंपल दिया गया है. इसमें वॉल्ट से वैल्यू पाने का तरीका बताया गया है. कॉन्टेंट बनाने इस कोड के काम करने के लिए, apigee-access मॉड्यूल इंस्टॉल किया गया है, जैसा कि ज़्यादा जानकारी दी गई है पहले इस्तेमाल कर रहे थे.

var apigee = require('apigee-access');
   var orgVault = apigee.getVault('vault1', 'organization');
   orgVault.get('key1', function(err, secretValue) {
   // use the secret value here
});