Обзор
В рамках интеграции коннектора API Hub загрузка метаданных для пакетов прокси-серверов API и Sharedflow синхронизируется с API Hub. Эти пакеты могут содержать информацию, позволяющую идентифицировать личность (PII) или другие данные деликатного характера в конфигурациях правил. Эта функция позволяет маскировать идентифицированную информацию, позволяющую идентифицировать личность, до того, как пакеты будут загружены в API Hub. Это обеспечивает конфиденциальность данных и соответствие требованиям для вашей среды Edge for Private Cloud.
Метод маскировки
Маскировка конфиденциальной информации применяется с помощью выражений XPath, чтобы нацеливаться на определенные элементы в конфигурациях правил в формате XML внутри пакетов. Функция состоит из двух частей.
Маски по умолчанию
Apigee Edge для частного облака включает встроенный список выражений 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 |
Жестко заданное значение (метод PUT) | //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 для частного облака.
Как настроить специальные маски
Чтобы добавить собственные пути маскировки, измените свойство 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'] |
Значение параметра (где name='caller') | Маскирует конфиденциальные данные абонента. |
//AssignMessage/AssignVariable[Name='password']/Value |
AssignVariable Value (где Name='password') | Маскирует жестко заданные значения паролей. |
Маскированные правила
Значения целевых элементов будут замаскированы. Замаскированный контент загружается в центр API.
Пример правила 1 (StatisticsCollector – маскировка):
<StatisticsCollector name="publishPurchaseDetails"> <Statistics> <Statistic name="caller" type="string">****</Statistic> <Statistic name="location" type="string">****</Statistic> </Statistics> </StatisticsCollector>