IP-toegangseindpunt

Om gegevenstoegang binnen een gespecificeerde zandbak van de Dienst van de Vraag te beveiligen, gebruik het IP eindpunt van de Toegang om toegestane IP waaiers te beheren. U kunt deze API gebruiken om IP waaiers te halen, te vormen of te schrappen verbonden aan identiteitskaart van uw organisatie.

U kunt de volgende handelingen uitvoeren met de API voor IP-toegang:

Dit document behandelt de verzoeken en reacties die u kunt maken en ontvangen van het /security/ip-access eindpunt.

Alle IP-bereiken ophalen fetch-all-ip-ranges

Haal een lijst op van alle IP waaiers die voor uw zandbak worden gevormd. Als geen IP waaiers worden geplaatst, worden alle IPs toegestaan door gebrek, en de reactie keert een lege lijst in allowedIpRanges terug.

API formaat

GET /security/ip-access

Verzoek

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

Reactie

Een geslaagde reactie retourneert HTTP-status 200 met een lijst van de toegestane IP-bereiken van de sandbox.

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

De volgende tabel bevat een beschrijving en een voorbeeld van de eigenschappen van het reactieschema:

Nieuwe IP-bereiken instellen

Overschrijf bestaande IP waaiers door een nieuwe lijst voor de zandbak te plaatsen. Deze verrichting vereist een volledige lijst van IP waaiers, met inbegrip van om het even welke die onveranderd blijven.

API formaat

PUT /security/ip-access

Verzoek

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

Reactie

Een succesvolle reactie keert status 200 van HTTP met details van de onlangs gevormde IP waaiers terug.

{
  "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-bereiken verwijderen delete-ip-ranges

Verwijder alle gevormde IP waaiers voor de zandbak. Deze actie schrapt de IP waaiers en keert de geschrapte IP lijst terug.

API formaat

DELETE /security/ip-access

Verzoek

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

Reactie

Een succesvolle reactie keert status 200 van HTTP met details van de geschrapte IP waaiers terug.

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