Method: hashes.search

নির্দিষ্ট উপসর্গের সাথে মিলে যাওয়া সম্পূর্ণ হ্যাশের জন্য অনুসন্ধান করুন।

এটি একটি কাস্টম পদ্ধতি যা https://google.aip.dev/136 দ্বারা সংজ্ঞায়িত করা হয়েছে (কাস্টম পদ্ধতিটি এই পদ্ধতিকে বোঝায় যেটি Google এর সাধারণ API বিকাশ নামকরণের মধ্যে একটি কাস্টম নাম রয়েছে; এটি একটি কাস্টম HTTP পদ্ধতি ব্যবহার করার উল্লেখ করে না)।

HTTP অনুরোধ

GET https://safebrowsing.googleapis.com/v5/hashes:search

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

ক্যোয়ারী প্যারামিটার

পরামিতি
hashPrefixes[]

string ( bytes format)

প্রয়োজন। হ্যাশ উপসর্গগুলি দেখতে হবে। ক্লায়েন্টদের 1000টির বেশি হ্যাশ প্রিফিক্স পাঠাতে হবে না। যাইহোক, URL প্রক্রিয়াকরণ পদ্ধতি অনুসরণ করে, ক্লায়েন্টদের 30টির বেশি হ্যাশ উপসর্গ পাঠাতে হবে না।

বর্তমানে প্রতিটি হ্যাশ প্রিফিক্স ঠিক 4 বাইট লম্বা হওয়া প্রয়োজন। এটি ভবিষ্যতে শিথিল হতে পারে।

একটি base64-এনকোডেড স্ট্রিং।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

হুমকি হ্যাশ অনুসন্ধান করার পরে প্রতিক্রিয়া ফিরে.

যদি কিছু না পাওয়া যায়, সার্ভার একটি NOT_FOUND স্ট্যাটাস (HTTP স্ট্যাটাস কোড 404) ফেরত না দিয়ে, fullHashes ফিল্ড খালি রেখে একটি ঠিক আছে (HTTP স্ট্যাটাস কোড 200) ফিরিয়ে দেবে।

V5-এ নতুন কি : FullHash এবং FullHashDetail এর মধ্যে একটি বিচ্ছেদ রয়েছে। সেক্ষেত্রে যখন একটি হ্যাশ এমন একটি সাইটের প্রতিনিধিত্ব করে যেখানে একাধিক হুমকি রয়েছে (যেমন MALWARE এবং SOCIAL_ENGINEERING উভয়ই), সম্পূর্ণ হ্যাশ V4-এর মতো দুবার পাঠানোর প্রয়োজন নেই। অধিকন্তু, ক্যাশের সময়কালকে একটি একক cacheDuration ক্ষেত্রে সরলীকৃত করা হয়েছে।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "fullHashes": [
    {
      object (FullHash)
    }
  ],
  "cacheDuration": string
}
ক্ষেত্র
fullHashes[]

object ( FullHash )

অবিন্যস্ত তালিকা. সম্পূর্ণ হ্যাশের অবিন্যস্ত তালিকা পাওয়া গেছে।

cacheDuration

string ( Duration format)

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

যদি এবং শুধুমাত্র যদি ক্ষেত্র fullHashes খালি থাকে, ক্লায়েন্ট একটি নতুন মেয়াদ নির্ধারণ করতে cacheDuration বাড়িয়ে দিতে পারে যা সার্ভার দ্বারা নির্দিষ্ট করা সময়ের পরে। যে কোনো ক্ষেত্রে, বর্ধিত ক্যাশে সময়কাল 24 ঘন্টার বেশি হওয়া উচিত নয়।

গুরুত্বপূর্ণ: ক্লায়েন্টকে অনুমান করা উচিত নয় যে সার্ভারটি সমস্ত প্রতিক্রিয়ার জন্য একই ক্যাশে সময়কাল ফিরিয়ে দেবে। সার্ভার পরিস্থিতির উপর নির্ভর করে বিভিন্ন প্রতিক্রিয়ার জন্য বিভিন্ন ক্যাশে সময়কাল বেছে নিতে পারে।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

ফুলহ্যাশ

এক বা একাধিক মিলের সাথে চিহ্নিত সম্পূর্ণ হ্যাশ।

JSON প্রতিনিধিত্ব 
{
  "fullHash": string,
  "fullHashDetails": [
    {
      object (FullHashDetail)
    }
  ]
}
ক্ষেত্র
fullHash

string ( bytes format)

ম্যাচিং পূর্ণ হ্যাশ. এটি SHA256 হ্যাশ। দৈর্ঘ্য হবে ঠিক 32 বাইট।

একটি base64-এনকোডেড স্ট্রিং।

fullHashDetails[]

object ( FullHashDetail )

অবিন্যস্ত তালিকা. একটি পুনরাবৃত্ত ক্ষেত্র এই সম্পূর্ণ হ্যাশের সাথে প্রাসঙ্গিক বিবরণ সনাক্ত করে।

ফুলহ্যাশ ডিটেইল

একটি ম্যাচিং পূর্ণ হ্যাশ সম্পর্কে বিশদ বিবরণ.

ফরোয়ার্ড সামঞ্জস্য সম্পর্কে একটি গুরুত্বপূর্ণ নোট: নতুন হুমকির ধরন এবং হুমকির বৈশিষ্ট্যগুলি যে কোনো সময় সার্ভার দ্বারা যোগ করা হতে পারে; এই সংযোজনগুলিকে ছোট সংস্করণ পরিবর্তন হিসাবে বিবেচনা করা হয়। এপিআই-এ ক্ষুদ্র সংস্করণ নম্বর প্রকাশ না করা Google-এর নীতি (সংস্করণ নীতির জন্য https://cloud.google.com/apis/design/versioning দেখুন), তাই ক্লায়েন্টদের অবশ্যই ThreatType enum মান বা ThreatAttribute সম্বলিত FullHashDetail বার্তা পাওয়ার জন্য প্রস্তুত থাকতে হবে enum মান যা ক্লায়েন্ট দ্বারা অবৈধ বলে বিবেচিত হয়। অতএব, সমস্ত ThreatType এবং ThreatAttribute enum মানগুলির বৈধতা পরীক্ষা করা ক্লায়েন্টের দায়িত্ব; যদি কোনো মান অবৈধ বলে বিবেচিত হয়, ক্লায়েন্টকে অবশ্যই সম্পূর্ণ FullHashDetail বার্তাটি উপেক্ষা করতে হবে।

JSON প্রতিনিধিত্ব 
{
  "threatType": enum (ThreatType),
  "attributes": [
    enum (ThreatAttribute)
  ]
}
ক্ষেত্র
threatType

enum ( ThreatType )

হুমকির ধরন। এই মাঠ কখনই খালি হবে না।

attributes[]

enum ( ThreatAttribute )

অবিন্যস্ত তালিকা. সেই সম্পূর্ণ হ্যাশ সম্পর্কে অতিরিক্ত বৈশিষ্ট্য। এই খালি হতে পারে.

থ্রেট টাইপ

হুমকির ধরন।

Enums
THREAT_TYPE_UNSPECIFIED অজানা হুমকি প্রকার। যদি এটি সার্ভার দ্বারা ফেরত দেওয়া হয়, তাহলে ক্লায়েন্ট সম্পূর্ণরূপে পরিবেষ্টিত FullHashDetail উপেক্ষা করবে।
MALWARE

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

আরো তথ্য এখানে পাওয়া যাবে.

SOCIAL_ENGINEERING

সামাজিক প্রকৌশল হুমকি টাইপ. সোশ্যাল ইঞ্জিনিয়ারিং পৃষ্ঠাগুলি মিথ্যাভাবে একটি তৃতীয় পক্ষের পক্ষে কাজ করার উদ্দেশ্য নিয়ে দর্শকদের বিভ্রান্ত করার উদ্দেশ্যে এমন একটি ক্রিয়া সম্পাদন করে যার মাধ্যমে দর্শক শুধুমাত্র সেই তৃতীয় পক্ষের একজন সত্যিকারের এজেন্টকে বিশ্বাস করবে৷ ফিশিং হল এক ধরনের সোশ্যাল ইঞ্জিনিয়ারিং যা দর্শককে তথ্য প্রদানের সুনির্দিষ্ট ক্রিয়া সম্পাদনে প্ররোচিত করে, যেমন লগইন শংসাপত্র।

আরো তথ্য এখানে পাওয়া যাবে.

UNWANTED_SOFTWARE অবাঞ্ছিত সফ্টওয়্যার হুমকি টাইপ. অবাঞ্ছিত সফ্টওয়্যার হল এমন কোনও সফ্টওয়্যার যা Google-এর সফ্টওয়্যার নীতিগুলি মেনে চলে না কিন্তু ম্যালওয়্যার নয়৷
POTENTIALLY_HARMFUL_APPLICATION প্লে স্টোরের জন্য Google Play Protect ব্যবহার করে সম্ভাব্য ক্ষতিকারক অ্যাপ্লিকেশন হুমকির ধরন।

থ্রেট অ্যাট্রিবিউট

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

Enums
THREAT_ATTRIBUTE_UNSPECIFIED অজানা বৈশিষ্ট্য। যদি এটি সার্ভার দ্বারা ফেরত দেওয়া হয়, তাহলে ক্লায়েন্ট সম্পূর্ণরূপে পরিবেষ্টিত FullHashDetail উপেক্ষা করবে।
CANARY নির্দেশ করে যে হুমকি টাইপ প্রয়োগের জন্য ব্যবহার করা উচিত নয়।
FRAME_ONLY নির্দেশ করে যে হুমকি টাইপ শুধুমাত্র ফ্রেমে প্রয়োগের জন্য ব্যবহার করা উচিত।