Autentisering authentication

Översikt

The 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 ska Server API verifierar datastream access type inställning. 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 dataströmmens åtkomsttyp finns i dokumentationen om hur du skapa och konfigurera ett datastream.

Nedan visas en sammanfattning av beteendet utifrån datastream Access Type konfiguration och slutpunkten som begäran tas emot på.

Access Type
edge.adobedc.net
server.adobedc.net
blandad (standard)
Autentiserar inte begäran
Autentiserar begäran
autentiserad
Autentiserar begäran
Autentiserar begäran

API-anrop från en privat server på server.adobedc.net ska alltid vara autentiserade.

Förutsättningar prerequisites

Innan du kan ringa Server APIkontrollerar du att följande krav uppfylls:

  • Du har ett organisationskonto med tillgång till Adobe Experience Platform.
  • Ditt Experience Platform-konto har developer och user roller har aktiverats för Adobe Experience Platform API-produktprofilen. Kontakta Admin Console administratör för att 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 skapa ett nytt konto.

Samla in inloggningsuppgifter credentials

För att kunna ringa anrop till plattforms-API:er måste du först slutföra självstudiekurs om autentisering. 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: Bearer {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}
NOTE
Mer information om sandlådor i Experience Platform finns i översiktsdokumentation för sandlåda.

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, leta reda på produktprofilen som är kopplad till din API-nyckel och ange följande behörigheter:

  • I Sandboxes markerar du datastream-sandlådan.
  • I Data Management väljer du Manage Datasets behörighet.

Felsöka auktoriseringsfel troubleshooting-authorization

Felkod
Felmeddelande
Beskrivning
EXEG-0500-401
Ogiltig auktoriseringstoken

Det här felmeddelandet visas i följande situationer:

  • The authorization rubrikvärde saknas.
  • The authorization rubrikvärdet innehåller inte det obligatoriska Bearer token.
  • Angiven auktoriseringstoken har ett ogiltigt format.
  • Datastream kräver autentisering, men begäran saknar obligatoriska huvuden.
EXEG-0501-401
Ogiltig token för användarauktorisering

Det här felmeddelandet visas i följande situationer:

  • API-anropet saknar det nödvändiga x-user-token header.
  • Angiven användartoken har ett ogiltigt format.
EXEG-0502-401
Ogiltig auktoriseringstoken
Det här felmeddelandet visas när den angivna auktoriseringstoken har ett giltigt format (JWT), men signaturen är ogiltig. Kontrollera självstudiekurs om autentisering om du vill lära dig hur du får en giltig JWT-token.
EXEG-0503-401
Ogiltig auktoriseringstoken
Det här felmeddelandet visas när den angivna auktoriseringstoken har upphört att gälla. Gå igenom självstudiekurs om autentisering för att generera en ny token.
EXEG-0504-401
Den obligatoriska produktkontexten saknas

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
Obligatoriskt auktoriseringstokenomfång saknas
Detta fel gäller endast autentisering av tjänstkonto. Felmeddelandet visas när tjänstauktoriseringstoken som ingår i anropet tillhör ett tjänstkonto som inte har åtkomst till acp.foundation IMS-scope.
EXEG-0506-401
Sandlådan är inte tillgänglig för skrivning
Det här felmeddelandet visas när utvecklarkontot inte har WRITE åtkomst till sandlådan Experience Platform där datastream definieras.
recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b