प्रॉक्सी और शेयर किए गए फ़्लो के बंडल में, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) को मास्क करने की सुविधा मैनेज करना

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

प्रॉक्सी और शेयरफ़्लो बंडल में, पीआईआई की मास्किंग मैनेज करना

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

मास्किंग का तरीका

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

डिफ़ॉल्ट मास्क

Apigee Edge में, XPath एक्सप्रेशन की पहले से तय की गई, इन-बिल्ट सूची शामिल होती है. इससे, सामान्य पीआईआई फ़ील्ड को अपने-आप टारगेट किया जाता है. अपलोड करने की प्रोसेस के दौरान, ये मास्क अपने-आप लागू हो जाते हैं.

डिफ़ॉल्ट मास्क की सूची:

कस्टम मास्क मैनेज करना

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

/v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge मैनेजमेंट एपीआई एंडपॉइंट का इस्तेमाल करके, अपने संगठन के कस्टम व्यक्तिगत पहचान से जुड़ी जानकारी मास्क मैनेज किए जा सकते हैं. ये कार्रवाइयां करने के लिए, आपके पास orgadmin की भूमिका होनी चाहिए.

एपीआई, किसी संगठन के लिए proxymasks नाम की XPath की एक सूची पर काम करता है.

XPath सूची से आइटम बनाने, बदलने, पाने, जोड़ने या मिटाने के सभी अनुरोधों और सफल जवाबों के लिए, यहां दिया गया JSON स्कीमा इस्तेमाल किया जाता है:

{
  "xpaths": [
    "//Path/To/Element"
  ]
}

1. कस्टम XPath सूची बनाना या बदलना (PUT)

PUT तरीके का इस्तेमाल करके, नई कस्टम सूची बनाई जा सकती है या किसी मौजूदा सूची के कॉन्टेंट को पूरी तरह से बदला जा सकता है. मौजूदा XPath ओवरराइट हो जाते हैं.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//StatisticsCollector/Statistics/Statistic[@name='caller']",
      "//AssignMessage/AssignVariable[Name='password']/Value"
    ]
  }'

अपडेट पूरा होने पर, 201 Created या 200K रिस्पॉन्स दिखता है. इसके साथ, यह मैसेज दिखता है: Success response (201 Created or 200 OK)

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

2. कस्टम XPath सूची पुनः पाना (GET)

GET तरीके का इस्तेमाल करके, कस्टम XPath एक्सप्रेशन की मौजूदा सूची पुनः पाई जा सकती है.

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

सूची पुनः पाने की प्रोसेस पूरी होने पर, 200K रिस्पॉन्स दिखता है. इसके साथ, यह मैसेज दिखता है:Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

3. सूची में XPath जोड़ना (POST append)

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

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/append \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

सूची में XPath जोड़ने की प्रोसेस पूरी होने पर, 200K रिस्पॉन्स दिखता है. इसके साथ, यह मैसेज दिखता है: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value",
    "//New/Appended/XPath"
  ]
}

4. सूची से खास XPath मिटाना (POST deleteItems)

POST तरीके का इस्तेमाल करके, मौजूदा सूची से खास XPath एक्सप्रेशन हटाए जा सकते हैं. अनुरोध में, हटाए जाने वाली XPath स्ट्रिंग शामिल होनी चाहिए.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/deleteItems \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

XPath मिटाने की प्रोसेस पूरी होने पर, 200K रिस्पॉन्स दिखता है. इसके साथ, यह मैसेज दिखता है: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

5. कस्टम XPath की पूरी सूची मिटाना (DELETE)

DELETE तरीके का इस्तेमाल करके, कस्टम XPath की सूची को पूरी तरह से हटाया जा सकता है. इससे सिर्फ़ कस्टम मास्क हटेंगे. डिफ़ॉल्ट मास्क अब भी लागू रहेंगे.

curl -X DELETE https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

कस्टम XPath की सूची मिटाने की प्रोसेस पूरी होने पर, 204 No Content रिस्पॉन्स दिखता है. इसके साथ, यह मैसेज दिखता है: Success response (204 No Content):

HTTP/1.1 204 No Content

मास्क किए गए बंडल अपडेट करना

कस्टम पीआईआई मास्किंग कॉन्फ़िगरेशन में बदलाव करने पर, पहले अपलोड किए गए एपीआई प्रॉक्सी बंडल को, मास्क के पुराने कॉन्फ़िगरेशन के साथ फिर से प्रोसेस करना होगा. इसके लिए, मास्क के नए कॉन्फ़िगरेशन का इस्तेमाल करना होगा. बंडल को मास्क की नई सेटिंग के साथ अपडेट करने के लिए, कृपया ज़रूरी रीप्रोसेसिंग शुरू करने के लिए सहायता टिकट सबमिट करें.