Mail Admin Quarantine API के बारे में खास जानकारी

Mail Admin Quarantine API की मदद से, Google Workspace एडमिन प्रोग्राम के हिसाब से उन ईमेल को मैनेज कर सकते हैं जिन्हें Gmail ने एडमिन क्वॉरंटीन में रखा है. जब कोई मैसेज, Google Admin console में कॉन्फ़िगर किए गए नियमों के मुताबिक नहीं होता, तो उसे क्वॉरंटीन में भेज दिया जाता है. ये नियम, डेटा लीक होने की रोकथाम (डीएलपी), सुरक्षा या अन्य नियमों के पालन से जुड़े हो सकते हैं.

सुरक्षा और नियमों के पालन से जुड़े ऑटोमेशन बनाने के लिए, एपीआई का इस्तेमाल करें. जैसे:

  • क्वारंटीन किए गए मैसेज को एसआईईएम या एसओएआर प्लैटफ़ॉर्म पर वापस लाना, ताकि उनकी जांच की जा सके.
  • मैसेज को हैंडल करने का तरीका तय करने से पहले, मैसेज के हेडर, मुख्य हिस्से के स्निपेट, और अटैचमेंट की समीक्षा करना.
  • सुरक्षित मैसेज को रिलीज़ करना और असुरक्षित मैसेज को अस्वीकार करना. ऐसा अलग-अलग या 500 मैसेज के बैच में किया जा सकता है.

मुख्य संसाधन

Admin Quarantine API, किसी ग्राहक के लिए ये संसाधन दिखाता है:

संसाधन संसाधन का नाम ब्यौरा
ग्राहक customers/CUSTOMER_ID आपका Google Workspace खाता. ज़्यादा जानकारी के लिए, अपना ग्राहक आईडी ढूंढना लेख पढ़ें.
customers.quarantinedMessages customers/CUSTOMER_ID/quarantinedMessages/MESSAGE_OWNER:MESSAGE_ID क्वॉरंटीन में रखा गया कोई ईमेल. MESSAGE_OWNER, मेलबॉक्स के मालिक का ईमेल पता है और MESSAGE_ID, Gmail मैसेज का आईडी है जिसे बदला नहीं जा सकता.
customers.quarantines customers/CUSTOMER_ID/quarantines/QUARANTINE_ID Admin console में कॉन्फ़िगर की गई क्वॉरंटीन सेटिंग.
customers.operations customers/CUSTOMER_ID/operations/OPERATION_ID ज़्यादा समय तक चलने वाली कार्रवाई, जो बैच रिलीज़ या बैच अस्वीकार करने के अनुरोध को ट्रैक करती है.

QuarantinedMessage में इनमें से कोई एक State ऑब्जेक्ट शामिल होता है:

राज्य ब्यौरा
PENDING_TRIAGE मैसेज को क्वॉरंटीन में रखा जाता है और एडमिन के फ़ैसले का इंतज़ार किया जाता है.
RELEASED किसी एडमिन ने मैसेज को रिलीज़ किया और Gmail ने उसे डिलीवर कर दिया.
DENIED किसी एडमिन ने मैसेज को अस्वीकार कर दिया और Gmail ने उसे हटा दिया.

तरीके

सभी अनुरोधों में https://mailadminquarantine.googleapis.com/v1 को टारगेट किया गया है.

तरीका एचटीटीपी अनुरोध ब्यौरा
customers.quarantinedMessages.list GET /customers/*/quarantinedMessages पिछले 30 दिनों में क्वॉरंटीन किए गए मैसेज की सूची दिखाता है.
customers.quarantinedMessages.search POST /customers/*/quarantinedMessages:search यह फ़िल्टर या Gmail सर्च क्वेरी का इस्तेमाल करके, क्वॉरंटीन किए गए मैसेज खोजता है.
customers.quarantinedMessages.get GET /customers/*/quarantinedMessages/* मेटाडेटा, पार्स किया गया कॉन्टेंट या रॉ RFC 2822 मैसेज मिलता है.
customers.quarantinedMessages.release POST /customers/*/quarantinedMessages/*:release यह फ़ंक्शन, डिलीवरी के लिए एक मैसेज रिलीज़ करता है.
customers.quarantinedMessages.deny POST /customers/*/quarantinedMessages/*:deny किसी एक मैसेज को अस्वीकार करता है.
customers.quarantinedMessages.batchRelease POST /customers/*/quarantinedMessages:batchRelease यह एसिंक्रोनस तरीके से, ज़्यादा से ज़्यादा 500 मैसेज रिलीज़ करता है.
customers.quarantinedMessages.batchDeny POST /customers/*/quarantinedMessages:batchDeny यह एसिंक्रोनस तरीके से, ज़्यादा से ज़्यादा 500 मैसेज को अस्वीकार करता है.
customers.operations.get GET /customers/*/operations/* इससे बैच ऑपरेशन की स्थिति और नतीजे मिलते हैं.
customers.quarantines.list GET /customers/*/quarantines ग्राहक के लिए कॉन्फ़िगर किए गए क्वॉरंटीन की सूची दिखाता है.
customers.quarantines.get GET /customers/*/quarantines/* क्वारंटीन का डिसप्ले नेम और ब्यौरा दिखाता है.

लागू करने के मुख्य चरण

  1. एपीआई सेट अप करना: डेवलपर के लिए झलक वाले प्रोग्राम में शामिल हों. इसके बाद, अपने Google Cloud प्रोजेक्ट में एपीआई चालू करें, अपना ग्राहक आईडी ढूंढें, और एडमिन के ज़रूरी अधिकार दें.
  2. पूरे डोमेन के लिए ऐक्सेस देने की सुविधा के साथ अनुमति दें: एक सेवा खाता बनाएं. इसके बाद, Admin Quarantine API के स्कोप के साथ, पूरे डोमेन के लिए ऐक्सेस देने की सुविधा को कॉन्फ़िगर करें. साथ ही, ऐसा ऐक्सेस टोकन पाएं जो एडमिन की पहचान का इस्तेमाल करता हो.
  3. मैसेज को प्राथमिकता के हिसाब से व्यवस्थित करना:
    1. क्वॉरंटीन किए गए मैसेज की सूची देखना और उन्हें खोजना.
    2. मैसेज की जानकारी पाना.
    3. किसी मैसेज को रिलीज़ या अस्वीकार करना या मैसेज को बैच में रिलीज़ या अस्वीकार करना.
  4. इस्तेमाल के कोटा के अंदर रहें.

ऑडिट लॉगिंग

क्वारंटीन किए गए मैसेज को पढ़ने या उनमें बदलाव करने वाले हर एपीआई कॉल को, Admin console के ऑडिट और जांच लॉग में रिकॉर्ड किया जाता है. यह लॉग, उस एडमिन के नाम से रिकॉर्ड किया जाता है जिसके खाते से अनुरोध किया गया है.

अगले चरण