Endpoint di accesso IP

Per proteggere l’accesso ai dati all’interno di una sandbox di Query Service specificata, utilizza l’endpoint di accesso IP per gestire gli intervalli IP consentiti. Puoi utilizzare questa API per recuperare, configurare o eliminare gli intervalli IP associati all’ID della tua organizzazione.

Con l’API di accesso IP puoi eseguire le seguenti azioni:

Questo documento descrive le richieste e le risposte che è possibile effettuare e ricevere dall'endpoint /security/ip-access.

Recupera tutti gli intervalli IP fetch-all-ip-ranges

Recupera un elenco di tutti gli intervalli IP configurati per la sandbox. Se non è impostato alcun intervallo IP, per impostazione predefinita sono consentiti tutti gli IP e la risposta restituisce un elenco vuoto in allowedIpRanges.

Formato API

GET /security/ip-access

Richiesta

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

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con un elenco degli intervalli IP consentiti della 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"}
  ]
}

La tabella seguente fornisce una descrizione ed un esempio delle proprietà dello schema di risposta:

Imposta nuovi intervalli IP

Sovrascrivi gli intervalli IP esistenti impostando un nuovo elenco per la sandbox. Questa operazione richiede un elenco completo di intervalli IP, compresi quelli che rimangono invariati.

Formato API

PUT /security/ip-access

Richiesta

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

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli degli intervalli IP appena configurati.

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

Elimina intervalli IP delete-ip-ranges

Rimuovi tutti gli intervalli IP configurati per la sandbox. Questa azione elimina gli intervalli IP e restituisce l’elenco IP eliminato.

Formato API

DELETE /security/ip-access

Richiesta

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

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli degli intervalli IP eliminati.

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