نمای کلی
به‌عنوان بخشی از یکپارچه‌سازی اتصال‌دهنده مرکز API، بارگذاری فراداده برای بسته‌های پراکسی API و sharedflow با «مرکز API» همگام‌سازی می‌شود. این دسته‌ها ممکن است حاوی اطلاعات شناساننده شخصی (PII) یا سایر داده‌های حساس در پیکربندی‌های خط‌مشی باشند. این ویژگی به شما امکان می‌دهد فیلدهای «اطلاعات شناسایی شخصی» شناسایی‌شده را قبل‌از بارگذاری دسته‌ها در کانون API بپوشانید و از این طریق حریم خصوصی داده‌ها و رعایت استانداردها را برای محیط Edge for Private Cloud تضمین کنید.
رویکرد پوشاندن
پوشاندن اطلاعات PII بااستفاده از عبارات XPath برای هدف‌یابی عناصر خاص در پیکربندی‌های خط‌مشی با قالب XML درون دسته‌ها اعمال می‌شود. این ویژگی به دو بخش تقسیم می‌شود.
ماسک‌های پیش‌فرض
Apigee Edge for Private Cloud شامل فهرست ازپیش‌تعریف‌شده و داخلی از عبارت‌های XPath (به‌نام پوشش‌های پیش‌فرض) است که به‌طور خودکار فیلدهایی را که به‌عنوان منابع بالقوه اطلاعات شخصی قابل شناسایی در خط‌مشی‌های مختلف شناخته می‌شوند هدف‌یابی می‌کند.
منابع بالقوه اطلاعات شخصی قابل شناسایی و پوشش‌های پیش‌فرض
جدول زیر خط‌مشی‌ها و عناصری را که برای آن‌ها پوشش پیش‌فرض اعمال می‌شود فهرست می‌کند:
| نام خط‌مشی | عنصر حساس | XPath ماسک پیش‌فرض | ارائه دلیل |
|---|---|---|---|
BasicAuthentication |
نام کاربری کدبندی‌شده | //BasicAuthentication/User |
هویت کاربر را به‌صورت نوشتار ساده مستقیماً ذخیره می‌کند. |
BasicAuthentication |
گذرواژه کدبندی‌شده | //BasicAuthentication/Password |
گذرواژه نوشتار ساده را مستقیماً ذخیره می‌کند. |
GenerateJWT |
کلید متقارن (محرمانه) | //GenerateJWT/SecretKey/Value |
کلید امضا/رمزگذاری متقارن کدبندی‌شده سخت. |
GenerateJWT |
کلید خصوصی | //GenerateJWT/PrivateKey/Value |
کلید خصوصی کدبندی‌شده با PEM برای امضای نامتقارن. |
GenerateJWT |
گذرواژه کلید خصوصی | //GenerateJWT/PrivateKey/Password |
گذرواژه رمزگشایی کلید خصوصی. |
GenerateJWS |
کلید متقارن (محرمانه) | //GenerateJWS/SecretKey/Value |
کلید امضا/رمزگذاری متقارن کدبندی‌شده سخت. |
GenerateJWS |
کلید خصوصی | //GenerateJWS/PrivateKey/Value |
کلید خصوصی کدبندی‌شده با PEM برای امضای نامتقارن. |
GenerateJWS |
گذرواژه کلید خصوصی | //GenerateJWS/PrivateKey/Password |
گذرواژه رمزگشایی کلید خصوصی. |
VerifyJWT |
کلید متقارن (محرمانه) | //VerifyJWT/SecretKey/Value |
کلید متقارن کدبندی‌شده برای درستی‌سنجی. |
VerifyJWS |
کلید متقارن (محرمانه) | //VerifyJWS/SecretKey/Value |
کلید متقارن کدبندی‌شده برای درستی‌سنجی. |
HMAC |
کلید رمز مشترک | //HMAC/SecretKey |
کلید مخفی کدبندی‌شده برای محاسبه HMAC. |
KeyValueMapOperations |
مقدار کدبندی‌شده (فروش) | //KeyValueMapOperations/Put/Value |
رمز سخت‌کدشده درحال نوشتن در KVM است. |
ServiceCallout |
نام کاربری «احراز هویت پایه» | //ServiceCallout//Authentication/BasicAuth/UserName |
نام کاربری کدبندی‌شده برای اصالت‌سنجی زیرینه. |
ServiceCallout |
گذرواژه «احراز هویت پایه»** | //ServiceCallout//Authentication/BasicAuth/Password |
گذرواژه کدبندی‌شده برای اصالت‌سنجی زیرینه. |
SAMLAssertion |
مقدار کلید خصوصی | //SAMLAssertion//PrivateKey/Value |
کلید خصوصی برای رمزگشایی/امضا. |
SAMLAssertion |
گذرواژه کلید خصوصی | //SAMLAssertion//PrivateKey/Password |
گذرواژه رمزگشایی کلید خصوصی. |
نقاب‌های سفارشی
برای فیلدهایی که به‌عنوان «اطلاعات شناسایی شخصی» شناسایی می‌کنید اما با پوشش‌های پیش‌فرض (مثل پیکربندی سفارشی در خط‌مشی‌ها) پوشش داده نمی‌شوند، می‌توانید فهرست عبارات XPath خودتان را ارائه دهید (پوشش‌های سفارشی).
مدیریت پوشش‌های سفارشی با به‌روزرسانی دارایی پیکربندی در فایل uapim-connector.properties در سیستم Edge for Private Cloud انجام می‌شود.
درحال پیکربندی کردن پوشش‌های سفارشی
برای افزودن مسیرهای پوشش سفارشی، دارایی conf_uapim_connector.uapim.mask.xpaths را در فایل پیکربندی اتصال‌دهنده به‌روز کنید:
- مسیر فایل پیکربندی:
/opt/apigee/customer/application/uapim-connector.properties - دارایی:
conf_uapim_connector.uapim.mask.xpaths
این دارایی فهرستی از عبارت‌های XPath را که با کاما از هم جدا شده‌اند می‌پذیرد و عناصر خاصی را که می‌خواهید مقادیرشان را بپوشانید هدف‌یابی می‌کند.
پیکربندی نمونه
برای پوشاندن مقدار متغیر سفارشی و فیلد آمار، دارایی را به‌صورت زیر تنظیم می‌کنید:
conf_uapim_connector.uapim.mask.xpaths=//StatisticsCollector/Statistics/Statistic[@name='caller'],//StatisticsCollector/Statistics/Statistic[@name='location'],//AssignMessage/AssignVariable[Name='password']/Value
| عبارت XPath | عنصر پوشیده‌شده | هدف |
|---|---|---|
//StatisticsCollector/Statistics/Statistic[@name='caller'] |
مقدار آمار (جایی که نام='تماس‌گیرنده') | هویت حساس تماس‌گیرنده را می‌پوشاند. |
//AssignMessage/AssignVariable[Name='password']/Value |
مقدار AssignVariable (که در آن Name='password') | مقادیر گذرواژه کدبندی‌شده را می‌پوشاند. |
خط‌مشی‌های پوشش‌داده‌شده
مقدار عناصر هدف‌یابی‌شده پوشانده خواهد شد. این محتوای پوشانده‌شده در مرکز API بارگذاری می‌شود.
خط‌مشی نمونه ۱ (StatisticsCollector - پوشانده‌شده):
<StatisticsCollector name="publishPurchaseDetails"> <Statistics> <Statistic name="caller" type="string">****</Statistic> <Statistic name="location" type="string">****</Statistic> </Statistics> </StatisticsCollector>