অনুমোদন

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

অনুমোদন সংক্রান্ত কুইকস্টার্ট

• জিরো-টাচ এনরোলমেন্ট API এবং OAuth ক্লায়েন্ট সিক্রেট সহ Google Cloud Platform প্রোজেক্ট সেট-আপ করতে, এই উইজার্ড রান করুন।
• Java, .NET, অথবা Python-এর জন্য কুইকস্টার্ট স্যাম্পেল কোড তৈরি করুন। অন্যান্য ভাষার জন্য Google-এর API ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন।

এক নজরে

1. এক বা একাধিক আইটি অ্যাডমিন জিরো-টাচ এনরোলমেন্ট গ্রাহক অ্যাকাউন্টের ব্যবহারকারী।
2. আইটি অ্যাডমিনরা নিজেদের যাচাই করার জন্য Google অ্যাকাউন্ট ব্যবহার করেন।
3. API অনুরোধগুলি আইটি অ্যাডমিনের পক্ষে API অনুরোধগুলি অনুমোদন করার জন্য একটি OAuth2 টোকেন পাস করে।

গ্রাহক অ্যাকাউন্ট

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

অ্যাকাউন্ট শনাক্ত করতে API সংখ্যাসূচক কাস্টমার আইডি ব্যবহার করে। API পদ্ধতি কল করার সময় URL পাথের অংশ হিসেবে আপনি কাস্টমার আইডি পাস করেন। কোনও API মেথড কল করার আগে আপনার অ্যাপকে ব্যবহারকারীর কাস্টমার আইডি পেতে হবে।

API কল অনুমোদন করে এমন ব্যবহারকারীর জন্য কীভাবে গ্রাহক অ্যাকাউন্ট পেতে হয় তা নিচের উদাহরণে দেখানো হয়েছে:

AndroidProvisioningPartner.Customers.List accountRequest = service.customers().list();
accountRequest.setPageSize(100);
CustomerListCustomersResponse accountResponse = accountRequest.execute();

List<Company> customers = accountResponse.getCustomers();
if (customers == null || customers.isEmpty()) {
    // No accounts found for the user. Confirm the Google Account
    // that authorizes the request can access the zero-touch portal.
    System.out.println("No zero-touch enrollment account found.");
} else {
    // Print the customers in this page.
    for (Company customer : customers) {
        System.out.format("%s\tcustomers/%d\n",
              customer.getCompanyName(), customer.getCompanyId());
    }
}

CustomersResource.ListRequest accountRequest = service.Customers.List();
accountRequest.PageSize = 100;
CustomerListCustomersResponse accountResponse = accountRequest.Execute();
IList<Company> customers = accountResponse.Customers ?? new List<Company>();
if (customers.Count == 0)
{
    // No accounts found for the user. Confirm the Google Account
    // that authorizes the request can access the zero-touch portal.
    Console.WriteLine("No zero-touch enrollment account found.");
}
foreach (Company customer in customers)
{
    Console.WriteLine("{0}\tcustomers/{1}",
                      customer.CompanyName,
                      customer.CompanyId);
}

response = service.customers().list(pageSize=100).execute()
if 'customers' not in response:
  # No accounts found for the user. Confirm the Google Account
  # that authorizes the request can access the zero-touch portal.
  print('No zero-touch enrollment account found.')
  response['customers'] = []

for customer in response['customers']:
  print('{0}\tcustomers/{1}'.format(
      customer['companyName'], customer['companyId']))

আপনার অ্যাপে, আপনাকে অ্যাকাউন্ট ফলাফল পৃষ্ঠায় নেভিগেট করতে হবে কারণ উপরের উদাহরণে শুধুমাত্র প্রথম ১০০টি অ্যাকাউন্ট প্রিন্ট করা হয়েছে। এটি কীভাবে করতে হয় তা জানতে, পৃষ্ঠা অনুযায়ী ফলাফল পড়ুন।

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

ব্যবহারকারী

আইটি অ্যাডমিনরা তাদের হয়ে আপনার অ্যাপের পাঠানো API অনুরোধ অনুমোদন করেন। API অনুরোধের অনুমতি দিতে, আপনার অ্যাপের ব্যবহারকারীকে নিম্নলিখিত কাজগুলি করতে হবে:

1. তাদের ইমেল আইডির সাথে Google অ্যাকাউন্ট যুক্ত করুন।
2. একই ইমেল আইডি ব্যবহার করে গ্রাহক অ্যাকাউন্টে যোগ দিন।
3. জিরো-টাচ এনরোলমেন্ট গ্রাহক পরিষেবার শর্তাবলীতে (ToS) সম্মতি জানান।

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

ব্যবহারকারী ম্যানেজমেন্ট

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

পরিষেবার শর্তাবলীতে সম্মতি

আপনার অ্যাপের ব্যবহারকারীরা API কল অনুমোদন করার আগে, তাদের লেটেস্ট ToS গ্রহণ করতে হবে। আইটি অ্যাডমিন প্রথমবার জিরো-টাচ এনরোলমেন্ট ব্যবহার করলে অথবা আমরা পরিষেবার শর্তাবলী আপডেট করলে এটি হয়। ব্যবহারকারী লেটেস্ট ToS গ্রহণ না করলে, API একটি HTTP 403 Forbidden স্ট্যাটাস কোড রিটার্ন করে এবং রেসপন্স বডিতে TosError থাকে।

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

 আপনার অ্যাপে অনুমোদন যোগ করা

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

নির্দেশাবলী

আমরা Java, .NET এবং Python অ্যাপের জন্য কুইকস্টার্ট গাইড প্রদান করি। আপনি অন্য কোনও ভাষা ব্যবহার করলে, আপনার অ্যাপের জন্য অনুমোদন সেট-আপ করতে নিচে উল্লেখ করা দুটি ধাপ অনুসরণ করুন।

অনুমোদন সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা পড়ুন।

অনুমোদনের স্কোপ

OAuth 2.0 অ্যাক্সেস টোকেনের অনুরোধ করতে আপনার অ্যাপে API অনুমোদনের স্কোপ https://www.googleapis.com/auth/androidworkzerotouchemm ব্যবহার করুন।

একটি স্কোপ প্যারামিটার রিসোর্স এবং অপারেশনের সেট নিয়ন্ত্রণ করে যা একটি অ্যাক্সেস টোকেন কল করার অনুমতি দেয়। অ্যাক্সেস টোকেন শুধুমাত্র টোকেন অনুরোধের স্কোপে বর্ণিত অপারেশন ও রিসোর্সের সেটের জন্য বৈধ। উপরে দেখানো জিরো-টাচ এনরোলমেন্টের একটিমাত্র স্কোপের মাধ্যমে API সব পদ্ধতি ও রিসোর্স কভার করে।

Google API ক্লায়েন্ট লাইব্রেরির সাথে ব্যবহার করা জিরো-টাচ এনরোলমেন্ট স্কোপের উদাহরণ দেখতে, Java, .NET এবং Python-এর জন্য কুইকস্টার্ট দেখুন। Google API স্কোপ ব্যবহার করার ব্যাপারে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা নিবন্ধটি পড়ুন।

API key-এর জন্য পেশাদার পদ্ধতি

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

কোডে সরাসরি API key এম্বেড করবেন না

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

আপনার অ্যাপ্লিকেশনের সোর্স ট্রির মধ্যে থাকা ফাইলে API কী সেভ করবেন না

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

আপনার API key শুধুমাত্র সেইসব IP অ্যাড্রেস, রেফারার URL এবং মোবাইল অ্যাপের জন্য সীমাবদ্ধ করুন যেগুলির জন্য এটি প্রয়োজন

প্রতিটি কী ব্যবহার করতে পারে এমন IP অ্যাড্রেস, রেফারার URL এবং মোবাইল অ্যাপ সীমাবদ্ধ করার মাধ্যমে, আপনি কোনও API কী-এর সাথে আপোস করার প্রভাব কমাতে পারেন। আপনি Google API কনসোল থেকে ক্রেডেনশিয়াল পৃষ্ঠা খুলে, প্রতিটি 'কী' ব্যবহার করতে পারে এমন হোস্ট ও অ্যাপ নির্দিষ্ট করতে পারবেন এবং তারপর আপনার পছন্দমতো সেটিংস সহ নতুন API কী তৈরি করতে অথবা API কী-এর সেটিংস এডিট করতে পারবেন।

অপ্রয়োজনীয় API key মুছে দিন

অ্যাটাকের সম্ভাবনা কমাতে, আপনার আর প্রয়োজন নেই এমন API key মুছে দিন।

আপনার API কী নির্দিষ্ট সময় অন্তর আবার তৈরি করুন

আপনি Google API কনসোল থেকে API কী আবার তৈরি করতে পারবেন। এর জন্য ক্রেডেনশিয়াল পৃষ্ঠা খুলে, একটি API কী বেছে নিন এবং প্রতিটি কী-এর জন্য কী আবার তৈরি করুন বিকল্পে ক্লিক করুন। তারপর নতুন তৈরি করা 'কী' ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশন আপডেট করুন। আপনি রিপ্লেসমেন্ট কী তৈরি করার পর ২৪ ঘণ্টা পর্যন্ত আপনার পুরনো কী কাজ করা চালিয়ে যাবে।

আপনার কোড সর্বজনীনভাবে রিলিজ করার আগে তা পর্যালোচনা করুন

আপনার কোড সর্বজনীনভাবে উপলভ্য করার আগে, আপনার কোডে API কী বা অন্য কোনও ব্যক্তিগত তথ্য নেই তা নিশ্চিত করুন।