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å.

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 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 och user 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}
NOTE
Mer information om sandlådor i Experience Platform finns i översiktsdokumentationen för sandlådan.

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

Felkod
Felmeddelande
Beskrivning
EXEG-0500-401
Ogiltig auktoriseringstoken

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

  • Rubrikvärdet authorization saknas.
  • Rubrikvärdet authorization innehåller inte den nödvändiga 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 obligatoriska x-user-token-huvudet.
  • 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. Gå till självstudiekursen för autentisering och lär dig hur du hämtar 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älvstudiekursen för autentisering och 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 IMS-scopet acp.foundation.
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