Package google.security.safebrowsing.v4

इंडेक्स

SafeBrowsing

Safe Browsing API की मदद से, क्लाइंट यह जांच कर सकते हैं कि वेब रिसॉर्स (आम तौर पर यूआरएल) असुरक्षित वेब रिसॉर्स की लगातार अपडेट होने वाली Google की सूची में शामिल हैं या नहीं. Safe Browsing APIs (v4) में Update API और Lookup API की सुविधाएं शामिल हैं.

Update API को हमारे बड़े क्लाइंट के लिए डिज़ाइन किया गया है. इसमें FindFullHashes और FetchThreatListUpdates तरीके शामिल हैं. Update API के लिए ज़रूरी है कि क्लाइंट, डाउनलोड की गई खतरे की सूचियों को स्थानीय डेटाबेस में सेव रखें.

सबसे पहले, क्लाइंट अपनी स्थानीय सूचियों से मैच करते हैं, ताकि किसी वेब रिसॉर्स की स्थिति (सुरक्षित या असुरक्षित) का पता लगाया जा सके. आम तौर पर, सूचियों में ब्लैकलिस्ट किए गए यूआरएल एक्सप्रेशन के हैश प्रीफ़िक्स शामिल होते हैं. किसी यूआरएल की जांच करने के लिए, क्लाइंट दिए गए यूआरएल के हैश जनरेट करते हैं और अपनी लोकल सूचियों में प्रीफ़िक्स के मेल खाने की जांच करते हैं. अगर कोई प्रीफ़िक्स मैच होता है, तो क्लाइंट FindFullHashes तरीके से, मैच हुए हैश प्रीफ़िक्स से जुड़े पूरे हैश हासिल करता है. इसके बाद, क्लाइंट स्थानीय फ़ुल हैश की तुलना, रिटर्न किए गए फ़ुल हैश से करता है. मैच होने का मतलब है कि यूआरएल असुरक्षित है.

दूसरा, क्लाइंट अपने स्थानीय डेटाबेस में , FetchThreatListUpdates तरीके से अपडेट पाते हैं. यह क्लाइंट की मौजूदा स्थिति को लेता है और क्लाइंट की अपडेट की गई स्थिति के साथ-साथ उन बदलावों को दिखाता है जिन्हें क्लाइंट को अपनी स्थानीय खतरे की सूचियों में लागू करना चाहिए.

Lookup API को हमारे छोटे क्लाइंट के लिए डिज़ाइन किया गया है. इसकी मदद से, वे FindThreatMatches तरीके का इस्तेमाल करके, रिसॉर्स को सीधे तौर पर, सुरक्षित ब्राउज़िंग की खतरे वाली सूचियों से मैच कर सकते हैं.

Update API या Lookup API का इस्तेमाल करने वाले क्लाइंट, ListThreatLists तरीके से डाउनलोड के लिए उपलब्ध, Safe Browsing की खतरे वाली सूचियों की सूची पा सकते हैं.

{-- TRUSTED_THREAT_REPORTER: Trusted threat clients can submit reports to Google for analysis via the SubmitThreatReport method. --}

FetchThreatListUpdates

rpc FetchThreatListUpdates(FetchThreatListUpdatesRequest) returns (FetchThreatListUpdatesResponse)

खतरे की सूची से जुड़े सबसे नए अपडेट फ़ेच करता है. क्लाइंट एक साथ कई सूचियों के लिए अपडेट का अनुरोध कर सकता है.
FindFullHashes

rpc FindFullHashes(FindFullHashesRequest) returns (FindFullHashesResponse)

अनुरोध किए गए हैश प्रीफ़िक्स से मेल खाने वाले पूरे हैश ढूंढता है.
FindThreatMatches

rpc FindThreatMatches(FindThreatMatchesRequest) returns (FindThreatMatchesResponse)

सुरक्षित ब्राउज़िंग की सूचियों से मैच होने वाली खतरे की जानकारी ढूंढता है.
ListThreatLists

rpc ListThreatLists(Empty) returns (ListThreatListsResponse)

डाउनलोड के लिए उपलब्ध, सुरक्षित ब्राउज़िंग की खतरे वाली सूचियों की जानकारी.

चेकसम

क्लाइंट के लोकल डेटाबेस की अनुमानित स्थिति.

फ़ील्ड
sha256

bytes

क्लाइंट स्टेटस का SHA256 हैश, यानी डेटाबेस में मौजूद सभी हैश की क्रम से लगाई गई सूची.

ClientInfo

सुरक्षित ब्राउज़िंग एपीआई के अनुरोधों से जुड़ा क्लाइंट मेटाडेटा.

फ़ील्ड
client_id

string

ऐसा क्लाइंट आईडी जो (उम्मीद है) सेफ़ ब्राउज़िंग API के क्लाइंट लागू करने की खास पहचान करता है.
client_version

string

क्लाइंट को लागू करने का वर्शन.

CompressionType

खतरे से जुड़ी एंट्री के सेट को कंप्रेस करने के तरीके.

Enums
COMPRESSION_TYPE_UNSPECIFIED अज्ञात.
RAW बिना कंप्रेस किया गया रॉ डेटा.
RICE राइस-गोलमब में एन्कोड किया गया डेटा.

FetchThreatListUpdatesRequest

Safe Browsing API के अपडेट के अनुरोध के बारे में बताता है. क्लाइंट एक ही अनुरोध में कई सूचियों के लिए अपडेट का अनुरोध कर सकते हैं. अगर सर्वर के पास उस सूची के लिए कोई अपडेट नहीं है, तो हो सकता है कि सर्वर सभी अनुरोधों का जवाब न दे. ध्यान दें: फ़ील्ड इंडेक्स 2 का इस्तेमाल नहीं किया जाता. अगला: 5

फ़ील्ड
client

ClientInfo

क्लाइंट का मेटाडेटा.
list_update_requests[]

ListUpdateRequest

खतरे की जिस सूची का अनुरोध किया गया था वह अपडेट हो जाती है.

ListUpdateRequest

सूची को अपडेट करने का एक अनुरोध.

फ़ील्ड
threat_type

ThreatType

सूची में मौजूद एंट्री से किस तरह का खतरा है.
platform_type

PlatformType

सूची में मौजूद एंट्री की वजह से, खतरे में पड़ने वाला प्लैटफ़ॉर्म टाइप.
threat_entry_type

ThreatEntryType

सूची में मौजूद एंट्री के टाइप.
state

bytes

अनुरोध की गई सूची के लिए क्लाइंट की मौजूदा स्थिति (क्लाइंट की एन्क्रिप्ट की गई स्थिति, जो सूची के पिछले अपडेट से मिली थी).
constraints

Constraints

इस अनुरोध से जुड़ी पाबंदियां.

कंस्ट्रेंट

इस अपडेट से जुड़ी पाबंदियां.

फ़ील्ड
max_update_entries

int32

प्रविष्टियों की ज़्यादा से ज़्यादा संख्या. अपडेट में इस वैल्यू से ज़्यादा एंट्री नहीं होंगी. यह 2**10 और 2**20 के बीच की 2 की घात होनी चाहिए. अगर यह शून्य है, तो अपडेट के साइज़ की कोई सीमा सेट नहीं की गई है.
max_database_entries

int32

यह तय करता है कि क्लाइंट, तय की गई सूची के लिए लोकल डेटाबेस में ज़्यादा से ज़्यादा कितनी एंट्री रखना चाहता है. यह 2**10 और 2**20 के बीच की 2 की घात होनी चाहिए. अगर यह शून्य है, तो इसका मतलब है कि डेटाबेस के साइज़ की कोई सीमा सेट नहीं की गई है.
region

string

किसी खास भौगोलिक जगह की सूची का अनुरोध करता है. अगर यह पैरामीटर सेट नहीं किया जाता है, तो सर्वर उपयोगकर्ता के आईपी पते के आधार पर यह वैल्यू चुन सकता है. ISO 3166-1 alpha-2 फ़ॉर्मैट में होना चाहिए.
supported_compressions[]

CompressionType

क्लाइंट के साथ काम करने वाले कंप्रेसन टाइप.
language

string

किसी खास भाषा के लिए सूचियों का अनुरोध करता है. ISO 639 alpha-2 फ़ॉर्मैट में होना चाहिए.
device_location

string

क्लाइंट की जगह की जानकारी, जो ISO 31166-1 alpha-2 इलाके के कोड के तौर पर दी जाती है.

FetchThreatListUpdatesResponse

फ़ील्ड
list_update_responses[]

ListUpdateResponse

क्लाइंट के अनुरोध पर सूची में किए गए अपडेट. यहां जवाबों की संख्या, क्लाइंट से भेजे गए अनुरोधों की संख्या से कम हो सकती है. उदाहरण के लिए, ऐसा तब होता है, जब सर्वर में किसी खास सूची के लिए कोई अपडेट न हो.
minimum_wait_duration

Duration

अपडेट का अनुरोध करने से पहले, क्लाइंट को कम से कम कितनी देर इंतज़ार करना होगा. अगर यह फ़ील्ड सेट नहीं किया गया है, तो क्लाइंट अपनी मर्ज़ी से कभी भी अपडेट कर सकते हैं.

ListUpdateResponse

किसी सूची से जुड़ा अपडेट.

फ़ील्ड
threat_type

ThreatType

खतरे का वह टाइप जिसके लिए डेटा दिखाया जाता है.
threat_entry_type

ThreatEntryType

धमकियों का फ़ॉर्मैट.
platform_type

PlatformType

वह प्लैटफ़ॉर्म टाइप जिसके लिए डेटा दिखाया जाता है.
response_type

ResponseType

जवाब का टाइप. इससे पता चलता है कि जवाब मिलने पर, क्लाइंट को कोई कार्रवाई करनी होगी.
additions[]

ThreatEntrySet

स्थानीय खतरे के टाइप की सूची में जोड़ने के लिए, एंट्री का एक सेट. एक ही जवाब में, कंप्रेस किए गए और रॉ डेटा को एक साथ भेजने की अनुमति देने के लिए, बार-बार इस्तेमाल किया जाता है.
removals[]

ThreatEntrySet

स्थानीय खतरे के टाइप की सूची से हटाने के लिए एंट्री का सेट. आम तौर पर, यह फ़ील्ड खाली होता है या इसमें सिर्फ़ एक ThreatEntrySet होता है.
new_client_state

bytes

एन्क्रिप्ट (सुरक्षित) किए गए फ़ॉर्मैट में, क्लाइंट की नई स्थिति. क्लाइंट को नहीं दिखता.
checksum

Checksum

क्लाइंट स्टेटस का अनुमानित SHA256 हैश. इसका मतलब है कि दिए गए अपडेट को लागू करने के बाद, डेटाबेस में मौजूद सभी हैश की क्रम से लगाई गई सूची. अगर क्लाइंट की स्थिति, उम्मीद के मुताबिक नहीं है, तो क्लाइंट को इस अपडेट को अनदेखा करना चाहिए और बाद में फिर से कोशिश करनी चाहिए.

ResponseType

क्लाइंट को भेजे गए जवाब का टाइप.

Enums
RESPONSE_TYPE_UNSPECIFIED अज्ञात.
PARTIAL_UPDATE क्लाइंट के मौजूदा लोकल डेटाबेस में कुछ अपडेट लागू किए जाते हैं.
FULL_UPDATE पूरे अपडेट, क्लाइंट के पूरे लोकल डेटाबेस को बदल देते हैं. इसका मतलब है कि क्लाइंट का वर्शन बहुत पुराना है या क्लाइंट में गड़बड़ी है.

FindFullHashesRequest

दिए गए हैश प्रीफ़िक्स से मैच होने वाले पूरे हैश दिखाने का अनुरोध.

फ़ील्ड
client

ClientInfo

क्लाइंट का मेटाडेटा.
client_states[]

bytes

क्लाइंट की हर स्थानीय खतरे की सूची के लिए, क्लाइंट की मौजूदा स्थिति.
threat_info

ThreatInfo

जांची जाने वाली सूचियां और हैश.
api_client

ClientInfo

क्लाइंट के लागू होने के बाद, बनाए गए उच्च-लेवल एपीआई के कॉलर से जुड़ा क्लाइंट मेटाडेटा.

FindFullHashesResponse

फ़ील्ड
matches[]

ThreatMatch

अनुरोध किए गए प्रीफ़िक्स से मैच करने वाले पूरे हैश.
minimum_wait_duration

Duration

हैश ढूंढने का अनुरोध करने से पहले, क्लाइंट को कम से कम इतनी देर इंतज़ार करना होगा. अगर यह फ़ील्ड सेट नहीं किया गया है, तो क्लाइंट जब चाहें अनुरोध कर सकते हैं.
negative_cache_duration

Duration

खतरे की सूची से मेल न खाने वाली इकाइयों के लिए, जवाब को कैश मेमोरी में कितने समय तक सेव रखना है.

FindThreatMatchesRequest

सूचियों के हिसाब से एंट्री की जांच करने का अनुरोध करें.

फ़ील्ड
client

ClientInfo

क्लाइंट का मेटाडेटा.
threat_info

ThreatInfo

मैच करने वाली सूचियां और एंट्री.

FindThreatMatchesResponse

फ़ील्ड
matches[]

ThreatMatch

खतरे की सूची मेल खाती है.

ListThreatListsResponse

फ़ील्ड
threat_lists[]

ThreatListDescriptor

क्लाइंट के लिए डाउनलोड करने के लिए उपलब्ध सूचियां.

PlatformType

प्लैटफ़ॉर्म के टाइप.

Enums
PLATFORM_TYPE_UNSPECIFIED प्लैटफ़ॉर्म की जानकारी नहीं है.
WINDOWS Windows को खतरा.
LINUX Linux को खतरा.
ANDROID Android को खतरा.
OSX OS X को खतरा.
IOS iOS को खतरा.
ANY_PLATFORM तय किए गए कम से कम एक प्लैटफ़ॉर्म को खतरा हो.
ALL_PLATFORMS यह खतरा, बताए गए सभी प्लैटफ़ॉर्म पर मौजूद है.
CHROME Chrome को खतरा.

RawHashes

किसी खास प्रीफ़िक्स की लंबाई के हैश फ़ॉर्मैट में, बिना कंप्रेस की गई खतरे की एंट्री. हैश का साइज़ 4 से 32 बाइट तक हो सकता है. ज़्यादातर हैश चार बाइट के होते हैं. हालांकि, अगर किसी लोकप्रिय यूआरएल के हैश से मेल खाने पर, कुछ हैश की लंबाई बढ़ जाती है.

इसका इस्तेमाल, उन क्लाइंट को ThreatEntrySet भेजने के लिए किया जाता है जो कंप्रेस करने की सुविधा के साथ काम नहीं करते. इसके अलावा, इसका इस्तेमाल उन क्लाइंट को चार से ज़्यादा बाइट वाले हैश भेजने के लिए भी किया जाता है जो कंप्रेस करने की सुविधा के साथ काम करते हैं.

फ़ील्ड
prefix_size

int32

यहां एन्कोड किए गए हर प्रीफ़िक्स के लिए बाइट की संख्या. इस फ़ील्ड में 4 (सबसे छोटा प्रीफ़िक्स) से 32 (पूरा SHA256 हैश) तक वर्ण हो सकते हैं.
raw_hashes

bytes

बाइनरी फ़ॉर्मैट में हैश, एक लंबी स्ट्रिंग में जोड़े जाते हैं. हैश को वर्णमाला के क्रम में लगाया जाता है. JSON API के उपयोगकर्ताओं के लिए, हैश को base64 में कोड में बदला जाता है.

RawIndices

किसी स्थानीय सूची से हटाने के लिए, रॉ इंडेक्स का सेट.

फ़ील्ड
indices[]

int32

वर्णमाला के क्रम में लगाई गई स्थानीय सूची से हटाने के लिए इंडेक्स.

RiceDeltaEncoding

राइस-गोलमब में एन्कोड किया गया डेटा. इसका इस्तेमाल, कंप्रेस किए गए चार बाइट वाले हैश या कंप्रेस किए गए हटाए गए इंडेक्स भेजने के लिए किया जाता है.

फ़ील्ड
first_value

int64

एन्कोड किए गए डेटा में पहली एंट्री का ऑफ़सेट या अगर सिर्फ़ एक इंटीजर कोड में बदला गया था, तो उस इंटीजर की वैल्यू. अगर फ़ील्ड खाली है या मौजूद नहीं है, तो उसे शून्य मानें.
rice_parameter

int32

Golomb-Rice पैरामीटर, जो 2 से 28 के बीच की कोई संख्या होती है. अगर num_entries शून्य है, तो यह फ़ील्ड मौजूद नहीं है (यानी शून्य है).
num_entries

int32

एन्क्रिप्ट किए गए डेटा में डेल्टा कोड वाली एंट्री की संख्या. अगर सिर्फ़ एक पूर्णांक कोड में बदला गया था, तो यह शून्य होगा और एक वैल्यू first_value में सेव की जाएगी.
encoded_data

bytes

कोड में बदले गए ऐसे डेल्टा जो Golomb-Rice कोडर का इस्तेमाल करके कोड में बदले जाते हैं.

ThreatEntry

किसी व्यक्ति को धमकी देने वाला कॉन्टेंट. उदाहरण के लिए, नुकसान पहुंचाने वाला यूआरएल या उसका हैश वर्शन. इनमें से सिर्फ़ एक फ़ील्ड सेट होना चाहिए.

फ़ील्ड
hash

bytes

हैश प्रीफ़िक्स, जिसमें SHA256 हैश के सबसे अहम 4 से 32 बाइट होते हैं. यह फ़ील्ड बाइनरी फ़ॉर्मैट में होता है. JSON अनुरोधों के लिए, हैश को base64 कोड में बदला जाता है.
url

string

यूआरएल.
digest

bytes

SHA256 फ़ॉर्मैट में, किसी एक्ज़ीक्यूटेबल का डाइजेस्ट. एपीआई, बाइनरी और हेक्स डाइजेस्ट, दोनों के साथ काम करता है. JSON अनुरोधों के लिए, डाइजेस्ट को base64 कोड में बदला जाता है.

ThreatEntryMetadata

किसी खास खतरे की एंट्री से जुड़ा मेटाडेटा. क्लाइंट को हर तरह के खतरे से जुड़े मेटाडेटा की कुंजी/वैल्यू के जोड़े के बारे में पता होना चाहिए.

फ़ील्ड
entries[]

MetadataEntry

मेटाडेटा एंट्री.

MetadataEntry

मेटाडेटा की एक एंट्री.

फ़ील्ड
key

bytes

मेटाडेटा एंट्री पासकोड. JSON अनुरोधों के लिए, कुंजी को base64 कोड में बदला जाता है.
value

bytes

मेटाडेटा एंट्री की वैल्यू. JSON अनुरोधों के लिए, वैल्यू को base64 में कोड में बदला जाता है.

ThreatEntrySet

खतरों का एक सेट, जिसे क्लाइंट के लोकल डेटाबेस में जोड़ा या हटाया जाना चाहिए.

फ़ील्ड
compression_type

CompressionType

इस सेट में मौजूद एंट्री के लिए, कंप्रेस करने का टाइप.
raw_hashes

RawHashes

SHA256 फ़ॉर्मैट में मौजूद रॉ एंट्री.
raw_indices

RawIndices

किसी लोकल लिस्टिंग के लिए, हटाए गए आइटम के रॉ इंडेक्स.
rice_hashes

RiceDeltaEncoding

Golomb-Rice कोडिंग का इस्तेमाल करके, SHA256 फ़ॉर्मैट की गई एंट्री के कोड में बदले गए चार बाइट वाले प्रीफ़िक्स. हैश को uint32 में बदला जाता है और उन्हें बढ़ते क्रम में लगाया जाता है. इसके बाद, डेल्टा को एन्कोड करके encoded_data के तौर पर सेव किया जाता है.
rice_indices

RiceDeltaEncoding

Golomb-Rice एन्कोडिंग का इस्तेमाल करके, कोड में बदले गए स्थानीय और वर्णमाला के क्रम में लगाए गए सूची के इंडेक्स. इसका इस्तेमाल, कॉन्टेंट हटाने के लिए कंप्रेस किए गए इंडेक्स भेजने के लिए किया जाता है. हटाए गए इंडेक्स (uint32) को बढ़ते क्रम में क्रम से लगाया जाता है. इसके बाद, डेल्टा को एन्कोड करके encoded_data के तौर पर सेव किया जाता है.

ThreatEntryType

खतरा पैदा करने वाली एंट्री के टाइप. खतरे की सूचियां, एक ही तरह की एंट्री का कलेक्शन होती हैं.

Enums
THREAT_ENTRY_TYPE_UNSPECIFIED नहीं बताया गया है
URL यूआरएल.
EXECUTABLE एक्ज़ीक्यूटेबल प्रोग्राम.

ThreatInfo

एक या उससे ज़्यादा खतरों की जानकारी, जो क्लाइंट खतरे की सूचियों में मैच की जांच करते समय सबमिट करता है.

फ़ील्ड
threat_types[]

ThreatType

खतरे के टाइप जिनकी जांच करनी है.
platform_types[]

PlatformType

जिन प्लैटफ़ॉर्म की जांच करनी है.
threat_entry_types[]

ThreatEntryType

एंट्री के टाइप, जिनकी जांच करनी है.
threat_entries[]

ThreatEntry

खतरे से जुड़ी वे एंट्री जिनकी जांच करनी है.

ThreatListDescriptor

इसमें किसी व्यक्ति को खतरा दिखाने वाली सूची के बारे में बताया गया है. किसी सूची को तीन पैरामीटर से तय किया जाता है: खतरे का टाइप, खतरे का टारगेट किया गया प्लैटफ़ॉर्म, और सूची में मौजूद एंट्री का टाइप.

फ़ील्ड
threat_type

ThreatType

सूची की एंट्री से होने वाले खतरे का टाइप.
platform_type

PlatformType

सूची की एंट्री से टारगेट किया गया प्लैटफ़ॉर्म टाइप.
threat_entry_type

ThreatEntryType

सूची में मौजूद एंट्री के टाइप.

ThreatMatch

सुरक्षित ब्राउज़िंग की खतरे वाली सूचियों में, खतरे की एंट्री की जांच करते समय मिला मैच.

फ़ील्ड
threat_type

ThreatType

इस खतरे से मेल खाने वाला खतरे का टाइप.
platform_type

PlatformType

इस खतरे से मैच करने वाला प्लैटफ़ॉर्म टाइप.
threat_entry_type

ThreatEntryType

इस खतरे से मैच करने वाली खतरे की एंट्री का टाइप.
threat

ThreatEntry

इस खतरे से मिलता-जुलता खतरा.
threat_entry_metadata

ThreatEntryMetadata

इस खतरे से जुड़ा वैकल्पिक मेटाडेटा.
cache_duration

Duration

खोज के नतीजे में मिले मैच के लिए कैश मेमोरी का लाइफ़टाइम. गलत नतीजे मिलने से बचने के लिए, क्लाइंट को इस जवाब को इस अवधि से ज़्यादा समय तक कैश मेमोरी में सेव नहीं करना चाहिए.

ThreatType

खतरों के टाइप.

Enums
THREAT_TYPE_UNSPECIFIED अज्ञात.
MALWARE मैलवेयर से जुड़े खतरे का टाइप.
SOCIAL_ENGINEERING सोशल इंजीनियरिंग से जुड़े खतरे का टाइप.
UNWANTED_SOFTWARE अनचाहे सॉफ़्टवेयर से होने वाली खतरे का टाइप.
POTENTIALLY_HARMFUL_APPLICATION नुकसान पहुंचा सकने वाले ऐप्लिकेशन से जुड़े खतरे का टाइप.