গুগল ম্যাপ প্ল্যাটফর্ম নিরাপত্তা নির্দেশিকা

যেসব অ্যাপ এবং প্রকল্প গুগল ম্যাপস প্ল্যাটফর্ম এপিআই এবং এসডিকে ব্যবহার করে, তাদের নিজেদের প্রমাণীকরণের জন্য এপিআই কী বা, যদি সমর্থিত হয়, তাহলে OAuth 2.0 ব্যবহার করতে হবে ।

এই সেরা অনুশীলনগুলি আপনাকে দেখায় কিভাবে আপনার মানচিত্র প্ল্যাটফর্ম অ্যাক্সেস সুরক্ষিত করবেন।

যদি আপনি OAuth 2.0 ব্যবহার করে সার্ভার-টু-সার্ভার ট্র্যাফিক অনুমোদন করতে চান, তাহলে আপনার API ডকুমেন্টেশনে OAuth বিষয়টি সন্ধান করুন। আরও বিস্তারিত জানার জন্য সার্ভার-সাইড অ্যাপগুলির জন্য OAuth ব্যবহার করুন দেখুন।

অ্যাপ্লিকেশন এবং API কী বিধিনিষেধ প্রয়োগ করার পাশাপাশি, নির্দিষ্ট Google Maps প্ল্যাটফর্ম পণ্যগুলিতে প্রযোজ্য যেকোনো নিরাপত্তা অনুশীলন অনুসরণ করুন। উদাহরণস্বরূপ, নীচের "প্রস্তাবিত অ্যাপ্লিকেশন এবং API বিধিনিষেধ" বিভাগে Maps JavaScript API দেখুন।

যদি আপনার API কীগুলি ইতিমধ্যেই ব্যবহার করা হয়, তাহলে "আপনি যদি কোনও API কী ব্যবহারে বাধা দিচ্ছেন" বিভাগে নীচের সুপারিশগুলি পর্যালোচনা করুন।

ম্যাপস স্ট্যাটিক এপিআই এবং স্ট্রিট ভিউ স্ট্যাটিক এপিআই দ্বারা সমর্থিত ডিজিটাল স্বাক্ষর সম্পর্কে আরও তথ্যের জন্য, ডিজিটাল স্বাক্ষর নির্দেশিকা দেখুন।

প্রস্তাবিত সেরা অনুশীলন

বর্ধিত নিরাপত্তার জন্য এবং অননুমোদিত ব্যবহারের জন্য বিল করা এড়াতে, সমস্ত Google Maps প্ল্যাটফর্ম API, SDK, বা পরিষেবার জন্য এই API সুরক্ষার সেরা অনুশীলনগুলি অনুসরণ করুন:

আপনার API কীগুলি সীমাবদ্ধ করুন

প্রতিটি অ্যাপের জন্য আলাদা API কী ব্যবহার করুন

অব্যবহৃত API কীগুলি মুছুন

আপনার API কী ব্যবহার পরীক্ষা করুন

API কী ঘোরানোর সময় সতর্ক থাকুন

ক্লায়েন্ট-সাইড এবং সার্ভার-সাইড ব্যবহারকে পৃথক প্রকল্পে ভাগ করুন

অব্যবহৃত পরিষেবাগুলি অক্ষম করুন

ক্লায়েন্ট-সাইড অ্যাপের জন্য অতিরিক্ত সুপারিশ

ক্লায়েন্ট-সাইড SDK ব্যবহার করুন

নিরাপদ ক্লায়েন্ট-সাইড ওয়েব পরিষেবা কল

স্ট্যাটিক ওয়েব এপিআই ব্যবহার করে ওয়েবসাইট বা ক্লায়েন্ট-সাইড অ্যাপের জন্য অতিরিক্ত সুপারিশ

স্ট্যাটিক ওয়েব এপিআই ব্যবহার সুরক্ষিত করুন

ওয়েব পরিষেবা ব্যবহার করে সার্ভার-সাইড অ্যাপগুলির জন্য অতিরিক্ত সুপারিশ

ওয়েব পরিষেবা API কীগুলি সুরক্ষিত করুন

সার্ভার-সাইড অ্যাপের জন্য OAuth ব্যবহার করুন

যদি আপনি ব্যবহৃত কোনও API কী সীমাবদ্ধ বা ঘোরান

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

  • কী পরিবর্তন করার পর, প্রয়োজন অনুযায়ী, নতুন API কী দিয়ে আপনার সমস্ত অ্যাপ আপডেট করুন।

  • যদি আপনার API কীটি আপোস না করা হয় এবং সক্রিয়ভাবে অপব্যবহার না করা হয়, তাহলে আপনি আপনার নিজস্ব গতিতে একাধিক নতুন API কীতে আপনার অ্যাপগুলি স্থানান্তর করতে পারেন, মূল API কীটিকে অক্ষত রেখে যতক্ষণ না আপনি কেবল এক ধরণের ট্র্যাফিক লক্ষ্য করেন এবং API কীটি অনিচ্ছাকৃত পরিষেবা ব্যাহত না করেই এক ধরণের অ্যাপ্লিকেশন বিধিনিষেধের মাধ্যমে নিরাপদে সীমাবদ্ধ করা যেতে পারে।

    আরও নির্দেশাবলীর জন্য, একাধিক API কীতে মাইগ্রেট দেখুন।

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

  • যদি আপনার API কীটি হ্যাক হয়ে থাকে, তাহলে আপনার API কীটি সুরক্ষিত করতে এবং অপব্যবহার বন্ধ করতে আপনাকে আরও দ্রুত পদক্ষেপ নিতে হবে। অ্যান্ড্রয়েড এবং iOS অ্যাপগুলিতে, গ্রাহকরা তাদের অ্যাপ আপডেট না করা পর্যন্ত কীগুলি প্রতিস্থাপন করা হয় না। ওয়েবপৃষ্ঠা বা সার্ভার-সাইড অ্যাপগুলিতে কীগুলি আপডেট করা বা প্রতিস্থাপন করা অনেক সহজ, তবে তবুও সতর্ক পরিকল্পনা এবং দ্রুত কাজের প্রয়োজন হতে পারে।

    আরও তথ্যের জন্য, API কী-এর অননুমোদিত ব্যবহার পরিচালনা করুন দেখুন।

অধিক তথ্য

প্রস্তাবিত অ্যাপ্লিকেশন এবং API বিধিনিষেধ

আপনার API কীগুলি সীমাবদ্ধ করুন

সর্বোত্তম অনুশীলন হল আপনার API কীগুলিকে সর্বদা এক ধরণের অ্যাপ্লিকেশন সীমাবদ্ধতা এবং এক বা একাধিক API সীমাবদ্ধতা দিয়ে সীমাবদ্ধ করা। API, SDK, বা JavaScript পরিষেবা দ্বারা প্রস্তাবিত বিধিনিষেধের জন্য, নীচে প্রস্তাবিত অ্যাপ্লিকেশন এবং API সীমাবদ্ধতা দেখুন।

  • অ্যাপ্লিকেশন সীমাবদ্ধতা আপনি নির্দিষ্ট প্ল্যাটফর্মগুলিতে API কী ব্যবহার সীমিত করতে পারেন: অ্যান্ড্রয়েড বা iOS অ্যাপ্লিকেশন, অথবা ক্লায়েন্ট-সাইড অ্যাপ্লিকেশনের জন্য নির্দিষ্ট ওয়েবসাইট, অথবা ওয়েব পরিষেবা REST API কল প্রদানকারী সার্ভার-সাইড অ্যাপের জন্য নির্দিষ্ট IP ঠিকানা বা CIDR সাবনেট।

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

  • API বিধিনিষেধ আপনি কোন Google Maps প্ল্যাটফর্ম API, SDK, অথবা পরিষেবাগুলিতে আপনার API কী ব্যবহার করা যাবে তা সীমাবদ্ধ করতে পারেন। API বিধিনিষেধ শুধুমাত্র আপনার নির্দিষ্ট করা API এবং SDK-তে অনুরোধ করার অনুমতি দেয়। যেকোনো API কী-এর জন্য, আপনি যতগুলি API বিধিনিষেধ প্রয়োজন ততগুলি নির্দিষ্ট করতে পারেন। উপলব্ধ API-এর তালিকায় একটি প্রকল্পে সক্ষম সমস্ত API অন্তর্ভুক্ত থাকে।

একটি API কী-এর জন্য একটি অ্যাপ্লিকেশন সীমাবদ্ধতা সেট করুন

  1. গুগল ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. আপনি যে API কীটি সীমাবদ্ধ করতে চান তা নির্বাচন করুন।

  3. এপিআই কী সম্পাদনা পৃষ্ঠায় , কী সীমাবদ্ধতার অধীনে, একটি অ্যাপ্লিকেশন সীমাবদ্ধতা সেট করুন নির্বাচন করুন।

    API কী পৃষ্ঠা সম্পাদনা করুন

  4. সীমাবদ্ধতার ধরণগুলির মধ্যে একটি নির্বাচন করুন এবং সীমাবদ্ধতার তালিকা অনুসরণ করে অনুরোধকৃত তথ্য সরবরাহ করুন।

    সীমাবদ্ধতার ধরণ বিবরণ
    ওয়েবসাইট এক বা একাধিক রেফারার ওয়েবসাইট নির্দিষ্ট করুন।
    • সর্বজনীনভাবে সমর্থিত রেফারার URI স্কিমগুলি হল https এবং http । অন্যান্য স্কিমগুলি সঠিকভাবে কাজ করবে এমন নিশ্চয়তা নেই, কারণ আধুনিক ওয়েব ব্রাউজারগুলি গোপনীয়তার কারণে বহির্গামী অনুরোধগুলিতে ``রেফারার'' হেডার পাঠাবে না।
    • সর্বদা সম্পূর্ণ রেফারার স্ট্রিং প্রদান করুন, যার মধ্যে প্রোটোকল স্কিম, হোস্টনেম এবং ঐচ্ছিক পোর্ট (যেমন, https://google.com ) অন্তর্ভুক্ত থাকবে।
    • আপনি সমস্ত সাবডোমেন অনুমোদনের জন্য ওয়াইল্ডকার্ড অক্ষর ব্যবহার করতে পারেন। উদাহরণস্বরূপ, https://*.google.com .google.com দিয়ে শেষ হওয়া সমস্ত সাইট গ্রহণ করে।
    • ফুল-পাথ রেফারার অনুমোদন করার সময় সতর্ক থাকুন, উদাহরণস্বরূপ, https://google.com/some/path , কারণ বেশিরভাগ ওয়েব ব্রাউজার গোপনীয়তার কারণে ক্রস-অরিজিন অনুরোধ থেকে পাথটি বাদ দেয়।
    আইপি ঠিকানা CIDR নোটেশন ব্যবহার করে এক বা একাধিক IPv4 বা IPv6 ঠিকানা, অথবা সাবনেট উল্লেখ করুন। IP ঠিকানাগুলি Google Maps প্ল্যাটফর্ম সার্ভারগুলি যে উৎস ঠিকানাটি পর্যবেক্ষণ করে তার সাথে মিলতে হবে। আপনি যদি নেটওয়ার্ক ঠিকানা অনুবাদ (NAT) ব্যবহার করেন, তাহলে এই ঠিকানাটি সাধারণত আপনার মেশিনের সর্বজনীন IP ঠিকানার সাথে মিলে যায়।
    অ্যান্ড্রয়েড অ্যাপস

    আপনি যে প্রতিটি অ্যান্ড্রয়েড অ্যাপ্লিকেশন অনুমোদন করতে চান তার অ্যান্ড্রয়েড প্যাকেজের নাম ( AndroidManifest.xml ফাইল থেকে) এবং SHA-1 সাইনিং সার্টিফিকেট ফিঙ্গারপ্রিন্ট যোগ করুন।

    1. অ্যান্ড্রয়েড অ্যাপস নির্বাচন করুন।
    2. + যোগ করুন এ ক্লিক করুন।
    3. আপনার প্যাকেজের নাম এবং SHA-1 সার্টিফিকেটের ফিঙ্গারপ্রিন্ট লিখুন। উদাহরণস্বরূপ: 
      com.example.android.mapexample
      BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    4. সংরক্ষণ করুন ক্লিক করুন।

    দুটি ধরণের সার্টিফিকেট রয়েছে:

    • ডিবাগ সার্টিফিকেট : শুধুমাত্র আপনার পরীক্ষা করা অ্যাপ এবং অন্যান্য নন-প্রোডাকশন কোডের ক্ষেত্রেই এই সার্টিফিকেট টাইপ ব্যবহার করুন। ডিবাগ সার্টিফিকেট দিয়ে সাইন করা অ্যাপ প্রকাশ করার চেষ্টা করবেন না। আপনি যখন ডিবাগ বিল্ড চালান তখন Android SDK টুলগুলি স্বয়ংক্রিয়ভাবে এই সার্টিফিকেট তৈরি করে।
    • রিলিজ সার্টিফিকেট : যখন আপনি আপনার অ্যাপটি অ্যাপ স্টোরে রিলিজ করার জন্য প্রস্তুত থাকবেন তখন এই সার্টিফিকেটটি ব্যবহার করুন। যখন আপনি একটি রিলিজ বিল্ড চালান তখন Android SDK টুলগুলি এই সার্টিফিকেট তৈরি করে।

    অ্যান্ড্রয়েড অ্যাপ্লিকেশন স্বাক্ষর এবং সার্টিফিকেট সম্পর্কে আরও তথ্যের জন্য, সাইন ইওর অ্যাপ নির্দেশিকা দেখুন।

    যদি আপনি Play App Signing ব্যবহার করেন, তাহলে সাইনিং সার্টিফিকেট ফিঙ্গারপ্রিন্ট আনতে, Working with API Providers দেখুন। যদি আপনি নিজের সাইনিং কী পরিচালনা করেন, তাহলে আপনার অ্যাপ্লিকেশনটি স্ব-স্বাক্ষর করা দেখুন অথবা আপনার বিল্ড পরিবেশের জন্য নির্দেশাবলী দেখুন।

    iOS অ্যাপস

    আপনি যে প্রতিটি iOS অ্যাপ্লিকেশন অনুমোদন করতে চান তার বান্ডেল শনাক্তকারী যোগ করুন।

    1. iOS অ্যাপস নির্বাচন করুন।
    2. + যোগ করুন এ ক্লিক করুন।
    3. iOS অ্যাপ থেকে অনুরোধ গ্রহণ করতে সেই আইডি দিয়ে বান্ডেল আইডি যোগ করুন।
    4. সংরক্ষণ করুন ক্লিক করুন।

    অ্যাপ্লিকেশন সীমাবদ্ধতার জন্য সুপারিশের জন্য, প্রস্তাবিত অ্যাপ্লিকেশন সীমাবদ্ধতা দেখুন।

  5. সংরক্ষণ নির্বাচন করুন।

একটি API কী-এর জন্য API সীমাবদ্ধতা সেট করুন

  1. গুগল ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. আপনি যে API কীটি সীমাবদ্ধ করতে চান তা নির্বাচন করুন।

  3. এপিআই কী সম্পাদনা পৃষ্ঠায় , এপিআই সীমাবদ্ধতার অধীনে:

    • সীমাবদ্ধ কী নির্বাচন করুন।

    • Select API গুলি খুলুন এবং API কী ব্যবহার করে আপনার অ্যাপ্লিকেশনটি যে API গুলি বা SDK গুলি অ্যাক্সেস করতে চান তা নির্বাচন করুন।

    যদি কোনও API বা SDK তালিকাভুক্ত না থাকে, তাহলে আপনাকে এটি সক্ষম করতে হবে। বিস্তারিত জানার জন্য, এক বা একাধিক API বা SDK সক্ষম করতে দেখুন।

    সম্পাদনা API কী পৃষ্ঠায় একটি API সীমাবদ্ধ করুন।

  4. সংরক্ষণ নির্বাচন করুন।

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

প্রস্তাবিত API বিধিনিষেধের জন্য, প্রস্তাবিত API বিধিনিষেধ দেখুন।

আপনার API কী ব্যবহার পরীক্ষা করুন

যদি আপনি API কী তৈরি করার পরে সেগুলো সীমাবদ্ধ করে থাকেন, অথবা আপনি যদি দেখতে চান যে কোন কী কোন API ব্যবহার করছে যাতে আপনি সেগুলো সীমাবদ্ধ করতে পারেন, তাহলে আপনার API কী ব্যবহার পরীক্ষা করতে হবে। এই ধাপগুলি আপনাকে দেখায় যে কোন পরিষেবা এবং API পদ্ধতিতে একটি API কী ব্যবহার করা হচ্ছে। যদি আপনি Google Maps Platform পরিষেবার বাইরে কোনও ব্যবহার দেখতে পান, তাহলে অবাঞ্ছিত ব্যবহার এড়াতে আপনার আরও বিধিনিষেধ যোগ করার প্রয়োজন আছে কিনা তা নির্ধারণ করতে তদন্ত করুন। আপনার API কীতে কোন API এবং অ্যাপ্লিকেশন বিধিনিষেধ প্রয়োগ করা হবে তা নির্ধারণ করতে আপনি Google Maps Platform Cloud Console Metrics Explorer ব্যবহার করতে পারেন:

আপনার API কী ব্যবহার করে এমন API গুলি নির্ধারণ করুন

নিম্নলিখিত মেট্রিক্স রিপোর্টগুলি আপনাকে নির্ধারণ করতে দেয় যে কোন APIগুলি আপনার API কী ব্যবহার করছে। নিম্নলিখিতগুলি করতে এই রিপোর্টগুলি ব্যবহার করুন:

  • আপনার API কীগুলি কীভাবে ব্যবহৃত হয় তা দেখুন
  • অপ্রত্যাশিত ব্যবহার চিহ্নিত করুন
  • একটি অব্যবহৃত কী মুছে ফেলা নিরাপদ কিনা তা যাচাই করতে সাহায্য করুন। একটি API কী মুছে ফেলা সম্পর্কে তথ্যের জন্য, অব্যবহৃত API কী মুছে ফেলুন দেখুন।

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

  1. গুগল ক্লাউড কনসোলের মেট্রিক্স এক্সপ্লোরারে যান।

  2. সাইন ইন করুন এবং আপনি যে API কীগুলি পরীক্ষা করতে চান তার জন্য প্রকল্পটি নির্বাচন করুন।

  3. আপনার ধরণের API এর জন্য মেট্রিক্স এক্সপ্লোরার পৃষ্ঠায় যান:

  4. প্রতিটি API কী পরীক্ষা করুন:

    1. ফিল্টার যোগ করুন নির্বাচন করুন।

    2. লেবেলটি নির্বাচন করুন credential_id

    3. আপনি যে কীটি পরীক্ষা করতে চান তার সাথে সম্পর্কিত মানটি নির্বাচন করুন।

    4. এই API কীটি কোন API গুলির জন্য ব্যবহার করা হচ্ছে তা লক্ষ্য করুন এবং নিশ্চিত করুন যে এটি ব্যবহার প্রত্যাশিত।

    5. একবার হয়ে গেলে, অতিরিক্ত ফিল্টারটি মুছে ফেলার জন্য সক্রিয় ফিল্টার লাইনের শেষে ফিল্টার মুছে ফেলুন করুন।

  5. বাকি যেকোনো কী-এর জন্য পুনরাবৃত্তি করুন।

  6. আপনার API কীগুলি শুধুমাত্র ব্যবহৃত API গুলিতে সীমাবদ্ধ রাখুন।

  7. যদি আপনি অননুমোদিত ব্যবহার লক্ষ্য করেন, তাহলে API কী-এর অননুমোদিত ব্যবহার পরিচালনা করুন দেখুন।

মেট্রিক্স এক্সপ্লোরার ব্যবহার করে সঠিক ধরণের অ্যাপ্লিকেশন সীমাবদ্ধতা নির্বাচন করুন।

আপনার API কীটি শুধুমাত্র Google Maps প্ল্যাটফর্ম পরিষেবাগুলির জন্য ব্যবহৃত হচ্ছে কিনা তা যাচাই করার এবং প্রয়োজনীয় পদক্ষেপ নেওয়ার পরে, API কীটিতে সঠিক অ্যাপ্লিকেশন বিধিনিষেধ রয়েছে কিনা তাও যাচাই করুন।

যদি আপনার API কীতে সুপারিশকৃত API কী বিধিনিষেধ থাকে, তাহলে সেগুলি প্রয়োগ করুন। আরও তথ্যের জন্য, সুপারিশকৃত API কী বিধিনিষেধ প্রয়োগ করুন দেখুন।

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

  1. গুগল ক্লাউড কনসোলের মেট্রিক্স এক্সপ্লোরারে যান।

  2. সাইন ইন করুন এবং আপনি যে API গুলি পরীক্ষা করতে চান তার জন্য প্রকল্পটি নির্বাচন করুন।

  3. এই মেট্রিক্স এক্সপ্লোরার পৃষ্ঠায় যান: মেট্রিক্স এক্সপ্লোরার ।

  4. প্রতিটি API কী পরীক্ষা করুন:

    1. ফিল্টার যোগ করুন নির্বাচন করুন।

    2. লেবেলটি নির্বাচন করুন credential_id

    3. আপনি যে কীটি পরীক্ষা করতে চান তার সাথে সম্পর্কিত মানটি নির্বাচন করুন।

    4. একবার হয়ে গেলে, অতিরিক্ত ফিল্টারটি মুছে ফেলার জন্য সক্রিয় ফিল্টার লাইনের শেষে ফিল্টার মুছে ফেলুন করুন।

  5. বাকি যেকোনো কী-এর জন্য পুনরাবৃত্তি করুন।

  6. একবার আপনার API কীগুলির জন্য প্ল্যাটফর্মের ধরণটি হয়ে গেলে, সেই platform_type এর জন্য অ্যাপ্লিকেশন সীমাবদ্ধতা প্রয়োগ করুন:

    PLATFORM_TYPE_JS : কী-তে ওয়েবসাইটের সীমাবদ্ধতা প্রয়োগ করুন।

    PLATFORM_TYPE_ANDROID : কী-তে অ্যান্ড্রয়েড অ্যাপ্লিকেশন বিধিনিষেধ প্রয়োগ করুন।

    PLATFORM_TYPE_IOS : কী-তে iOS অ্যাপ্লিকেশন বিধিনিষেধ প্রয়োগ করুন।

    PLATFORM_TYPE_WEBSERVICE : কীটি সঠিকভাবে সীমাবদ্ধ করার জন্য আপনাকে আইপি ঠিকানার সীমাবদ্ধতার উপর নির্ভর করতে হতে পারে ।

    ম্যাপস স্ট্যাটিক এপিআই এবং স্ট্রিট ভিউ স্ট্যাটিক এপিআই-এর সুপারিশের জন্য, প্রোটেক্ট স্ট্যাটিক ওয়েব এপিআই ব্যবহার দেখুন।

    Maps Embed API সুপারিশের জন্য, Maps Embed API সহ ওয়েবসাইটগুলি দেখুন।

    আমার API কী একাধিক প্ল্যাটফর্মের ধরণ ব্যবহার করছে: শুধুমাত্র একটি API কী দিয়ে আপনার ট্র্যাফিক সঠিকভাবে সুরক্ষিত করা যাবে না। আপনাকে একাধিক API কীতে মাইগ্রেট করতে হবে। আরও তথ্যের জন্য, একাধিক API কীতে মাইগ্রেট দেখুন।

প্রতিটি অ্যাপের জন্য আলাদা API কী ব্যবহার করুন

এই পদ্ধতি প্রতিটি কী-এর পরিধি সীমিত করে। যদি একটি API কী ক্ষতিগ্রস্ত হয়, তাহলে আপনি অন্যান্য API কী আপডেট না করেই প্রভাবিত কীটি মুছে ফেলতে বা ঘোরাতে পারেন। আপনি প্রতি প্রকল্পে সর্বাধিক 300টি API কী তৈরি করতে পারেন। আরও তথ্যের জন্য, API কী-এর সীমাবদ্ধতা দেখুন।

নিরাপত্তার জন্য প্রতিটি অ্যাপ্লিকেশনের জন্য একটি API কী আদর্শ হলেও, আপনি একাধিক অ্যাপে সীমাবদ্ধ কী ব্যবহার করতে পারেন যতক্ষণ না তারা একই ধরণের অ্যাপ্লিকেশন সীমাবদ্ধতা ব্যবহার করে।

প্রস্তাবিত API কী সীমাবদ্ধতা প্রয়োগ করুন

কিছু প্রকল্পের মালিক, সম্পাদক এবং API কী প্রশাসকদের জন্য, Google ক্লাউড কনসোল তাদের Google Maps প্ল্যাটফর্ম ব্যবহার এবং কার্যকলাপের উপর ভিত্তি করে অবাধ API কীগুলির জন্য নির্দিষ্ট API কী বিধিনিষেধের পরামর্শ দেয়।

যদি উপলভ্য থাকে, তাহলে Google Maps প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠায় সুপারিশগুলি পূর্বে পূরণ করা বিকল্প হিসাবে প্রদর্শিত হবে।

স্বয়ংক্রিয় সুপারিশ দ্বারা সমর্থিত Google Maps প্ল্যাটফর্ম API এবং SDK গুলি

  • ম্যাপস জাভাস্ক্রিপ্ট এপিআই, যার মধ্যে রয়েছে দিকনির্দেশনা পরিষেবা (উত্তরাধিকার), দূরত্ব ম্যাট্রিক্স পরিষেবা (উত্তরাধিকার), উচ্চতা পরিষেবা, জিওকোডিং পরিষেবা স্থান শ্রেণী, স্থান স্বয়ংসম্পূর্ণ উইজেট (নতুন), স্থান স্বয়ংসম্পূর্ণ ডেটা এপিআই, স্থান গ্রন্থাগার, স্থান পরিষেবা, স্থান স্বয়ংসম্পূর্ণ উইজেট এবং স্থান UI কিট।

  • ম্যাপস স্ট্যাটিক এপিআই এবং স্ট্রিট ভিউ স্ট্যাটিক এপিআই

  • ম্যাপ এম্বেড এপিআই

  • অ্যান্ড্রয়েডের জন্য ম্যাপস এসডিকে, অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে, অ্যান্ড্রয়েডের জন্য প্লেস এসডিকে এবং অ্যান্ড্রয়েডে প্লেস ইউআই কিট

  • iOS এর জন্য Maps SDK, iOS এর জন্য Navigation SDK, iOS এর জন্য Places SDK, iOS এর জন্য Places Swift SDK এবং iOS এর জন্য Places UI Kit।

যে কারণে আপনি কোনও সুপারিশ দেখতে নাও পেতে পারেন, অথবা অসম্পূর্ণ থাকতে পারেন

কোন সুপারিশ না দেখার কারণ

  • আপনি (এছাড়াও) Google Maps Platform পরিষেবাগুলি ছাড়া অন্য কোনও পরিষেবাতে API কী ব্যবহার করছেন, অথবা Maps Platform পরিষেবাগুলি যা এখনও স্বয়ংক্রিয় সুপারিশ দ্বারা সমর্থিত নয় ।

    যদি আপনি অন্যান্য পরিষেবাগুলিতে ব্যবহার দেখতে পান, তাহলে প্রথমে নিম্নলিখিতগুলি না করে সুপারিশটি প্রয়োগ করবেন না :

    1. গুগল ক্লাউড কনসোল মেট্রিক্স এক্সপ্লোরারে আপনি যে API ব্যবহারটি দেখছেন তা বৈধ কিনা তা যাচাই করুন।

    2. অনুমোদিত API গুলির তালিকায় অনুপস্থিত পরিষেবাগুলি ম্যানুয়ালি যোগ করুন ।

    3. API তালিকায় যোগ করা পরিষেবাগুলির জন্য অনুপস্থিত অ্যাপ্লিকেশন সীমাবদ্ধতাগুলি ম্যানুয়ালি যোগ করুন । যদি আপনার অন্য যোগ করা পরিষেবাগুলির জন্য ভিন্ন ধরণের অ্যাপ্লিকেশন সীমাবদ্ধতার প্রয়োজন হয়, তাহলে একাধিক API কীতে স্থানান্তর করুন দেখুন।

  • আপনার API কী ক্লায়েন্ট-সাইড SDK বা API-তে ব্যবহৃত হয় না।

  • আপনি এমন একটি কম ভলিউম অ্যাপ বা ওয়েবসাইটে API কী ব্যবহার করেন যা গত 60 দিন ধরে ব্যবহার করা হয়নি।

  • আপনি খুব সম্প্রতি একটি নতুন কী তৈরি করেছেন, অথবা আপনি খুব সম্প্রতি একটি নতুন অ্যাপে একটি বিদ্যমান কী স্থাপন করেছেন। যদি তাই হয়, তাহলে সুপারিশগুলি আপডেট হওয়ার জন্য আরও কয়েক দিন অপেক্ষা করুন।

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

অসম্পূর্ণ সুপারিশ দেখার কারণ

  • আপনি এমন একটি কম ভলিউম অ্যাপ বা ওয়েবসাইটে API কী ব্যবহার করেন যা গত 60 দিন ধরে ব্যবহার করা হয়নি।

  • আপনি সম্প্রতি একটি নতুন API বা পরিষেবাতে একটি বিদ্যমান কী ব্যবহার শুরু করেছেন এবং স্বয়ংক্রিয় API কী সীমাবদ্ধতা সুপারিশ পাইপলাইন এখনও আপডেট করা ব্যবহার মেট্রিক্স প্রক্রিয়া করেনি। ব্যবহার মেট্রিক্স প্রচারে কয়েক দিন সময় লাগতে পারে।

    যদি আপনি অন্যান্য পরিষেবাগুলিতে ব্যবহার দেখতে পান, তাহলে প্রথমে নিম্নলিখিতগুলি না করে সুপারিশটি প্রয়োগ করবেন না :

    1. গুগল ক্লাউড কনসোল মেট্রিক্স এক্সপ্লোরারে আপনি যে API ব্যবহারটি দেখছেন তা বৈধ কিনা তা যাচাই করুন।

    2. অনুমোদিত API গুলির তালিকায় অনুপস্থিত পরিষেবাগুলি ম্যানুয়ালি যোগ করুন ।

    3. API তালিকায় যোগ করা পরিষেবাগুলির জন্য অনুপস্থিত অ্যাপ্লিকেশন সীমাবদ্ধতাগুলি ম্যানুয়ালি যোগ করুন । যদি আপনার অন্য যোগ করা পরিষেবাগুলির জন্য ভিন্ন ধরণের অ্যাপ্লিকেশন সীমাবদ্ধতার প্রয়োজন হয়, তাহলে একাধিক API কীতে স্থানান্তর করুন দেখুন।

    4. যদি না আপনার জরুরিভাবে কোনও কী সীমাবদ্ধ করার প্রয়োজন হয়, উদাহরণস্বরূপ, অননুমোদিত ব্যবহারের কারণে, তাহলে সুপারিশগুলি কার্যকর হওয়ার জন্য আপনি এক বা দুই দিন অপেক্ষা করতে পারেন ।

চার্টে দৃশ্যমান নাও হতে পারে এমন সুপারিশগুলি কেন আপনি দেখতে পারেন

  • আপনার অ্যাপ বা ওয়েবসাইট খুব অল্প সময়ের জন্য ট্র্যাফিক বার্স্ট পাঠিয়েছে। এই ক্ষেত্রে, একটি CHART ভিউ থেকে একটি TABLE বা BOTH প্রদর্শন করতে স্যুইচ করুন, কারণ লেজেন্ডে ব্যবহারটি এখনও দৃশ্যমান। আরও তথ্যের জন্য, চার্টের সম্পূর্ণ লেজেন্ড টগল করা দেখুন।

  • আপনার ট্র্যাফিক Maps Embed API থেকে এসেছে। নির্দেশাবলীর জন্য, আপনার API কী ব্যবহার করে এমন API গুলি নির্ধারণ করুন দেখুন।

  • অ্যাপ বা ওয়েবসাইট থেকে আসা ট্র্যাফিক গুগল ক্লাউড কনসোল মেট্রিক্স এক্সপ্লোরারে উপলব্ধ তারিখের সীমার বাইরে।

  1. গুগল ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. যদি উপলব্ধ থাকে, তাহলে প্রস্তাবিত বিধিনিষেধ প্রয়োগ করুন নির্বাচন করুন।

    প্রস্তাবিত বিধিনিষেধ প্রয়োগ করুন

  3. API কী কোন পরিষেবাগুলিতে ব্যবহার করা হচ্ছে তা যাচাই করতে "API ব্যবহার পরীক্ষা করুন" নির্বাচন করুন। যদি আপনি Google Maps প্ল্যাটফর্ম পরিষেবা ব্যতীত অন্য পরিষেবা দেখতে পান, তাহলে উপরে সুপারিশকৃত পদক্ষেপগুলি ম্যানুয়ালি পর্যালোচনা করার জন্য বিরতি দিন । প্রস্তাবিত API কী সীমাবদ্ধতা প্রয়োগ করুন বিভাগের শুরুতে সমস্যা সমাধানের পদক্ষেপগুলি দেখুন।

  4. আপনি যে ওয়েবসাইট এবং অ্যাপগুলিতে আপনার API কী ব্যবহার করার আশা করছেন, সেখানে আগে থেকে পূরণ করা বিধিনিষেধগুলি মিলছে কিনা তা দুবার পরীক্ষা করে দেখুন।

    সর্বোত্তম পদ্ধতি : আপনার পরিষেবার সাথে সম্পর্কিত নয় এমন যেকোনো অ্যাপ্লিকেশন বা API বিধিনিষেধ ডকুমেন্ট করুন এবং অপসারণ করুন। যদি অপ্রত্যাশিত নির্ভরতার কারণে কিছু ভেঙে যায়, তাহলে আপনি প্রয়োজনীয় অ্যাপ বা API গুলি আবার যোগ করতে পারেন।

    • যদি আপনি বুঝতে পারেন যে আপনার সুপারিশ থেকে কোনও অ্যাপ, ওয়েবসাইট বা API স্পষ্টভাবে অনুপস্থিত, তাহলে এটি ম্যানুয়ালি যোগ করুন অথবা সুপারিশটি আপডেট হওয়ার জন্য কয়েক দিন অপেক্ষা করুন।

    • আপনার প্রস্তাবিত সুপারিশের জন্য আরও সাহায্যের প্রয়োজন হলে, সহায়তার সাথে যোগাযোগ করুন ।

  5. প্রয়োগ করুন নির্বাচন করুন।

সুপারিশ প্রয়োগের পরে যদি আপনার আবেদন প্রত্যাখ্যাত হয় তবে কী করবেন

যদি আপনি লক্ষ্য করেন যে কোনও অ্যাপ বা ওয়েবসাইট কোনও সীমাবদ্ধতা প্রয়োগ করার পরে প্রত্যাখ্যাত হয়েছে, তাহলে API প্রতিক্রিয়া ত্রুটি বার্তায় আপনার যে অ্যাপ্লিকেশন সীমাবদ্ধতা যুক্ত করতে হবে তা সন্ধান করুন।

ক্লায়েন্ট-সাইড SDK এবং API গুলি

ব্রাউজার এবং ওয়েবভিউ ভিত্তিক অ্যাপস

আধুনিক ব্রাউজারগুলি সাধারণত গোপনীয়তার কারণে ক্রস-অরিজিন রিকোয়েস্টে Referer হেডারটি রিড্যাক্ট করে, প্রায়শই এটিকে Origin এ সরিয়ে দেয়। তবে, সঠিক আচরণ হোস্টিং সাইটের প্রয়োগকৃত referrer-policy উপর নির্ভর করে এবং ব্যবহারকারী ব্রাউজার এবং সংস্করণের উপর ভিত্তি করে পরিবর্তিতও হতে পারে।

কন্টেন্ট লোড করার জন্য অস্বচ্ছ বা স্থানীয় URI স্কিম ব্যবহার করে এমন ওয়েব অ্যাপ্লিকেশনগুলিতে সাধারণত রেন্ডারিং ব্রাউজার বা ওয়েবভিউ যেকোনো আউটগোয়িং কল থেকে Referer হেডার সম্পূর্ণরূপে রিড্যাক্ট করে, যার ফলে ওয়েবসাইট বিধিনিষেধ সহ API কী ব্যবহার করে অনুরোধগুলি ব্যর্থ হতে পারে।

আরও নির্দেশনার জন্য, সার্ভারে আপনার ব্রাউজার ভিত্তিক অ্যাপ হোস্ট করুন দেখুন।

ব্রাউজার এবং ওয়েবভিউ ভিত্তিক অ্যাপগুলির সমস্যা সমাধানের নির্দেশাবলী:

  • Maps JavaScript API-এর জন্য, আপনার অ্যাপ্লিকেশনটি কীভাবে অনুমোদন করবেন তার বিশদ বিবরণের জন্য ব্রাউজার ডিবাগ কনসোলটি দেখুন।

    বহিরাগত URI স্কিমগুলি আংশিকভাবে সমর্থিত। যদি আপনার অ্যাপ্লিকেশনের কিছু অংশ এটি একটি বহিরাগত URI স্কিম হিসাবে কাজ না করে, এমনকি প্রয়োজনীয় রেফারারকে অনুমোদন করার পরেও, আপনাকে সম্ভবত আপনার অ্যাপ্লিকেশনটি দূরবর্তীভাবে একটি সার্ভারে হোস্ট করতে হবে এবং HTTPS (অথবা HTTP) এর মাধ্যমে লোড করতে হবে।

    যদি আপনার বিদেশী URI স্কিমগুলির জন্য সাহায্যের প্রয়োজন হয়, তাহলে সহায়তার সাথে যোগাযোগ করুন ।

  • অন্যান্য Maps Platform API গুলি সাধারণত API ত্রুটির প্রতিক্রিয়ায় আপনার অনুমোদিত রেফারারটিকে ফেরত দেবে, ধরে নিয়ে যে ক্লায়েন্ট প্রত্যাখ্যাত অনুরোধের সাথে এই তথ্যটি পাঠিয়েছে।

    বহিরাগত URI স্কিমগুলি সমর্থিত নয় ।

অ্যান্ড্রয়েড অ্যাপস

অ্যান্ড্রয়েড ডিবাগ ব্রিজ (এডিবি) অথবা লগক্যাট ব্যবহার করুন

iOS অ্যাপস

লগ বার্তা দেখা দেখুন

ওয়েব পরিষেবাগুলিকে সরাসরি কল করার অ্যাপগুলি

ক্লায়েন্ট-সাইড গুগল ম্যাপস প্ল্যাটফর্ম SDK ছাড়াই সরাসরি ম্যাপস প্ল্যাটফর্ম HTTPS REST API বা gRPC এন্ডপয়েন্টে কল করা অ্যাপ্লিকেশনগুলির জন্য, নীচে দেখুন:

অ্যান্ড্রয়েড এবং আইওএস অ্যাপস

যদি আপনার অ্যান্ড্রয়েড বা iOS অ্যাপ্লিকেশনটি কোনও উপলব্ধ Google ম্যাপস প্ল্যাটফর্ম ক্লায়েন্ট SDK ব্যবহার না করেই সরাসরি ম্যাপস প্ল্যাটফর্ম পরিষেবাগুলিতে কল করে, তাহলে আরও সমস্যা সমাধানের টিপসের জন্য অ্যান্ড্রয়েড অ্যাপ এবং iOS অ্যাপ দেখুন এবং মোবাইল ব্যবহারের ক্ষেত্রে বর্তমান সেরা সুরক্ষা অনুশীলনের জন্য সিকিউর ক্লায়েন্ট-সাইড ওয়েব পরিষেবা কল করুন ।

যদি আপনার অ্যাপটি Maps Platform API ত্রুটির প্রতিক্রিয়া লগ করে, তাহলে ক্লায়েন্ট-সাইড SDK-এর জন্য উপরের নির্দেশাবলী প্রমাণীকরণ সমস্যা সমাধানের জন্যও কার্যকর প্রমাণিত হতে পারে।

সার্ভার-সাইড অ্যাপস

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

ব্রাউজার বা ওয়েবভিউ ভিত্তিক অ্যাপ

যদিও ম্যাপস স্ট্যাটিক এপিআই, স্ট্রিট ভিউ স্ট্যাটিক এপিআই, সাম্প্রতিক গুগল ম্যাপস প্ল্যাটফর্ম এপিআইগুলিও রেফারার সীমাবদ্ধতা সমর্থন করবে, মনে রাখবেন যে ওয়েব ব্রাউজার বা ওয়েবভিউগুলি সম্ভবত ক্রস-অরিজিন অনুরোধের জন্য Referer হেডারকে Origin সীমাবদ্ধ করবে এবং সম্ভবত এটি সম্পূর্ণরূপে প্রেরণ করবে না, যেমন স্থানীয়ভাবে অ্যাক্সেস করা সংস্থানগুলির জন্য, অথবা HTTP বা HTTPS ব্যতীত অন্য প্রোটোকলের মাধ্যমে পরিবেশিত সংস্থানগুলির জন্য।

যদি আপনি আপনার অ্যাপ্লিকেশনে Maps JavaScript API ব্যবহার করতে না পারেন, এবং ওয়েবসাইটের সীমাবদ্ধতা কাজ না করে, তাহলে আপনার ব্রাউজার ভিত্তিক ক্লায়েন্ট-সাইড অ্যাপ্লিকেশনের মধ্যে থেকে নিরাপদে Maps Platform ওয়েব পরিষেবা কল কীভাবে ইস্যু করবেন তা জানতে "Secure client-side web service call" দেখুন।

API সীমাবদ্ধতা পরীক্ষা করার জন্য টিপস

আপনার প্রয়োজনীয় API সীমাবদ্ধতা পরীক্ষা করতে, আপনার API কী ব্যবহার করে এমন API গুলি নির্ধারণ করুন দেখুন।

কোন বিধিনিষেধ প্রয়োগ করবেন তা যদি আপনি নির্ধারণ করতে না পারেন:

  1. ভবিষ্যতের রেফারেন্সের জন্য বর্তমান বিধিনিষেধগুলি লিপিবদ্ধ করুন।
  2. সমস্যাটি তদন্ত করার সময় এগুলি সাময়িকভাবে সরিয়ে ফেলুন। আপনি "আপনার API কী ব্যবহার পরীক্ষা করুন" এর ধাপগুলি ব্যবহার করে সময়ের সাথে সাথে আপনার ব্যবহার পরীক্ষা করতে পারেন।
  3. প্রয়োজনে, সহায়তার সাথে যোগাযোগ করুন ।

অব্যবহৃত API কীগুলি মুছুন

কোনও API কী মুছে ফেলার আগে, নিশ্চিত করুন যে এটি উৎপাদনে ব্যবহৃত হচ্ছে না। যদি কোনও সফল ট্র্যাফিক না থাকে, তাহলে কীটি মুছে ফেলা সম্ভবত নিরাপদ। আরও তথ্যের জন্য, আপনার API কী ব্যবহার পরীক্ষা করুন দেখুন।

একটি API কী মুছে ফেলার জন্য:

  1. গুগল ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. আপনি যে API কীটি মুছতে চান তা নির্বাচন করুন।

  3. পৃষ্ঠার উপরের দিকে থাকা "মুছুন" বোতামটি নির্বাচন করুন।

  4. ক্রেডেনশিয়াল মুছে ফেলুন পৃষ্ঠায়, মুছে ফেলুন নির্বাচন করুন।

    একটি API কী মুছে ফেললে প্রচারিত হতে কয়েক মিনিট সময় লাগে। প্রচারিত হওয়ার পরে, মুছে ফেলা API কী ব্যবহার করে যেকোনো ট্র্যাফিক প্রত্যাখ্যান করা হয়।

API কী ঘোরানোর সময় সতর্ক থাকুন

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

একটি API কী ঘোরানোর আগে :

  • প্রথমে "Restrict your API keys" এ বর্ণিত পদ্ধতিতে আপনার API কীগুলিকে সীমাবদ্ধ করার চেষ্টা করুন।

  • যদি আপনার API কী সীমাবদ্ধ করা সম্ভব না হয়, তাহলে একাধিক নতুন (সীমাবদ্ধ) কীতে স্থানান্তর করুন যেমনটি "Migrate to multiple API keys" এ বর্ণিত হয়েছে। স্থানান্তর আপনাকে মাইগ্রেশন নিয়ন্ত্রণ করতে এবং নতুন API কীগুলিতে টাইমলাইন রোল আউট করতে দেয়।

যদি পূর্ববর্তী পরামর্শগুলি সম্ভব না হয় , এবং অননুমোদিত ব্যবহার রোধ করার জন্য আপনাকে অবশ্যই আপনার API কী ঘোরাতে হবে, তাহলে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. গুগল ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম শংসাপত্র পৃষ্ঠাটি খুলুন।

  2. আপনি যে API কীটি ঘোরাতে চান সেটি খুলুন।

  3. পৃষ্ঠার শীর্ষে, Rotate key নির্বাচন করুন।

  4. ঐচ্ছিকভাবে, API কী নাম পরিবর্তন করুন।

  5. তৈরি করুন নির্বাচন করুন।

  6. নতুন কী ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশনগুলি আপডেট করুন।

নতুন কী ব্যবহারের জন্য আপনার অ্যাপ্লিকেশনগুলি আপডেট করার পরে, নতুন API কী পৃষ্ঠার পূর্ববর্তী কী বিভাগের অধীনে পূর্ববর্তী কী মুছুন বোতামে ক্লিক করে পুরানো কীটি মুছুন।

একাধিক API কীতে স্থানান্তর করুন

একাধিক অ্যাপের জন্য একটি API কী ব্যবহার থেকে প্রতিটি অ্যাপের জন্য একটি অনন্য API কীতে স্থানান্তর করতে, নিম্নলিখিতগুলি করুন:

  1. কোন অ্যাপগুলিতে নতুন কী প্রয়োজন তা চিহ্নিত করুন :

    • ওয়েব অ্যাপগুলি আপডেট করা সবচেয়ে সহজ, কারণ আপনি সমস্ত কোড নিয়ন্ত্রণ করেন। আপনার সমস্ত ওয়েব-ভিত্তিক অ্যাপের কী আপডেট করার পরিকল্পনা করুন।
    • মোবাইল অ্যাপগুলি অনেক কঠিন, কারণ নতুন কীগুলি ব্যবহার করার আগে আপনার গ্রাহকদের তাদের অ্যাপগুলি আপডেট করতে হবে।

  2. নতুন কী তৈরি এবং সীমাবদ্ধ করুন : একটি অ্যাপ্লিকেশন সীমাবদ্ধতা এবং কমপক্ষে একটি API সীমাবদ্ধতা উভয়ই যোগ করুন। আরও তথ্যের জন্য, প্রস্তাবিত সেরা অনুশীলনগুলি দেখুন।

  3. আপনার অ্যাপগুলিতে নতুন কী যোগ করুন : মোবাইল অ্যাপের ক্ষেত্রে, আপনার সমস্ত ব্যবহারকারী নতুন API কী দিয়ে সর্বশেষ অ্যাপে আপডেট না হওয়া পর্যন্ত এই প্রক্রিয়াটি কয়েক মাস সময় নিতে পারে।

ক্লায়েন্ট-সাইড এবং সার্ভার-সাইড ব্যবহারকে পৃথক প্রকল্পে ভাগ করুন

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

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

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

অব্যবহৃত পরিষেবাগুলি অক্ষম করুন

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

কোনও কী-তে API বিধিনিষেধ যুক্ত করলে সেই পরিষেবাগুলিতে এর ব্যবহার বন্ধ হয়ে যায় যেগুলির জন্য এটি অনুমোদিত নয়, তবে API বিধিনিষেধ কেবল সেই নির্দিষ্ট কী-এর ক্ষেত্রেই প্রযোজ্য। প্রকল্পের সাথে সংযুক্ত কোনও কী-তে পরিষেবার অননুমোদিত ব্যবহার রোধ করতে প্রকল্প স্তরে কোনও পরিষেবা অক্ষম করুন।

ক্লায়েন্ট-সাইড SDK ব্যবহার করুন

প্রদত্ত ক্লায়েন্ট-সাইড গুগল ম্যাপস প্ল্যাটফর্ম SDK ব্যবহার করার সময়, আপনার পরিষেবা ব্যবহার সুরক্ষিত করার জন্য আপনি সর্বদা আপনার API কীতে যথাযথ বিধিনিষেধ প্রয়োগ করতে সক্ষম হবেন।

ক্লায়েন্ট-সাইড SDK ব্যবহার করলে আপনি আরও উন্নত নিরাপত্তা ব্যবস্থা গ্রহণ করতে পারবেন, যেমন Maps Platform API সারফেসে Firebase App Check যা এটি সমর্থন করে। আরও বিস্তারিত জানার জন্য আপনার API কী সুরক্ষিত করতে অ্যাপ চেক ব্যবহার করুন দেখুন।

যদি আপনার প্ল্যাটফর্মের জন্য ক্লায়েন্ট-সাইড SDK উপলব্ধ না থাকে, তাহলে আপনার ক্লায়েন্ট-সাইড ওয়েব পরিষেবা কলগুলি সুরক্ষিত করুন দেখুন।

বিভিন্ন প্ল্যাটফর্মের জন্য ক্লায়েন্ট-সাইড গুগল ম্যাপস প্ল্যাটফর্ম SDK-এর প্রাপ্যতার জন্য, প্রস্তাবিত অ্যাপ্লিকেশন এবং API বিধিনিষেধ দেখুন।

স্ট্যাটিক ওয়েব এপিআই ব্যবহার সুরক্ষিত করুন

স্ট্যাটিক ওয়েব এপিআই, যেমন ম্যাপস স্ট্যাটিক এপিআই এবং স্ট্রিট ভিউ স্ট্যাটিক এপিআই, ওয়েব সার্ভিস এপিআই কলের অনুরূপ।

আপনি HTTPS REST API ব্যবহার করে উভয়কেই কল করেন এবং আপনি সাধারণত সার্ভারে API অনুরোধ URL তৈরি করেন। তবে, JSON প্রতিক্রিয়া ফেরত দেওয়ার পরিবর্তে, স্ট্যাটিক ওয়েব API গুলি একটি চিত্র তৈরি করে যা আপনি জেনারেট করা HTML কোডে এম্বেড করতে পারেন। আরও গুরুত্বপূর্ণ বিষয় হল, সাধারণত সার্ভার নয়, শেষ ব্যবহারকারী ক্লায়েন্টই Google Maps প্ল্যাটফর্ম পরিষেবাটি কল করে।

একটি ডিজিটাল স্বাক্ষর ব্যবহার করুন

সর্বোত্তম অনুশীলন হিসেবে, সর্বদা একটি API কী ছাড়াও ডিজিটাল স্বাক্ষর ব্যবহার করুন। এছাড়াও, আপনি প্রতিদিন কতগুলি স্বাক্ষরবিহীন অনুরোধ অনুমোদন করতে চান তা পর্যালোচনা করুন এবং সেই অনুযায়ী আপনার স্বাক্ষরবিহীন অনুরোধের কোটা সামঞ্জস্য করুন ।

ডিজিটাল স্বাক্ষর সম্পর্কে আরও তথ্যের জন্য, ডিজিটাল স্বাক্ষর নির্দেশিকা দেখুন।

আপনার স্বাক্ষর গোপনীয়তা রক্ষা করুন

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

  • কোনও ওয়েব পৃষ্ঠা পরিবেশন করার সময় অথবা আপনার মোবাইল অ্যাপ্লিকেশন থেকে কোনও অনুরোধের প্রতিক্রিয়ায় সার্ভার-সাইড থেকে আপনার স্বাক্ষরিত মানচিত্র স্ট্যাটিক API এবং রাস্তার দৃশ্য স্ট্যাটিক API অনুরোধ URL তৈরি করুন।

    স্ট্যাটিক ওয়েব কন্টেন্টের জন্য, আপনি ক্লাউড কনসোল গুগল ম্যাপস প্ল্যাটফর্ম ক্রেডেনশিয়াল পৃষ্ঠায় "এখনই URL সাইন করুন" উইজেটটি ব্যবহার করতে পারেন।

    গতিশীল ওয়েব কন্টেন্টের জন্য, উপলব্ধ URL অনুরোধ স্বাক্ষর কোড নমুনা দেখুন।

  • আপনার অ্যাপ্লিকেশনের সোর্স কোড এবং সোর্স ট্রির বাইরে স্বাক্ষর গোপন তথ্য সংরক্ষণ করুন । যদি আপনি আপনার স্বাক্ষর গোপন তথ্য বা অন্য কোনও ব্যক্তিগত তথ্য পরিবেশ ভেরিয়েবলে রাখেন বা আলাদাভাবে সংরক্ষণ করা ফাইলগুলি অন্তর্ভুক্ত করেন এবং তারপর আপনার কোড ভাগ করেন, তাহলে স্বাক্ষর গোপন তথ্য ভাগ করা ফাইলগুলিতে অন্তর্ভুক্ত করা হবে না। যদি আপনি ফাইলগুলিতে স্বাক্ষর গোপন তথ্য বা অন্য কোনও ব্যক্তিগত তথ্য সংরক্ষণ করেন, তাহলে আপনার অ্যাপ্লিকেশনের সোর্স ট্রির বাইরে ফাইলগুলি রাখুন যাতে আপনার স্বাক্ষর গোপন তথ্য আপনার সোর্স কোড নিয়ন্ত্রণ ব্যবস্থা থেকে দূরে থাকে। এই সতর্কতা বিশেষভাবে গুরুত্বপূর্ণ যদি আপনি একটি পাবলিক সোর্স কোড ম্যানেজমেন্ট সিস্টেম ব্যবহার করেন, যেমন GitHub।

ওয়েব পরিষেবা API কীগুলি সুরক্ষিত করুন

For secure use of Google Maps Platform APIs and services from client-side apps, see Use client-side SDKs and Secure client-side web service calls .

Store API keys outside of your application's source code or source tree . If you put your API keys or any other information in environment variables or include files that are stored separately and then share your code, the API keys are not included in the shared files. This is particularly important if you use a public source code management system, such as GitHub.

To help shield your web service API key against accidental use, Google recommends applying API restrictions to any key used for Maps Platform. Furthermore, also applying IP address restrictions to your web service key will protect it against help protect it against unauthorized use from other source IP addresses, even if the key accidentally leaks.

Use OAuth for server-side apps

OAuth 2.0 is an open standard for access delegation.

While the OAuth 2.0 protocol supports use cases, where an end user authorizes an application to access personal data on their behalf, the intended use case for OAuth 2.0 with Maps Platform is for the developer to utilize temporary access tokens for authorizing their application to call an API on behalf of their Google Cloud project service account with the permissions of the service account.

As a service account may have extremely broad permissions, OAuth 2.0 is recommended for authorizing server-to-server calls between a developer's trusted server-side applications and Google's Maps Platform servers.

For client-side applications running on end user devices, other authentication methods, such as API keys, are recommended.

If you want to use OAuth 2.0 to authorize server-to-server traffic, look for the OAuth topic in your API documentation.

For example, here is the OAuth topic for the Address Validation API .

Secure client-side web service calls

If client-side SDKs are not available, see the recommendations below.

একটি প্রক্সি সার্ভার ব্যবহার করুন

Using a secure proxy server provides a solid source for interacting with a Google Maps Platform web service endpoint from a client-side application without exposing your API key, signing secret or Google Cloud service account to unauthorized users.

গুরুত্বপূর্ণ বিষয়:

  • Construct your Google Maps Platform requests on the proxy server. Don't allow clients to relay arbitrary API calls using the proxy.

  • Post-process the Google Maps Platform responses on your proxy server. Filter out data that the client doesn't need.

For more information about using a proxy server, see Living Vicariously: Using Proxy Servers with the Google Data API Client Libraries .

Secure direct mobile web service calls

If you are unable to set up a secure proxy server for your client-side app, secure your application using the following steps:

  1. Use HTTP headers:

    • Android : Use the X-Android-Package and X-Android-Cert HTTP headers.

    • iOS : Use the X-Ios-Bundle-Identifier HTTP header.

  2. Add the corresponding application restrictions to your Android or iOS key.

  3. Before you consider issuing calls directly from your mobile application to a Google Maps Platform REST API web service, verify that requests with incorrect Android or iOS application identifiers are rejected.

    If Android and iOS application restrictions are not supported on the tested endpoint, Google strongly recommends that you use a secure proxy server between your mobile clients and the Google Maps Platform web service endpoint.

Tips for Android applications:

  • Before you integrate your Android application with Google Maps Platform services, verify that your application ID (also called package name) is formatted correctly. For details, see Configure app module . in the Android documentation.

  • To pass X-Android-Package directly from your application, look it up programmatically using Context.getPackageName() .

  • To pass X-Android-Cert directly from your applications, calculate the required SHA-1 fingerprint of your application signing certificates, accessible through PackageInfo.signingInfo .

  • If you authorize your Android application using the Google Cloud console, note that the UI expects the SHA-1 fingerprint to be a colon-delimited string, eg, 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33 . However, the gcloud tool and the API keys API expect the hexadecimal string without delimiters.

Tips for iOS applications:

  • Before you integrate your iOS application with Google Maps Platform services, verify that your Bundle ID is formatted correctly .

  • You should typically always pass the Bundle ID of your main bundle in the X-Ios-Bundle-Identifier header, when authorizing your iOS application.

For further information, refer to articles Manage API keys and Use API keys to access APIs .

Host your browser based apps on a server

Frameworks, such as Apache Cordova, allow you to conveniently create multi-platform hybrid apps running inside a webview. However, API key website restrictions are not guaranteed to work correctly, unless your web app is loaded using HTTP or HTTPS from a website that you control and have authorized.

Bundled resources, loaded locally from within a hybrid application, or accessed using a local file URL will in many cases prevent referrer based authorization from working as the browser engine powering your webview will omit sending the Referer header. To avoid this, host your web applications server-side, not client-side.

Alternatively, for mobile applications, consider using available native Google Maps Platform Android and iOS SDKs, instead of using a web based SDK.

Use App Check to secure your API key

Certain Maps SDKs and APIs allow you to integrate with Firebase App Check . App Check provides protection for calls from your app to Google Maps Platform by blocking traffic that comes from sources other than legitimate apps. It does this by checking for a token from an attestation provider. Integrating your apps with App Check helps to protect against malicious requests, so you're not charged for unauthorized API calls.

App Check integration instructions:

Handle unauthorized use of an API key

If you detect use of your API key that is unauthorized, do the following to address the problem:

  1. Restrict your keys : If you've used the same key in multiple apps, migrate to multiple API keys, and use separate API keys for each app. For more details, see:

  2. If you use the Places SDK or the Maps Javascript API, you can also use App Check to secure your API Key .

  3. Only replace or rotate keys if the following is true:

    • You detect unauthorized usage on keys that either cannot be restricted or are already restricted, and App Check is not applicable.

    • You want to move more quickly to secure your API key and stop the abuse, even if it might impact legitimate traffic from your application.

    Before proceeding, read through Be careful when rotating API keys .

  4. If you are still having issues or need help, contact support .

Recommended application and API restrictions

The following sections suggest appropriate application and API restrictions for each Google Maps Platform API, SDK or service.

Recommended API Restrictions

The following guidelines for API restrictions apply to all Google Maps Platform services:

  • Restrict your API key to only the APIs you are using it for, with the following exceptions:

    • If your app uses the Places SDK for Android or Places SDK for iOS, authorize Places API (New) or Places API, depending on the SDK versions you use. 1

    • If your app uses Maps JavaScript API, always authorize it on your key.

    • If you also use any of the following Maps JavaScript API services, you should also authorize these corresponding APIs:

      সেবা API restriction
      Directions Service (Legacy) Directions API (Legacy)
      Distance Matrix Service (Legacy) Distance Matrix API (Legacy)
      Elevation Service উচ্চতা API
      Geocoding Service জিওকোডিং এপিআই
      Place class, Place Autocomplete Widget (New) & Place Autocomplete Data API Places API (New) 2
      Places Library, Places Service & Place Autocomplete Widget Places API 2

1 For more details, see the Places SDK for Android and Places SDK for iOS documentation.

2 If you are unsure if you need to authorize Places API (New) or Places API, see the Maps JavaScript API documentation.

কিছু উদাহরণ:

  • You are using the Maps SDK for Android and Places SDK for Android, so you include the Maps SDK for Android and Places API (New) as API restrictions.

  • Your website uses the Maps JavaScript API Elevation Service and the Maps Static API, so you add API restrictions for all of the following APIs:

    • ম্যাপস জাভাস্ক্রিপ্ট এপিআই
    • উচ্চতা API
    • ম্যাপস স্ট্যাটিক এপিআই

Recommended application Restriction

ওয়েবসাইট

For websites using Maps JavaScript API services, Maps Static API or Street View Static API or calling recent Google Maps Platform services directly over the HTTPS REST API or gRPC, use the Websites application restriction:

1 For mobile applications, consider using the native Maps SDK for Android and Maps SDK for iOS .

2 For mobile applications, consider using the native Places SDK for Android and Places SDK for iOS .

3 See also Protect Static Web API usage .

Websites with the Maps Embed API

While using the Maps Embed API is no charge, you should still restrict any used API key to prevent abuse on other services.

Best practice : Create a separate API key for Maps Embed API use, and restrict this key to only the Maps Embed API. This restriction sufficiently secures the key, preventing its unauthorized use on any other Google service. For full control over where your Maps Embed API key can be used from, Google recommends also applying Websites application restrictions.

If you are unable to separate your Maps Embed API usage to a separate API key, secure your existing key using the Websites application restriction.

Apps and servers using web services

For servers and client-side apps from trusted corporate internal networks using web services together with API keys, use the IP addresses application restriction.

Use for apps and servers using these APIs:

4 For mobile applications, consider using the Navigation SDK.

5 For safe mobile usage, use a secure proxy server .

6 For client-side applications, consider using the native geolocation service offered by the platform; for example, W3C Geolocation for web browsers, LocationManager or the Fused Location Provider API for Android, or the Apple Core Location framework for iOS.

7 For mobile applications, consider using the native Places SDK for Android and Places SDK for iOS .

8 For safe client-side usage, use a secure proxy server .

অ্যান্ড্রয়েড অ্যাপস

For apps on Android, use the Android apps application restriction. Use for apps using these SDKs:

In addition, prevent accidentally checking API keys into version control by using the Secrets Gradle Plugin to inject secrets from a local file rather than storing them in the Android Manifest.

iOS apps

For apps on iOS, use the iOS apps application restriction. Use for apps and servers using these SDKs:

আরও পড়া