Zarządzanie maskowaniem informacji umożliwiających identyfikację w pakietach proxy i wspólnych przepływów

Wyświetlasz dokumentację Apigee Edge.
Zapoznaj się z dokumentacją Apigee X. info

Zarządzanie maskowaniem informacji umożliwiających identyfikację w pakietach serwera proxy i współdzielonych przepływów

W ramach procesu synchronizacji integracja łącznika centrum interfejsów API przesyła pakiety proxy interfejsu API do centrum interfejsów API. Te pakiety mogą zawierać dane wrażliwe lub informacje umożliwiające identyfikację w konfiguracjach zasad. Ta funkcja umożliwia maskowanie zidentyfikowanych pól informacji umożliwiających identyfikację, zanim pakiety zostaną przesłane do centrum interfejsów API.

Podejście do maskowania

Maskowanie informacji umożliwiających identyfikację jest stosowane za pomocą wyrażeń XPath, aby kierować reklamy na określone elementy w konfiguracjach zasad w pakietach serwera proxy i sharedflow w formacie XML, ale nie na inne ogólne elementy XML w pakiecie. Ta funkcja jest podzielona na 2 części:

Domyślne maski

Apigee Edge zawiera wstępnie zdefiniowaną, wbudowaną listę wyrażeń XPath, które automatycznie kierują reklamy na typowe pola informacji umożliwiających identyfikację. Maski są stosowane automatycznie podczas przesyłania.

Lista domyślnych masek:

Zarządzanie maskami niestandardowymi

Specjalny interfejs API umożliwia przesyłanie dostosowanej listy wyrażeń XPath w celu maskowania określonych pól, które uznasz za zawierające informacje umożliwiające identyfikację. Dzięki temu możesz mieć pewność, że Twoje unikalne potrzeby w zakresie ochrony danych są zaspokojone.

Niestandardowymi maskami informacji umożliwiających identyfikację możesz zarządzać za pomocą /v1/organizations/<var>ORG_NAME/uapim/proxymasks punktu końcowego interfejsu Edge Management API. Aby wykonać te operacje, musisz mieć rolę orgadmin.

Interfejs API działa na jednej liście wyrażeń XPath o nazwie proxymasks dla danej organizacji.

Wszystkie żądania i odpowiedzi dotyczące tworzenia, zastępowania, pobierania, dołączania lub usuwania elementów z listy XPath używają tego schematu JSON:

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

1. Tworzenie lub zastępowanie niestandardowej listy XPath (PUT)

Użyj metody PUT, aby utworzyć nową listę niestandardową lub całkowicie zastąpić zawartość istniejącej listy. Wszystkie dotychczasowe wyrażenia XPath zostaną zastąpione.

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"
    ]
  }'

Po zakończeniu aktualizacji wyświetli się odpowiedź 201 Created lub 200K z tym komunikatem: Success response (201 Created or 200 OK)

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

2. Pobieranie listy niestandardowych wyrażeń XPath (GET)

Aby pobrać bieżącą listę niestandardowych wyrażeń XPath, użyj metody GET.

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

Po zakończeniu pobierania wyświetli się odpowiedź 200K z tym komunikatem:Success response (200 OK):

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

3. Dołączanie do listy wyrażeń XPath (POST append)

Użyj metody POST, aby dodać do istniejącej listy co najmniej 1 wyrażenie XPath bez zastępowania bieżącej zawartości.

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"
    ]
  }'

Po zakończeniu dołączania wyświetli się odpowiedź 200K z tym komunikatem: Success response (200 OK):

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

4. Usuwanie z listy określonych ścieżek XPath (POST deleteItems)

Użyj metody POST, aby usunąć z dotychczasowej listy określone wyrażenia XPath. Prośba musi zawierać dokładne ciągi XPath, które mają zostać usunięte.

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"
    ]
  }'

Po zakończeniu usuwania pojawi się odpowiedź 200K z tym komunikatem: Success response (200 OK):

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

5. Usuwanie całej listy niestandardowych wyrażeń XPath (DELETE)

Aby całkowicie usunąć niestandardową listę XPath, użyj metody DELETE. Spowoduje to usunięcie tylko niestandardowych masek. Domyślne maski nadal będą stosowane.

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

Po zakończeniu usuwania pojawi się odpowiedź 204 No Content z tym komunikatem: Success response (204 No Content):

HTTP/1.1 204 No Content

Aktualizowanie zamaskowanych pakietów

Gdy zmodyfikujesz niestandardową konfigurację maskowania informacji umożliwiających identyfikację, pakiety proxy interfejsu API, które zostały wcześniej przesłane ze starszą konfiguracją maskowania, muszą zostać ponownie przetworzone przy użyciu najnowszych masek. Aby zaktualizować pakiety za pomocą najnowszych ustawień maskowania, prześlij zgłoszenie, aby rozpocząć niezbędne ponowne przetwarzanie.