নিরাপদ দোকান ব্যবহার করে

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

নিরাপদ স্টোর পরিষেবা API ব্যবহার করে

নিরাপদ স্টোর পরিষেবা আপনাকে সংবেদনশীল ডেটা সংরক্ষণ করতে দেয়, যেমন ব্যাক-এন্ড পরিষেবাগুলির জন্য নিরাপত্তা শংসাপত্রগুলি, এনক্রিপ্ট করা ফর্ম্যাটে যাতে সেগুলি অননুমোদিত ব্যবহার থেকে সুরক্ষিত থাকে৷ এই নিরাপদ সঞ্চয়স্থানগুলিকে "ভল্ট" বলা হয়, এবং অ্যাপিজি এজ-এ সংস্থা বা পরিবেশের স্তরগুলিতে স্কোপ করা যেতে পারে।

উদাহরণস্বরূপ, একটি সুরক্ষিত সংস্থান, যেমন একটি ডাটাবেস সার্ভারে পৌঁছানোর জন্য একটি Node.js অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় একটি পাসওয়ার্ড সংরক্ষণ করতে সুরক্ষিত স্টোর ব্যবহার করা যেতে পারে। আপনি স্থাপনের আগে একটি API এর মাধ্যমে সুরক্ষিত স্টোরে পাসওয়ার্ড সংরক্ষণ করতে পারেন এবং অ্যাপ্লিকেশন রানটাইমে মানটি দেখতে পারে।

এটি করার মাধ্যমে, সোর্স কোড কন্ট্রোল সিস্টেমে পাসওয়ার্ড অন্তর্ভুক্ত করার বা Apigee Edge-এ Node.js সোর্স কোডের পাশাপাশি এটি স্থাপন করার প্রয়োজন নেই। পরিবর্তে, মানটি Apigee দ্বারা এনক্রিপ্ট করা আকারে সংরক্ষণ করা হয় এবং এটি শুধুমাত্র তখনই পুনরুদ্ধার করা হবে যখন অ্যাপ্লিকেশনটির প্রয়োজন হয়।

নিরাপদ স্টোর API-এর ডকুমেন্টেশনের জন্য, ভল্ট দেখুন। নিম্নলিখিত বিভাগগুলি নিরাপদ স্টোর API ব্যবহার করার একটি ওভারভিউ প্রদান করে।

সংস্থার দ্বারা ডেটা সংরক্ষণ করা

প্রতিটি 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-এর একটি HTTP স্ট্যাটাস কোড ব্যবহার করা হয়। এটি স্টোরের বিষয়বস্তু যাচাই করতে ব্যবহার করা যেতে পারে। মনে রাখবেন যে একবার সংরক্ষণ করা হলে, এনক্রিপ্ট করা মান পুনরুদ্ধার করার জন্য কোন API নেই:

    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
  • নির্দিষ্ট ভল্ট এন্ট্রি মুছুন:
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 এ সুরক্ষিত দোকান থেকে মান পুনরুদ্ধার করা হচ্ছে

এপিজি-অ্যাক্সেস ইনস্টল করা হচ্ছে

আপনার Node.js কোডে apigee-access ব্যবহার করতে, আপনাকে প্রথমে এটি ইনস্টল করতে হবে। যেমন:

  1. আপনার প্রকল্পের রুট ডিরেক্টরিতে cd.
  2. এক্সিকিউট করুন: npm install apigee-access --save

ফাংশন

apigee-access getVault() ফাংশনটি একটি নির্দিষ্ট ভল্ট পুনরুদ্ধার করতে ব্যবহৃত হয়, হয় প্রতি সংস্থা বা বর্তমান পরিবেশের উপর ভিত্তি করে যেখানে Node.js কোড চলছে।

getVault() দুটি প্যারামিটার নেয়:

  • পুনরুদ্ধার করার জন্য নিরাপদ দোকানের নাম।
  • সুযোগ, যা organization বা environment হতে পারে। যদি নির্দিষ্ট না করা হয়, তাহলে organization ধরে নেওয়া হয়।

getVault() দ্বারা প্রত্যাবর্তিত বস্তুটির দুটি ফাংশন রয়েছে:

  • getKeys(কলব্যাক) : নির্দিষ্ট ভল্টের সমস্ত কীগুলির নাম সম্বলিত একটি অ্যারে ফেরত দিন। কলব্যাক ফাংশনটি দুটি আর্গুমেন্টের সাথে কল করা হবে: অপারেশন ব্যর্থ হলে একটি ত্রুটি, অথবা "অনির্ধারিত" যদি এটি না হয়, এবং দ্বিতীয় আর্গুমেন্ট হিসাবে প্রকৃত অ্যারে।
  • get(key, callback) : একটি নির্দিষ্ট কী এর সাথে যুক্ত সুরক্ষিত মান ফেরত দিন। কলব্যাক ফাংশনটি দুটি আর্গুমেন্ট সহ কল ​​করা হবে: অপারেশন ব্যর্থ হলে একটি ত্রুটি, অথবা "অনির্ধারিত" যদি এটি না হয়, এবং দ্বিতীয় যুক্তি হিসাবে প্রকৃত মান।

উদাহরণ

এখানে একটি 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
});