Directions API (Legacy)-এর সাথে API Key ব্যবহার করুন

যথাযথ প্রমাণীকরণ তথ্য প্রদানকারীদের কাছে এপিআই কল সীমাবদ্ধ করার মাধ্যমে গুগল ম্যাপস প্ল্যাটফর্মের পণ্যগুলোকে অননুমোদিত ব্যবহার থেকে সুরক্ষিত রাখা হয়। এই তথ্যগুলো একটি এপিআই কী-এর আকারে থাকে – এটি একটি অনন্য আলফানিউমেরিক স্ট্রিং যা আপনার গুগল বিলিং অ্যাকাউন্টকে আপনার প্রোজেক্ট এবং নির্দিষ্ট এপিআই বা এসডিকে-এর সাথে সংযুক্ত করে।

এই নির্দেশিকায় দেখানো হয়েছে কীভাবে গুগল ম্যাপস প্ল্যাটফর্মের জন্য আপনার এপিআই কী তৈরি, সীমাবদ্ধ এবং ব্যবহার করতে হয়।

শুরু করার আগে

Directions API (Legacy) ব্যবহার শুরু করার আগে, আপনার একটি বিলিং অ্যাকাউন্টসহ প্রজেক্ট এবং Directions API (Legacy) সক্রিয় করা থাকতে হবে। আরও জানতে, ক্লাউড কনসোলে সেট আপ দেখুন।

এপিআই কী তৈরি করা

এপিআই কী হলো একটি অনন্য শনাক্তকারী, যা ব্যবহার এবং বিলিংয়ের উদ্দেশ্যে আপনার প্রোজেক্টের সাথে যুক্ত অনুরোধগুলোকে প্রমাণীকরণ করে। আপনার প্রোজেক্টের সাথে অবশ্যই অন্তত একটি এপিআই কী যুক্ত থাকতে হবে।

একটি এপিআই কী তৈরি করতে:

কনসোল

1. গুগল ম্যাপস প্ল্যাটফর্ম > ক্রেডেনশিয়ালস পৃষ্ঠায় যান।

   ক্রেডেনশিয়াল পৃষ্ঠায় যান

2. ক্রেডেনশিয়ালস পেজে, ক্রিয়েট ক্রেডেনশিয়ালস > এপিআই কী-তে ক্লিক করুন।
   এপিআই কী তৈরি করা ডায়ালগ বক্সে আপনার সদ্য তৈরি করা এপিআই কী-টি প্রদর্শিত হয়।
3. বন্ধ করুন-এ ক্লিক করুন।
   নতুন এপিআই কী-টি ক্রেডেনশিয়ালস পৃষ্ঠার এপিআই কী (API keys) অংশে তালিকাভুক্ত করা আছে।
   (প্রোডাকশনে ব্যবহার করার আগে এপিআই কী-টি সীমাবদ্ধ করতে মনে রাখবেন।)

ক্লাউড এসডিকে

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

গুগল ক্লাউড এসডিকে , ক্লাউড এসডিকে ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলো সম্পর্কে আরও পড়ুন:

• gcloud services api-keys create

এপিআই কী সীমাবদ্ধ করা

গুগল দৃঢ়ভাবে সুপারিশ করে যে আপনি আপনার এপিআই কী-গুলির ব্যবহার শুধুমাত্র আপনার অ্যাপ্লিকেশনের জন্য প্রয়োজনীয় এপিআই-গুলিতে সীমাবদ্ধ রাখুন। এপিআই কী-গুলি সীমাবদ্ধ করা আপনার অ্যাপ্লিকেশনকে অযাচিত অনুরোধ থেকে রক্ষা করে এর নিরাপত্তা বাড়ায়। সীমাবদ্ধতাহীন এপিআই কী-গুলির অপব্যবহারের কারণে সৃষ্ট খরচের জন্য আপনি আর্থিকভাবে দায়ী থাকবেন। আরও তথ্যের জন্য, এপিআই নিরাপত্তার সর্বোত্তম অনুশীলনগুলি দেখুন।

ক্লাউড কনসোলে কোনো এপিআই কী সীমাবদ্ধ করার সময়, অ্যাপ্লিকেশন সীমাবদ্ধতাগুলো এপিআই সীমাবদ্ধতার অধীনে সক্রিয় করা যেকোনো এপিআইকে বাতিল করে দেয়। প্রতিটি অ্যাপের জন্য এবং সেই অ্যাপটি যে যে প্ল্যাটফর্মে উপলব্ধ, তার প্রতিটির জন্য একটি পৃথক এপিআই কী তৈরি করে সর্বোত্তম অনুশীলন অনুসরণ করুন।

একটি API কী সীমাবদ্ধ করতে:

কনসোল

1. গুগল ম্যাপস প্ল্যাটফর্ম > ক্রেডেনশিয়ালস পৃষ্ঠায় যান।

   ক্রেডেনশিয়াল পৃষ্ঠায় যান

2. যে API কী-টির উপর আপনি বিধিনিষেধ আরোপ করতে চান, সেটি নির্বাচন করুন। API কী প্রপার্টি পেজটি প্রদর্শিত হবে।
3. 'মূল বিধিনিষেধ'- এর অধীনে, নিম্নলিখিত বিধিনিষেধগুলি সেট করুন:
• আবেদনের সীমাবদ্ধতা:
1. আপনার সরবরাহ করা ওয়েব সার্ভার আইপি অ্যাড্রেসের তালিকা থেকে অনুরোধ গ্রহণ করতে, অ্যাপ্লিকেশন সীমাবদ্ধতার তালিকা থেকে আইপি অ্যাড্রেস (ওয়েব সার্ভার, ক্রন জব ইত্যাদি) নির্বাচন করুন। CIDR নোটেশন ব্যবহার করে এক বা একাধিক IPv4 বা IPv6 অ্যাড্রেস, অথবা সাবনেট নির্দিষ্ট করুন। আইপি অ্যাড্রেসগুলো অবশ্যই গুগল ম্যাপস প্ল্যাটফর্ম সার্ভারগুলোর পর্যবেক্ষণ করা সোর্স অ্যাড্রেসের সাথে মিলতে হবে। আপনি যদি নেটওয়ার্ক অ্যাড্রেস ট্রান্সলেশন (NAT) ব্যবহার করেন, তবে এটি সাধারণত আপনার মেশিনের পাবলিক আইপি অ্যাড্রেসের সাথে মিলে যাবে।
• এপিআই সীমাবদ্ধতা:
1. রেস্ট্রিক্ট কী-তে ক্লিক করুন।
2. 'Select APIs' ড্রপডাউন থেকে 'Directions API (Legacy)' নির্বাচন করুন। যদি 'Directions API (Legacy)' তালিকাভুক্ত না থাকে, তবে আপনাকে এটি সক্রিয় করতে হবে।
4. আপনার পরিবর্তনগুলো চূড়ান্ত করতে, সেভ-এ ক্লিক করুন।
   

ক্লাউড এসডিকে

সতর্কীকরণ: gcloud alpha services api-keys update কমান্ডটি চালালে API কী-এর উপর থাকা যেকোনো বিদ্যমান বিধিনিষেধ প্রতিস্থাপিত হয়। এটি কমান্ডে প্রদত্ত নতুন বিধিনিষেধগুলোকে বিদ্যমান বিধিনিষেধের সাথে যুক্ত করে না।

বিদ্যমান কী-গুলো তালিকাভুক্ত করুন।

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

বিদ্যমান চাবির উপর থাকা বিধিনিষেধগুলো অপসারণ করুন।

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

বিদ্যমান কী-এর উপর নতুন বিধিনিষেধ আরোপ করুন।

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=directions-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

গুগল ক্লাউড এসডিকে , ক্লাউড এসডিকে ইনস্টলেশন এবং নিম্নলিখিত কমান্ডগুলো সম্পর্কে আরও পড়ুন:

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

আপনার অনুরোধে এপিআই কী যোগ করা

প্রতিটি Directions API (Legacy) অনুরোধের সাথে আপনাকে অবশ্যই একটি API কী অন্তর্ভুক্ত করতে হবে। নিম্নলিখিত উদাহরণে, YOUR_API_KEY এর জায়গায় আপনার API কী বসান।

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key= YOUR_API_KEY

যেসব অনুরোধে এপিআই কী ব্যবহার করা হয়, সেগুলোর জন্য HTTPS আবশ্যক।

দ্রষ্টব্য: ওয়েব সার্ভিস ব্যবহার করার সময়, প্যারামিটারের ভেতরের সমস্ত বিশেষ অক্ষর অবশ্যই ইউআরএল এনকোড করতে হবে। বৈধ হওয়ার জন্য ইউআরএল অবশ্যই সঠিকভাবে এনকোড করা আবশ্যক এবং সমস্ত ওয়েব সার্ভিসের জন্য এর অক্ষর সংখ্যা ২০৪৮-এ সীমাবদ্ধ। আপনার ইউআরএল তৈরি করার সময় এই সীমাবদ্ধতা সম্পর্কে সচেতন থাকুন। বিভিন্ন ব্রাউজার, প্রক্সি এবং সার্ভারের ইউআরএল অক্ষর সীমাও ভিন্ন হতে পারে।