REST Resource: enterprises.enrollmentTokens

রিসোর্স: এনরোলমেন্ট টোকেন

একটি তালিকাভুক্তি টোকেন।

JSON উপস্থাপনা 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "googleAuthenticationOptions": {
    object (GoogleAuthenticationOptions)
  }
}
ক্ষেত্র
name

string

এনরোলমেন্ট টোকেনের নাম, যা তৈরির সময় সার্ভার দ্বারা জেনারেট করা হয় এবং এর ফর্ম্যাট হলো enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} ।

value

string

টোকেন মান যা ডিভাইসে পাঠানো হয় এবং ডিভাইসটিকে নথিভুক্ত হওয়ার অনুমোদন দেয়। এটি সার্ভার দ্বারা তৈরি একটি পঠনযোগ্য (read-only) ক্ষেত্র।

duration

string ( Duration format)

এনরোলমেন্ট টোকেনটি ১ মিনিট থেকে Durations.MAX_VALUE (যা প্রায় ১০,০০০ বছর) পর্যন্ত বৈধ থাকে। যদি নির্দিষ্ট করে দেওয়া না থাকে, তবে ডিফল্ট মেয়াদ হয় ১ ঘণ্টা। অনুগ্রহ করে মনে রাখবেন যে, যদি অনুরোধ করা মেয়াদের কারণে প্রাপ্ত expirationTimestamp Timestamps.MAX_VALUE অতিক্রম করে, তাহলে expirationTimestamp পরিবর্তন করে Timestamps.MAX_VALUE করা হয়।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

expirationTimestamp

string ( Timestamp format)

টোকেনটির মেয়াদ শেষ হওয়ার সময়। এটি সার্ভার দ্বারা তৈরি একটি পঠনযোগ্য ক্ষেত্র।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

policyName

string

নথিভুক্ত ডিভাইসে প্রাথমিকভাবে প্রয়োগ করা পলিসির নাম, enterprises/{enterpriseId}/policies/{policyId} আকারে থাকে। যদি এটি নির্দিষ্ট না করা হয়, তাহলে ডিভাইসের ব্যবহারকারীর জন্য policyName প্রয়োগ করা হয়। যদি userName ও নির্দিষ্ট না করা হয়, তাহলে ডিফল্টরূপে enterprises/{enterpriseId}/policies/default প্রয়োগ করা হয়। এই ফিল্ডটি আপডেট করার সময়, আপনি শুধুমাত্র policyId নির্দিষ্ট করতে পারেন, তবে policyId কোনো স্ল্যাশ থাকা যাবে না। পলিসির নামের বাকি অংশ অনুমান করে নেওয়া হবে।

additionalData

string

এনরোলমেন্ট টোকেনের সাথে যুক্ত ঐচ্ছিক, ইচ্ছামত ডেটা। উদাহরণস্বরূপ, এতে এমন একটি অর্গ ইউনিটের আইডি থাকতে পারে, যেখানে এনরোলমেন্টের পর ডিভাইসটিকে বরাদ্দ করা হয়। টোকেন ব্যবহার করে কোনো ডিভাইস এনরোল করার পর, এই ডেটাটি Device রিসোর্সের enrollmentTokenData ফিল্ডে প্রকাশ করা হবে। ডেটাটি অবশ্যই ১০২৪ অক্ষর বা তার কম হতে হবে; অন্যথায়, তৈরির অনুরোধটি ব্যর্থ হবে।

qrCode

string

একটি JSON স্ট্রিং যার UTF-8 উপস্থাপনা ব্যবহার করে এই এনরোলমেন্ট টোকেন দিয়ে একটি ডিভাইস এনরোল করার জন্য একটি QR কোড তৈরি করা যায়। NFC ব্যবহার করে একটি ডিভাইস এনরোল করতে হলে, NFC রেকর্ডে অবশ্যই JSON-এর প্রোপার্টিগুলোর একটি সিরিয়ালাইজড java.util.Properties উপস্থাপনা থাকতে হবে।

oneTimeOnly

boolean

এনরোলমেন্ট টোকেনটি শুধুমাত্র একবার ব্যবহারের জন্য কিনা। যদি ফ্ল্যাগটি 'true' সেট করা থাকে, তবে শুধুমাত্র একটি ডিভাইস রেজিস্ট্রেশনের জন্য এটি ব্যবহার করতে পারবে।

user
(deprecated)

object ( User )

এই ফিল্ডটি অপ্রচলিত এবং এর মান উপেক্ষা করা হয়।

allowPersonalUsage

enum ( AllowPersonalUsage )

এই এনরোলমেন্ট টোকেন দিয়ে সরবরাহ করা কোনো ডিভাইসে ব্যক্তিগত ব্যবহারের অনুমতি দেওয়া হবে কিনা, তা এটি নিয়ন্ত্রণ করে।

কোম্পানির মালিকানাধীন ডিভাইসগুলির জন্য:

  • ব্যক্তিগত ব্যবহার সক্ষম করলে ব্যবহারকারী ডিভাইসটিতে একটি কাজের প্রোফাইল তৈরি করতে পারেন।
  • ব্যক্তিগত ব্যবহার নিষ্ক্রিয় করতে হলে ব্যবহারকারীকে ডিভাইসটিকে একটি সম্পূর্ণ পরিচালিত ডিভাইস হিসেবে প্রোভিশন করতে হবে।

ব্যক্তিগত মালিকানাধীন ডিভাইসগুলির জন্য:

  • ব্যক্তিগত ব্যবহার সক্ষম করলে ব্যবহারকারী ডিভাইসটিতে একটি কাজের প্রোফাইল তৈরি করতে পারেন।
  • ব্যক্তিগত ব্যবহার নিষ্ক্রিয় করলে ডিভাইসটি প্রোভিশনিং হতে পারবে না। ব্যক্তিগত মালিকানাধীন ডিভাইসে ব্যক্তিগত ব্যবহার নিষ্ক্রিয় করা যায় না।
googleAuthenticationOptions

object ( GoogleAuthenticationOptions )

ঐচ্ছিক। তালিকাভুক্তির সময় গুগল প্রমাণীকরণ সম্পর্কিত বিকল্পসমূহ।

গুগল প্রমাণীকরণ বিকল্প

তালিকাভুক্তির সময় গুগল প্রমাণীকরণের বিকল্পসমূহ।

একটি SigninDetail ব্যবহার করে এনরোলমেন্ট শুরু করার সময়, ব্যবহারকারী তৃতীয় পক্ষের সাইন-ইন সম্পন্ন করার পর এবং একটি EnrollmentToken তৈরি হওয়ার পরে এই বিকল্পগুলি কার্যকর হয়। যদি এই টোকেনের authenticationRequirement-কে REQUIRED হিসেবে সেট করা থাকে, তাহলে এই বিকল্পগুলি সেই SigninDetail.googleAuthenticationOptions এর সাথে নিম্নলিখিত উপায়ে কাজ করে যা প্রক্রিয়াটি শুরু করেছিল: - যদি ব্যবহারকারী আগে গুগল সাইন-ইন এড়িয়ে গিয়ে থাকেন (যা SigninDetail.googleAuthenticationOptions দ্বারা অনুমোদিত), তাহলে একটি ত্রুটি দেখা দেবে এবং ব্যবহারকারীকে আবার সাইন ইন করতে বলা হবে। - যদি এই টোকেনে requiredAccountEmail সেট করা থাকে এবং ব্যবহারকারী আগে অন্য কোনো ইমেল দিয়ে সাইন ইন করে থাকেন, তাহলে একটি ত্রুটি দেখা দেবে এবং ব্যবহারকারীকে সঠিক অ্যাকাউন্ট দিয়ে আবার সাইন ইন করতে বলা হবে।

JSON উপস্থাপনা 
{
  "authenticationRequirement": enum (AuthenticationRequirement),
  "requiredAccountEmail": string
}
ক্ষেত্র
authenticationRequirement

enum ( AuthenticationRequirement )

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

requiredAccountEmail

string

ঐচ্ছিক। এটি সেই পরিচালিত গুগল অ্যাকাউন্টটি নির্দিষ্ট করে যা ব্যবহারকারীকে তালিকাভুক্তির সময় অবশ্যই ব্যবহার করতে হবে। এই ক্ষেত্রটি কেবল তখনই সেট করা যাবে যদি AuthenticationRequirement REQUIRED হিসেবে সেট করা থাকে।

প্রমাণীকরণের প্রয়োজনীয়তা

তালিকাভুক্তির সময় ব্যবহারকারীকে গুগলের মাধ্যমে প্রমাণীকরণ করতে হবে কিনা তা নির্দিষ্ট করে। এটি এন্টারপ্রাইজ-স্তরের সেটিং googleAuthenticationSettings অগ্রাহ্য করে।

এনাম
AUTHENTICATION_REQUIREMENT_UNSPECIFIED এই এনরোলমেন্ট টোকেনটি যে এন্টারপ্রাইজের অন্তর্গত, সেই এন্টারপ্রাইজের googleAuthenticationSettings সেটিংটি ব্যবহার করা হয় এটি নির্ধারণ করার জন্য যে, এনরোলমেন্টের সময় ব্যবহারকারীকে গুগলের সাথে প্রমাণীকরণ করতে হবে কিনা।
OPTIONAL ব্যবহারকারীর জন্য গুগল প্রমাণীকরণ ঐচ্ছিক। এর মানে হলো, ব্যবহারকারী তালিকাভুক্তির সময় গুগল প্রমাণীকরণ এড়িয়ে যাওয়ার সিদ্ধান্ত নিতে পারেন।
REQUIRED ব্যবহারকারীর জন্য গুগল প্রমাণীকরণ প্রয়োজন। এর মানে হলো, প্রক্রিয়াটি এগিয়ে নিয়ে যাওয়ার জন্য ব্যবহারকারীকে অবশ্যই একটি গুগল অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করতে হবে।

পদ্ধতি

create

 একটি নির্দিষ্ট এন্টারপ্রাইজের জন্য একটি এনরোলমেন্ট টোকেন তৈরি করে।

delete

 তালিকাভুক্তি টোকেন মুছে দেয়।

get

 একটি সক্রিয় ও মেয়াদোত্তীর্ণ নয় এমন তালিকাভুক্তি টোকেন পাওয়া যায়।

list

 একটি নির্দিষ্ট এন্টারপ্রাইজের জন্য সক্রিয় ও মেয়াদোত্তীর্ণ নয় এমন এনরোলমেন্ট টোকেনগুলির তালিকা দেখায়।