Autentisering authentication
Översikt
Edge Network Server API hanterar både autentiserad och oautentiserad datainsamling, beroende på händelsekällan och API-samlingsdomänen.
För varje begäran verifierar Server API datastream access type-inställningen. Med den här inställningen kan kunderna konfigurera en datastam för att acceptera antingen autentiserade data eller både autentiserade och oautentiserade data. Som standard accepteras båda datatyperna.
Mer information om hur du konfigurerar åtkomsttypen för datastream finns i dokumentationen om hur du skapar och konfigurerar ett datastream.
Nedan visas en sammanfattning av beteendet, baserat på datastream Access Type-konfigurationen och slutpunkten som begäran tas emot på.
API-anrop från en privat server på server.adobedc.net
ska alltid autentiseras.
Förhandskrav prerequisites
Innan du kan ringa samtal till Server API måste du kontrollera att du uppfyller följande krav:
- Du har ett organisationskonto med tillgång till Adobe Experience Platform.
- Ditt Experience Platform-konto har rollerna
developer
ochuser
aktiverade för Adobe Experience Platform API-produktprofilen. Kontakta din Admin Console-administratör om du vill aktivera de här rollerna för ditt konto. - Du har en Adobe ID. Om du inte har någon Adobe ID går du till Adobe Developer Console och skapar ett nytt konto.
Samla in inloggningsuppgifter credentials
För att kunna ringa anrop till plattforms-API:er måste du först slutföra autentiseringssjälvstudiekursen. När du slutför självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla API-anrop för Experience Platform, vilket visas nedan:
- Behörighet: Bärare
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Resurser i Experience Platform kan isoleras till specifika virtuella sandlådor. I förfrågningar till plattforms-API:er kan du ange namnet och ID:t för sandlådan som åtgärden ska utföras i. Dessa är valfria parametrar.
- x-sandbox-name:
{SANDBOX_NAME}
Alla begäranden som innehåller en nyttolast (POST, PUT, PATCH) kräver ytterligare en medietypsrubrik:
- Innehållstyp:
application/json
Konfigurera skrivbehörigheter för datauppsättning dataset-write-permissions
Om du vill konfigurera skrivbehörigheter för datauppsättningar går du till Admin Console, letar reda på produktprofilen som är kopplad till din API-nyckel och anger följande behörigheter:
- I avsnittet Sandboxes markerar du datastream-sandlådan.
- Välj behörigheten Manage Datasets i avsnittet Data Management.
Felsöka auktoriseringsfel troubleshooting-authorization
EXEG-0500-401
Det här felmeddelandet visas i följande situationer:
- Rubrikvärdet
authorization
saknas. - Rubrikvärdet
authorization
innehåller inte den nödvändigaBearer
-token. - Angiven auktoriseringstoken har ett ogiltigt format.
- Datastream kräver autentisering, men begäran saknar obligatoriska huvuden.
EXEG-0501-401
Det här felmeddelandet visas i följande situationer:
- API-anropet saknar det obligatoriska
x-user-token
-huvudet. - Angiven användartoken har ett ogiltigt format.
EXEG-0502-401
EXEG-0503-401
EXEG-0504-401
Det här felmeddelandet visas i följande situationer:
- Utvecklarkontot har inte åtkomst till Adobe Experience Platform produktkontext.
- Företaget har ännu inte rätt till Adobe Experience Platform.
EXEG-0505-401
acp.foundation
.EXEG-0506-401
WRITE
-åtkomst till sandlådan Experience Platform där datastream definieras.