IP-Zugriffsendpunkt

Um den Datenzugriff innerhalb einer angegebenen Abfrage-Service-Sandbox zu sichern, verwenden Sie den IP-Zugriffsendpunkt, um die zulässigen IP-Bereiche zu verwalten. Mit dieser API können Sie IP-Bereiche abrufen, konfigurieren oder löschen, die mit der ID Ihres Unternehmens verknüpft sind.

Mit der IP-Zugriffs-API können Sie die folgenden Aktionen ausführen:

In diesem Dokument werden die Anfragen und Antworten behandelt, die Sie vom /security/ip-access-Endpunkt senden und empfangen können.

Alle IP-Bereiche abrufen fetch-all-ip-ranges

Rufen Sie eine Liste aller für Ihre Sandbox konfigurierten IP-Bereiche ab. Wenn keine IP-Bereiche festgelegt sind, sind standardmäßig alle IP-Adressen zulässig und die Antwort gibt in allowedIpRanges eine leere Liste zurück.

API-Format

GET /security/ip-access

Anfrage

curl -X GET https://platform.adobe.io/data/foundation/queryauth/security/ip-access \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit einer Liste der zulässigen IP-Bereiche der Sandbox zurückgegeben.

{
  "imsOrg": "{ORG_ID}",
  "sandboxName": "prod",
  "channel": "data_distiller",
  "allowedIpRanges": [
    {"ipRange": "136.23.110.0/23", "description": "VPN-1 gateway IPs"},
    {"ipRange": "101.10.1.1"}
  ]
}

Die folgende Tabelle enthält eine Beschreibung und ein Beispiel der Eigenschaften des Antwortschemas:

Neue IP-Bereiche festlegen

Bestehende IP-Bereiche überschreiben, indem eine neue Liste für die Sandbox festgelegt wird. Dieser Vorgang erfordert eine vollständige Liste der IP-Bereiche, einschließlich der unveränderten Bereiche.

API-Format

PUT /security/ip-access

Anfrage

curl -X PUT https://platform.adobe.io/data/foundation/queryauth/security/ip-access \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
     "ipRanges": [
       {"ipRange": "136.23.110.0/23", "description": "VPN-1 gateway IPs"},
       {"ipRange": "17.102.17.0/23", "description": "VPN-2 gateway IPs"},
       {"ipRange": "101.10.1.1"},
       {"ipRange": "163.77.30.9", "description": "Test server IP"}
     ]
   }'

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit Details zu den neu konfigurierten IP-Bereichen zurückgegeben.

{
  "imsOrg": "{ORG_ID}",
  "sandboxName": "prod",
  "channel": "data_distiller",
  "allowedIpRanges": [
    {"ipRange": "136.23.110.0/23", "description": "VPN-1 gateway IPs"},
    {"ipRange": "17.102.17.0/23", "description": "VPN-2 gateway IPs"},
    {"ipRange": "101.10.1.1"},
    {"ipRange": "163.77.30.9", "description": "Test server IP"}
  ]
}

IP-Bereiche löschen delete-ip-ranges

Entfernen Sie alle konfigurierten IP-Bereiche für die Sandbox. Diese Aktion löscht die IP-Bereiche und gibt die gelöschte IP-Liste zurück.

API-Format

DELETE /security/ip-access

Anfrage

curl -X DELETE https://platform.adobe.io/data/foundation/queryauth/security/ip-access \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit Details zu den gelöschten IP-Bereichen zurückgegeben.

{
  "imsOrg": "{ORG_ID}",
  "sandboxName": "prod",
  "channel": "data_distiller",
  "deletedIpRanges": [
    {"ipRange": "136.23.110.0/23", "description": "VPN-1 gateway IPs"},
    {"ipRange": "17.102.17.0/23", "description": "VPN-2 gateway IPs"},
    {"ipRange": "101.10.1.1"},
    {"ipRange": "163.77.30.9", "description": "Test server IP"}
  ]
}