मुख्य सामग्री पर जाएँ

कंटेंट प्रबंधन policies परिभाषित करें

आप निर्बाध process flow optimisation प्राप्त करने के लिए Glasswall Halo का उपयोग कर सकते हैं, जिससे आप कंटेंट मैनेजमेंट policies को कुशलतापूर्वक प्रबंधित कर सकें।

कंटेंट मैनेजमेंट का उपयोग क्यों करें?​

कंटेंट मैनेजमेंट policies, या संक्षेप में policies, परिभाषित करके आप configuration flags के एक शक्तिशाली सेट का उपयोग कर सकते हैं, जो CDR प्रक्रिया के दौरान फ़ाइलों और उनकी सामग्री के उपचार को नियंत्रित करता है।

विविध सिस्टम परिदृश्यों में, अलग-अलग कंटेंट मैनेजमेंट flags की आवश्यकता उत्पन्न हो सकती है। Glasswall Halo की लचीलापन आपको प्रत्येक स्थिति के लिए flags के अलग-अलग सेट लागू करने की अनुमति देती है, जिससे एक ही सिस्टम के भीतर अनेक use cases को समायोजित किया जा सकता है और manual intervention के बिना edge case परिदृश्यों को कुशलतापूर्वक संभाला जा सकता है।

आप policies को प्रोग्रामेटिक रूप से भी प्रबंधित कर सकते हैं, जिससे versions के बीच परिवर्तनों को संग्रहीत और बनाए रखने का overhead समाप्त हो जाता है। एकीकृत integration point के साथ, आप policies को नाम से आसानी से प्रबंधित कर सकते हैं और सरलता से file rebuilds का अनुरोध कर सकते हैं, जिससे आपकी प्रक्रियाएँ सुव्यवस्थित होती हैं और Glasswall Halo के विरुद्ध requests निष्पादित करने के लिए आवश्यक code की मात्रा कम हो जाती है।

API दस्तावेज़ीकरण​

किसी अनुरोध में परिभाषित policy का उपयोग करने के लिए, आपके पास दो विकल्प हैं।

  • आप प्रदान किए गए API calls का उपयोग करके एक named policy बना सकते हैं।
  • Or if you prefer a more straightforward approach, you can directly use the default policy that comes pre-installed with all Glasswall Halo installations.
    • डिफ़ॉल्ट policy को प्रबंधित करना Glasswall Halo portal के माध्यम से आसान है, जो आपकी आवश्यकताओं के अनुसार इसे अनुकूलित करने के लिए एक उपयोगकर्ता-अनुकूल इंटरफ़ेस प्रदान करता है।
    • portal के माध्यम से डिफ़ॉल्ट policy सेट करने पर, यह फ़ाइल rebuilding के लिए किसी भी API call में स्वतः उपयोग की जाएगी, बशर्ते कि कोई dynamic या named policy स्पष्ट रूप से निर्दिष्ट न की गई हो।

अधिक जानकारी के लिए कृपया हमारे API Documentation को देखें।

API प्रमाणीकरण​

जानें कि Glasswall Halo को authenticate कैसे करें

Glasswall Halo events​

  1. नई policy बनाने के लिए, Policy management API में निम्नलिखित API call का उपयोग करें, और request body में अपनी इच्छित policy settings दें।

    POST api/v1/policies/{policyname}
    {
     "status": "enabled",
     "policySettings": {
     "contentManagementFlags": {
       "pdfContentManagement": {
         "acroform": "sanitise",
         "digitalSignatures": "sanitise",
         "embeddedFiles": "sanitise",
         "embeddedImages": "sanitise",
         "externalHyperlinks": "sanitise",
         "internalHyperlinks": "sanitise",
         "javascript": "sanitise",
         "metadata": "sanitise",
         "actionsAll": "sanitise",
         "retainExportedStreams": 1,
         "valueOutsideReasonableLimits": 1
       },
       "wordContentManagement": {
         "dynamicDataExchange": "sanitise",
         "embeddedFiles": "sanitise",
         "embeddedImages": "sanitise",
         "externalHyperlinks": "sanitise",
         "hiddenData": "allow",
         "internalHyperlinks": "sanitise",
         "macros": "sanitise",
         "metadata": "sanitise",
         "reviewComments": "sanitise",
         "trackedChanges": "sanitise"
       },
       "excelContentManagement": {
         "connections": "sanitise",
         "dynamicDataExchange": "sanitise",
         "embeddedFiles": "sanitise",
         "embeddedImages": "sanitise",
         "externalHyperlinks": "sanitise",
         "hiddenData": "allow",
         "internalHyperlinks": "sanitise",
         "macros": "sanitise",
         "metadata": "sanitise",
         "reviewComments": "sanitise",
         "trackedChanges": "sanitise"
       },
       "powerPointContentManagement": {
         "embeddedFiles": "sanitise",
         "embeddedImages": "sanitise",
         "externalHyperlinks": "sanitise",
         "hiddenData": "allow",
         "internalHyperlinks": "sanitise",
         "macros": "sanitise",
         "metadata": "sanitise",
         "reviewComments": "sanitise",
         "slideNotes": "sanitise"
       },
       "svgConfig": {
         "hyperlinks": "sanitise",
         "foreignObjects": "sanitise",
         "scripts": "sanitise"
       },
       "webpConfig": {
         "metadata": "sanitise"
       },
       "tiffConfig": {
         "geoTiff": "sanitise"
       },
       "archiveConfig": {
         "bmp": 1,
         "doc": 1,
         "docx": 1,
         "emf": 1,
         "gif": 1,
         "jpg": 1,
         "wav": 1,
         "elf": 1,
         "pe": 1,
         "mp4": 1,
         "mpg": 1,
         "pdf": 1,
         "png": 1,
         "ppt": 1,
         "pptx": 1,
         "tif": 1,
         "wmf": 1,
         "xls": 1,
         "xlsx": 1,
         "mp3": 1,
         "rtf": 1,
         "coff": 1,
         "macho": 1,
         "svg": 1,
         "webp": 1,
         "unknown": 1
          }
        }
      }
    }

  2. यदि आप नई policy बनाना नहीं चाहते हैं, बल्कि मौजूदा डिफ़ॉल्ट policy को अपडेट करना चाहते हैं, तो आप request body में नई policy settings भेजकर निम्नलिखित endpoint पर यह कर सकते हैं:

    PUT api/v1/policies/default

  3. जब आपकी policy सफलतापूर्वक बन जाए या संपादित हो जाए, तब आप इसे Glasswall Halo के भीतर अपने requests में उपयोग कर सकते हैं। किसी rebuild request पर एक विशिष्ट policy कैसे लागू करें, यह जानने के लिए अगले अनुभाग को देखें।

इन चरणों का पालन करके, आप आसानी से policies को प्रबंधित कर सकते हैं और उन्हें Glasswall Halo में अपनी आवश्यकताओं के अनुसार अनुकूलित कर सकते हैं।

अनुरोध निर्माण​

Glasswall Halo policies का उपयोग करने के तीन तरीके प्रदान करता है:

  • डिफ़ॉल्ट
  • Named
  • Dynamic

प्रत्येक तरीका विशिष्ट CDR endpoints पर लागू किया जा सकता है:

डिफ़ॉल्ट policy​

डिफ़ॉल्ट policy वह पहले से इंस्टॉल की गई policy है जो Glasswall Halo के साथ आती है। हालांकि इसे संपादित किया जा सकता है, लेकिन यदि अनुरोध में कोई अन्य policy निर्दिष्ट नहीं की गई है, तो फ़ाइल प्रोसेसिंग के दौरान यही डिफ़ॉल्ट policy उपयोग की जाती है। यदि Policy management API उपलब्ध नहीं है, तो fallback के रूप में एक "Sanitise all" policy लागू की जाती है – जिससे संभवतः सबसे प्रतिबंधात्मक policy लागू होती है। अनुरोध body में content management flags के बिना निम्नलिखित endpoints पर अनुरोध भेजने से प्रोसेसिंग पर डिफ़ॉल्ट policy लागू होगी:

POST api/v3/cdr-file
POST api/v3/cdr

नामित policy​

जब आप किसी नामित policy का उपयोग करते हैं, तो आप URL में query parameter के रूप में policy नाम के साथ एक अनुरोध सबमिट करते हैं। इसके बाद platform उस नामित policy को खोजेगा, जिसे पहले बनाया गया होना चाहिए, और उसे उसी अनुसार लागू करेगा।

इसे प्राप्त करने के लिए, निम्नलिखित urls पर अनुरोध भेजें:

POST api/v3/cdr-file?policyName={policyname}
POST api/v3/cdr?policyName={policyname}

चूंकि डिफ़ॉल्ट policy मूलतः एक नामित policy है, इसलिए आप प्रोसेसिंग के दौरान डिफ़ॉल्ट policy लागू करने के लिए query parameter value के रूप में 'default' पास कर सकते हैं।

डायनेमिक policy​

डायनेमिक policy का अर्थ है अनुरोध के समय सीधे policy settings पास करना। आप निम्नलिखित URLs पर अनुरोध कर सकते हैं और फ़ाइल प्रोसेसिंग के दौरान उन विशिष्ट settings को लागू करने के लिए request body के हिस्से के रूप में content management flags शामिल कर सकते हैं। यदि कोई policy name भी प्रदान किया गया है, तो डायनेमिक policy किसी भी अन्य policy पर प्राथमिकता लेती है।

POST api/v3/cdr-file
POST api/v3/cdr
{
  "ContentManagementFlags": {
    "PdfContentManagement": {
      "Acroform": 1,
      "ActionsAll": 1,
      "EmbeddedFiles": 1,
      "EmbeddedImages": 1,
      "ExternalHyperlinks": 1,
      "InternalHyperlinks": 1,
      "Javascript": 1,
      "Metadata": 1,
      "DigitalSignatures": 1,
      "ValueOutsideReasonableLimits": 1,
      "RetainExportedStreams": 1
    },
    "WordContentManagement": {
      "DynamicDataExchange": 1,
      "EmbeddedFiles": 1,
      "EmbeddedImages": 1,
      "ExternalHyperlinks": 1,
      "HiddenData": 0,
      "InternalHyperlinks": 1,
      "Macros": 1,
      "Metadata": 1,
      "ReviewComments": 1,
      "TrackedChanges": 1
    },
    "ExcelContentManagement": {
      "DynamicDataExchange": 1,
      "EmbeddedFiles": 1,
      "EmbeddedImages": 1,
      "ExternalHyperlinks": 1,
      "HiddenData": 1,
      "InternalHyperlinks": 1,
      "Macros": 1,
      "Metadata": 1,
      "ReviewComments": 1,
      "TrackedChanges": 1,
      "Connections": 1
    },
    "PowerPointContentManagement": {
      "EmbeddedFiles": 1,
      "EmbeddedImages": 1,
      "ExternalHyperlinks": 1,
      "HiddenData": 1,
      "InternalHyperlinks": 1,
      "Macros": 1,
      "Metadata": 1,
      "ReviewComments": 1,
      "SlideNotes": 1
    },
    "ArchiveConfig": {
      "bmp": 1,
      "doc": 1,
      "docx": 1,
      "emf": 1,
      "gif": 1,
      "jpg": 1,
      "wav": 1,
      "elf": 1,
      "pe": 1,
      "mp4": 1,
      "mpg": 1,
      "pdf": 1,
      "png": 1,
      "ppt": 1,
      "pptx": 1,
      "tif": 1,
      "wmf": 1,
      "xls": 1,
      "xlsx": 1,
      "mp3": 1,
      "rtf": 1,
      "coff": 1,
      "macho": 1,
      "svg": 1,
      "webp": 1,
      "unknown": 1
    },
    "SvgConfig": {
      "ForeignObjects": 1,
      "Hyperlinks": 1,
      "Scripts": 1
    },
    "WebpConfig": {
      "Metadata": 1
    },
    "TiffConfig": {
      "GeoTiff": 1
    }
  }
}

इन तीनों policy approaches को समझकर और उनका उपयोग करके, आप फ़ाइल प्रोसेसिंग के दौरान अपनी विशिष्ट आवश्यकताओं को पूरा करने के लिए Glasswall Halo के व्यवहार को प्रभावी रूप से अनुकूलित कर सकते हैं।

रिस्पॉन्स हैंडलिंग​

response के हिस्से के रूप में, आपको output में केवल प्रोसेस की गई फ़ाइल ही नहीं बल्कि headers का एक सेट भी प्राप्त होगा। इन headers में, एक प्रमुख header विशेष रुचि का है: x-applied-policy। इस header को देखकर आप निर्धारित कर सकते हैं कि प्रोसेसिंग के दौरान कौन-सी policy लागू की गई थी। x-applied-policy header निम्नलिखित values ले सकता है:

  • Name लागू की गई नामित policy
  • Default कॉन्फ़िगर की गई डिफ़ॉल्ट policy लागू की गई थी
  • Service-dynamic अनुरोध के साथ एक डायनेमिक policy सबमिट की गई और लागू की गई
  • Glasswall-fallback fallback policy लागू की गई क्योंकि निर्दिष्ट policy उपलब्ध नहीं थी

x-applied-policy हेडर में मान की जांच करके, आप यह निर्धारित कर सकते हैं कि फ़ाइल को प्रोसेस करने के लिए कौन-सी policy उपयोग की गई थी। यह जानकारी Glasswall Halo में policy के अनुप्रयोग को ट्रैक करने और समझने में सहायक है।

सारांश​

विभिन्न परिस्थितियों में अलग-अलग policies लागू करने की क्षमता के साथ, Glasswall Halo आपको आपकी विशिष्ट आवश्यकताओं के अनुरूप policies परिभाषित करने में सक्षम बनाता है। इन policies को नाम देकर, आप व्यावसायिक स्थिति या अपने application के flow के आधार पर, अलग-अलग नियमों के साथ विभिन्न फ़ाइलों को सहज रूप से प्रोसेस कर सकते हैं।

कुछ संभावित परिदृश्य, जहाँ यह कार्यक्षमता विशेष रूप से उपयोगी सिद्ध होती है, इनमें शामिल हैं:

ईमेल flow​

ईमेल flow परिदृश्य में, आप प्रेषक और प्राप्तकर्ता के आधार पर फ़ाइलों को अलग-अलग तरीके से प्रोसेस करने की लचीलापन प्राप्त कर सकते हैं। नामित policies का उपयोग करके, आप विशिष्ट प्रेषकों से आने वाली या विशेष प्राप्तकर्ताओं के लिए भेजी जाने वाली फ़ाइलों हेतु अद्वितीय नियम परिभाषित कर सकते हैं। इस तरह, आप विभिन्न ईमेल स्रोतों और गंतव्यों के लिए उपयुक्त policies लागू कर सकते हैं।

फ़ाइल अपलोड​

नामित policies का उपयोग करके, आप विशिष्ट IP addresses या ranges के अनुरूप नियम बना सकते हैं, जिससे यह सुनिश्चित होता है कि विभिन्न स्रोतों से आने वाली फ़ाइलें उनके origin के आधार पर अलग-अलग प्रोसेसिंग से गुजरें।

उपयोगकर्ता भूमिकाएँ और अनुमतियाँ​

बहु-उपयोगकर्ता वातावरण में, आपके पास अलग-अलग access स्तरों और permissions के साथ विभिन्न user roles हो सकते हैं। उपयोगकर्ता की role के आधार पर, आप उनके द्वारा अपलोड या प्रोसेस की गई फ़ाइलों पर अलग-अलग policies लागू करना चाह सकते हैं। उदाहरण के लिए, administrators के पास फ़ाइलों को संभालने के लिए अधिक उदार policies हो सकती हैं, जबकि नियमित उपयोगकर्ताओं के लिए अधिक सख्त policies लागू हो सकती हैं।

भौगोलिक स्थान​

उपयोगकर्ता के भौगोलिक स्थान या फ़ाइल अपलोड संभालने वाले server के आधार पर, आप स्थानीय विनियमों या data protection laws का पालन सुनिश्चित करने के लिए विशिष्ट policies लागू करना चाह सकते हैं। अलग-अलग क्षेत्रों में data privacy की आवश्यकताएँ भिन्न हो सकती हैं, और location-based policies लागू करने से क्षेत्रीय कानूनों का अनुपालन सुनिश्चित होता है।

इन बहुमुखी policy management क्षमताओं के साथ, आप अपने application के भीतर फ़ाइल प्रोसेसिंग की विभिन्न आवश्यकताओं को कुशलतापूर्वक संभाल सकते हैं और अलग-अलग संदर्भों तथा परिदृश्यों के अनुसार अनुकूलित हो सकते हैं। नामित policies लागू करने की क्षमता आपको अपने व्यवसाय की विशिष्ट आवश्यकताओं और आपके application द्वारा सामना की जाने वाली अनूठी परिस्थितियों के अनुसार फ़ाइल हैंडलिंग और सुरक्षा उपायों को अनुकूलित करने में सक्षम बनाती है।

त्वरित शुरुआत​

Glasswall Halo को स्वयं आज़माने के लिए, कृपया हमारी Quick Start Guide देखें।