Aan de slag met de API voor Distiller-verificatie voor gegevens
- Onderwerpen:
- Query's
Gemaakt voor:
- Ontwikkelaar
AVAILABILITYDe API voor Distiller-verificatie voor gegevens biedt organisaties een betere controle over gegevenstoegang via de SQL-interface in Adobe Experience Platform. U kunt deze API gebruiken om IP beperkingen te bepalen, gegevenstoegang tot gespecificeerde netwerken te beperken, en veiligheid controle te verbeteren.
In deze handleiding wordt beschreven hoe u de verificatiereferenties en -machtigingen kunt instellen die zijn vereist om aanroepen te kunnen uitvoeren naar de API voor Distiller-gegevensautorisatie.
Aan de slag
In de volgende secties vindt u informatie over het voorbereiden van de vereiste autorisatiewaarden en het indienen van uw eerste aanvragen bij de Data Distiller Authorization API.
Vereiste machtigingen
Om de beperkingen van de veilige gegevenstoegang in de Dienst van de Vraag toe te laten, hebt u de Manage Allowed List toestemming nodig. Deze toestemming staat organisaties toe om specifieke IP waaiers (in formaat IPv4 of IPv6) te bepalen die tot gegevens in Experience Platform via de SQL interface worden gemachtigd. De toegang wordt beheerd op het zandbakniveau, waar de gebruikers een lijst van goedgekeurde IP adressen of blokken kunnen vormen CIDR die toegang slechts tot toegelaten netwerken beperken.
NOTEDe volgende functies zijn beschikbaar met de machtiging Manage Allowed List :
- bepaalt toegestane IP waaiers: Slechts IP adressen of de blokken CIDR van deze bepaalde waaiers kunnen tot gegevens in Experience Platform toegang hebben gebruikend SQL door de Dienst van de Vraag.
- afdwingen IP waaiercontroles: De verbindingen van IPs buiten de toegestane waaiers worden ontkend.
- Controle en alarmerende mogelijkheden: Alle toegangspogingen, met inbegrip van ontkende verbindingen, worden geregistreerd als controlegebeurtenissen. Deze gebeurtenissen zijn beschikbaar in de Logboeken van de Controle van Adobe Experience Platform, toelatend controle van potentiële veiligheidsbreuken.
Waarden verzamelen voor vereiste koppen
Om vraag aan de Vergunning API van Distiller van Gegevens te maken, moet u het Experience Platform API authentificatieleerprogrammavoltooien, dat waarden voor vereiste kopballen in API vraag verstrekt. Neem de volgende kopteksten op in elke aanvraag:
- Vergunning:
Bearer {ACCESS_TOKEN} - x-api-sleutel:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID} - x-zandbak-naam:
{SANDBOX_NAME}
NOTEAlle verzoeken die een lading (POST, PUT, PATCH) bevatten vereisen ook deze kopbal:
- inhoud-Type:
application/json
Volgende stappen
Met de vereiste toestemmingen en verzamelde kopbalwaarden, bent u bereid beginnen IP beperkingen voor de Dienst van de Vraag te vormen. Ga verder naar de eindpuntdocumentatie voor gedetailleerde voorbeelden van CRUD verrichtingen, die omvatten:
- API-indeling en voorbeelden van verzoek-/responsparen.
- Kopteksten, ladingen, en reactiecodes voor elke verrichting.
Elk API vraagvoorbeeld toont aan hoe te om verzoeken te formatteren en reacties te interpreteren, die u veilige toegang tot uw gegevens in de Dienst van de Vraag helpen afdwingen.
Voor specifieke instructies bij het vormen van en het bevestigen van IP beperkingen, verwijs naar de IP documentatie van het eindpunt van de Toegangen de IP documentatie van het eindpunt van de Bevestiging.
Verwijs naar de de verwijzingsdocumentatie van OpenAPI van de Vergunning van Distiller van Gegevensom een gestandaardiseerd, machine-leesbaar formaat voor gemakkelijkere integratie, het testen, en de exploratie te bekijken.