Google Cloud डेटा लीक होने की रोकथाम का एक्सटेंशन

यह Apigee Edge के दस्तावेज़ हैं.
पर जाएं Apigee X दस्तावेज़. info

वर्शन: 2.0.2

इस एक्सटेंशन का इस्तेमाल करके, कॉन्टेंट और इमेज में मौजूद संवेदनशील डेटा को छिपाया जा सकता है. उदाहरण के लिए, क्रेडिट कार्ड नंबर, नाम, और सोशल सिक्योरिटी नंबर छिपाए जा सकते हैं.

ज़रूरी शर्तें

इस कॉन्टेंट में, इस एक्सटेंशन को कॉन्फ़िगर करने और इस्तेमाल करने के बारे में जानकारी दी गई है. ExtensionCallout नीति का इस्तेमाल करके, एपीआई प्रॉक्सी से एक्सटेंशन का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:

1. अपने प्रोजेक्ट के लिए, Google Cloud DLP API चालू करना होगा.

2. अनुमति दें कि एक्सटेंशन के लिए, ऐक्सेस का वह लेवल देना होगा जो आपको चाहिए.

3. सेवा खाते के लिए, Google Cloud Console का इस्तेमाल करके कुंजी जनरेट करनी होगी.

4. कॉन्फ़िगरेशन रेफ़रंस का इस्तेमाल करके, एक्सटेंशन को जोड़ने और कॉन्फ़िगर करने के दौरान, जनरेट की गई कुंजी वाली JSON फ़ाइल के कॉन्टेंट का इस्तेमाल करना होगा.

Cloud Data Loss Prevention (DLP) के बारे में जानकारी

Cloud Data Loss Prevention (DLP) एक एपीआई है. इसका इस्तेमाल, टेक्स्ट, इमेज, और अन्य डेटा की जांच करके, संवेदनशील डेटा की पहचान करने और उसे मैनेज करने के लिए किया जाता है.

ज़्यादा जानकारी के लिए, डीएलपी की खास जानकारी देखें. इस एक्सटेंशन से जुड़े एपीआई के बारे में जानने के लिए, Cloud Data Loss Prevention (DLP) API देखें.

सैंपल

यहां दिए गए उदाहरणों से पता चलता है कि ExtensionCallout नीति का इस्तेमाल करके, Cloud DLP एक्सटेंशन की कार्रवाइयों के लिए सहायता कैसे कॉन्फ़िगर की जाती है.

इस सैंपल कोड को आज़माना आसान बनाने के लिए, इन उदाहरणों में AssignMessage नीति का इस्तेमाल किया गया है. इससे फ़्लो वैरिएबल की वैल्यू सेट की जाती हैं. साथ ही, Trace टूल में दिखाने के लिए, एक्सटेंशन के जवाब की वैल्यू भी वापस पाई जाती हैं.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithMask</Action>
    <Input><![CDATA[{
        "text" : "{request.content}",
        "mask" : "*"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{masked.output}</Payload>
    </Set>
</AssignMessage>

{"text":"Visit my site at ******************* Or contact me at *****************."}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithType</Action>
    <Input><![CDATA[{
        "text" : "{request.content}"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{masked.output}</Payload>
    </Set>
</AssignMessage>

{"text":"Visit my site at [URL] Or contact me at [EMAIL_ADDRESS]."}

कार्रवाइयां

deidentifyWithMask

text में मौजूद संवेदनशील डेटा की पहचान हटाएं और डेटा को mask वर्ण से मास्क करें. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में infoTypes प्रॉपर्टी में तय किए गए text के उन हिस्सों को मास्क करती है.

संवेदनशील डेटा को मास्क करने से, वर्णों की जगह कोई सिंबल आ जाता है. जैसे, तारा (*) या हैश (#). एक्सटेंशन के कॉन्फ़िगरेशन में, संवेदनशील डेटा के टाइप कॉन्फ़िगर किए जा सकते हैं.

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify",
  "mask" : "masking-character"
}]]></Input>

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}",
    "mask" : "*"
}]]></Input>
<Output>masked.output</Output>

{"text":"*****************"}

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू की जगह, तय किया गया वर्ण आ जाता है. उदाहरण के लिए,

{"text":"*********"}

deidentifyWithTemplate

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

टेंप्लेट, कॉन्फ़िगरेशन को अलग करने के लिए काम के होते हैं. जैसे, यह तय करना कि आपको किस चीज़ की जांच करनी है और उसकी पहचान कैसे हटानी है. साथ ही, एपीआई कॉल को लागू करने के लिए भी टेंप्लेट काम के होते हैं. टेंप्लेट की मदद से, कॉन्फ़िगरेशन को फिर से इस्तेमाल किया जा सकता है. साथ ही, उपयोगकर्ताओं और डेटा सेट में एक जैसा कॉन्फ़िगरेशन लागू किया जा सकता है.

अपने टेंप्लेट में, आपको उन infoTypes के बारे में बताना होगा जिनकी पहचान हटानी है. infoTypes की सूची देखने के लिए, InfoType detector reference देखें. पहचान हटाने की प्रोसेस में, टेंप्लेट में infoTypes प्रॉपर्टी में तय किए गए टेक्स्ट के उन हिस्सों को मास्क किया जाता है.

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify"
  "templateName" : "path-to-template"
}]]></Input>

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
    "text" : "{request.content}"
    "templateName" : "projects/[PROJECT_ID]/deidentifyTemplates/1231258663242"
}]]></Input>

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू की जगह, infoType के नाम आ जाते हैं.

deidentifyWithType

टेक्स्ट कॉन्टेंट में मौजूद संवेदनशील डेटा की पहचान हटाएं. साथ ही, मेल खाने वाली हर वैल्यू की जगह, infoType का नाम डालें. infoTypes की सूची देखने के लिए, InfoType detector reference देखें. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में infoTypes प्रॉपर्टी में तय किए गए text के उन हिस्सों को मास्क करती है.

यहां दिए गए उदाहरण में, सेवा फ़ोन नंबर की पहचान करती है. इसके बाद, उसकी जगह infoType का नाम डालती है.

• इनपुट टेक्स्ट:

  John Smith, 123 Main St, Seattle, WA 98122, 206-555-0123.

• नतीजा टेक्स्ट:

  John Smith, 123 Main St, Seattle, WA 98122, PHONE_NUMBER.

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify"
}]]></Input>

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}"
}]]></Input>

{"text":"EMAIL_ADDRESS"}

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू की जगह, infoType के नाम आ जाते हैं. उदाहरण के लिए,

{"text":"EMAIL_ADDRESS"}

redactImage

उस टेक्स्ट को छिपाएं जो infoType की किसी कैटगरी में आता है. छिपाए गए कॉन्टेंट की पहचान की जाती है और उसे अपारदर्शी आयत से छिपाया जाता है. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में infoTypes प्रॉपर्टी में तय किए गए image_data के उन हिस्सों को मास्क करती है.

infoTypes की सूची देखने के लिए, InfoType detector reference देखें.

अनुरोध के पैरामीटर

<Action>redactImage</Action>
<Input><![CDATA[{
  "image_data" : "base64-encoded-image-to-analyze",
  "image_type" : "type-of-image"
}]]></Input>

जवाब

वह इमेज जिसमें टेक्स्ट छिपाया गया है.

कॉन्फ़िगरेशन रेफ़रंस

एपीआई प्रॉक्सी में इस्तेमाल करने के लिए, इस एक्सटेंशन को कॉन्फ़िगर और डिप्लॉय करते समय, यहां दी गई जानकारी का इस्तेमाल करें. Apigee कंसोल का इस्तेमाल करके, एक्सटेंशन को कॉन्फ़िगर करने के चरणों के लिए, एक्सटेंशन जोड़ना और कॉन्फ़िगर करना देखें.

एक्सटेंशन की सामान्य प्रॉपर्टी

हर प्रॉपर्टी के लिए नीचे दी गई प्रॉपर्टी मौजूद हैं.

इस एक्सटेंशन पैकेज की प्रॉपर्टी

इस एक्सटेंशन के लिए, यहां दी गई कॉन्फ़िगरेशन प्रॉपर्टी की वैल्यू तय करें.