Konfiguration av kundautentisering

Experience Platform erbjuder stor flexibilitet i de autentiseringsprotokoll som är tillgängliga för partners och kunder. Du kan konfigurera ditt mål så att det stöder någon av de autentiseringsmetoder som är branschstandard, som OAuth2, autentisering med innehavartoken, lösenordsautentisering och många andra.

På den här sidan beskrivs hur du konfigurerar målet med den autentiseringsmetod du föredrar. Baserat på den autentiseringskonfiguration som du använder när du skapar målet, kommer kunderna att se olika typer av autentiseringssidor när de ansluter till målet i användargränssnittet i Experience Platform.

Om du vill veta var den här komponenten passar in i en integrering som skapats med Destination SDK kan du läsa diagrammet i dokumentationen för konfigurationsalternativ eller följande sidor med en översikt över målkonfigurationen:

Innan kunder kan exportera data från Platform till ditt mål måste de skapa en ny anslutning mellan Experience Platform och ditt mål genom att följa stegen som beskrivs i självstudiekursen målanslutning.

När skapar ett mål via Destination SDK, definierar avsnittet customerAuthenticationConfigurations vad kunderna ser på autentiseringsskärmen. Beroende på autentiseringstypen för målet måste kunderna tillhandahålla olika autentiseringsdetaljer, som:

  • För mål som använder grundläggande autentisering måste användare ange ett användarnamn och lösenord direkt på Experience Platform användargränssnittets autentiseringssida.
  • För mål som använder innehavarautentisering måste användarna ange en innehavartoken.
  • För mål som använder OAuth2-auktorisering omdirigeras användare till målets inloggningssida där de kan logga in med sina autentiseringsuppgifter.
  • För Amazon S3-mål måste användare ange sin Amazon S3-åtkomstnyckel och hemlig nyckel.
  • För Azure Blob-mål måste användarna ange sin Azure Blob-anslutningssträng.

Du kan konfigurera kundautentiseringsinformation via slutpunkten /authoring/destinations. På följande API-referenssidor finns detaljerade API-anropsexempel där du kan konfigurera komponenterna som visas på den här sidan.

I den här artikeln beskrivs alla kompatibla konfigurationer för kundautentisering som du kan använda för ditt mål, och det som kunder ser i användargränssnittet i Experience Platform visas baserat på den autentiseringsmetod som du har ställt in för ditt mål.

IMPORTANT
Konfigurationen för kundautentisering kräver inte att du konfigurerar några parametrar. Du kan kopiera och klistra in kodavsnitten som visas på den här sidan i dina API-anrop när skapar eller uppdaterar en målkonfiguration, och dina användare ser motsvarande autentiseringsskärm i plattformsgränssnittet.
IMPORTANT
Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänsliga. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

Integrationstyper som stöds :headding-anchor:supported-integration-types

Se tabellen nedan för mer ingående information om vilka typer av integreringar som stöder de funktioner som beskrivs på den här sidan.

Integrationstyp
Stöder funktioner
Integrering i realtid (direktuppspelning)
Ja
Filbaserade (batch) integreringar
Ja

Konfiguration av autentiseringsregel :headding-anchor:authentication-rule

När du använder någon av de konfigurationer för kundautentisering som beskrivs på den här sidan ska du alltid ange parametern authenticationRule i målleverans till "CUSTOMER_AUTHENTICATION", vilket visas nedan.

{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Grundläggande autentisering :headding-anchor:basic

Grundläggande autentisering stöds för integreringar i realtid (direktuppspelning) i Experience Platform.

När du konfigurerar den grundläggande autentiseringstypen måste användarna ange ett användarnamn och lösenord för att kunna ansluta till målet.

Gränssnittsåtergivning med grundläggande autentisering

Konfigurera avsnittet customerAuthenticationConfigurations via /destinations-slutpunkten så som visas nedan för att konfigurera grundläggande autentisering för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"BASIC"
   }
]

Bärarautentisering :headding-anchor:bearer

När du konfigurerar typen för innehavarautentisering måste användarna ange den innehavartoken som de får från ditt mål.

Gränssnittet återges med innehavarautentisering

Konfigurera avsnittet customerAuthenticationConfigurations via /destinations-slutpunkten så som visas nedan om du vill konfigurera autentisering av bearer-typ för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"BEARER"
   }
]

OAuth 2-autentisering :headding-anchor:oauth2

Användare väljer Connect to destination för att utlösa OAuth 2-autentiseringsflödet till ditt mål, vilket visas i exemplet nedan för Twitternas anpassade målgrupper. Mer information om hur du konfigurerar OAuth 2-autentisering till målslutpunkten finns på den dedikerade Destination SDK OAuth 2-autentiseringssidan.

Gränssnittsåtergivning med OAuth 2-autentisering

Konfigurera customerAuthenticationConfigurations-avsnittet via /destinations-slutpunkten så som visas nedan för att konfigurera OAuth2-autentisering för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"OAUTH2"
   }
]

Amazon S3-autentisering :headding-anchor:s3

Amazon S3-autentisering stöds för filbaserade mål i Experience Platform.

När du konfigurerar autentiseringstypen Amazon S3 måste användare ange sina S3-inloggningsuppgifter.

Gränssnittsåtergivning med S3-autentisering

Konfigurera customerAuthenticationConfigurations-avsnittet via /destinations-slutpunkten så som visas nedan för att konfigurera Amazon S3-autentisering för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"S3"
   }
]

Azure Blob-autentisering :headding-anchor:blob

Azure Blob Storage-autentisering stöds för filbaserade mål i Experience Platform.

När du konfigurerar autentiseringstypen Azure Blob måste användarna ange anslutningssträngen.

Användargränssnittet återges med blobautentisering

Konfigurera parametern customerAuthenticationConfigurations i slutpunkten /destinations så som visas nedan om du vill konfigurera Azure Blob-autentisering för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_CONNECTION_STRING"
   }
]

Azure Data Lake Storage autentisering :headding-anchor:adls

Azure Data Lake Storage-autentisering stöds för filbaserade mål i Experience Platform.

När du konfigurerar autentiseringstypen Azure Data Lake Storage måste användarna ange autentiseringsuppgifterna för Azure Service Principal och deras klientinformation.

Gränssnittsåtergivning med Azure Data Lake Storage autentisering

Konfigurera parametern customerAuthenticationConfigurations i slutpunkten /destinations så som visas nedan om du vill konfigurera Azure Data Lake Storage-autentisering (ADLS) för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"AZURE_SERVICE_PRINCIPAL"
   }
]

SFTP med lösenordsautentisering

SFTP-autentisering med lösenord stöds för filbaserade mål i Experience Platform.

När du konfigurerar SFTP med lösenordsautentiseringstypen måste användarna ange SFTP-användarnamn och -lösenord samt SFTP-domän och -port (standardport är 22).

Gränssnittet återges med SFTP med lösenordsautentisering

Konfigurera parametern customerAuthenticationConfigurations i slutpunkten /destinations så som visas nedan om du vill konfigurera SFTP-autentisering med lösenord för målet:

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_PASSWORD"
   }
]

SFTP med autentisering med SSH-nyckel

SFTP-autentisering med SSH-nyckel stöds för filbaserade mål i Experience Platform.

När du konfigurerar SFTP med autentiseringstypen SSH-nyckel måste användarna ange SFTP-användarnamnet och SSH-nyckeln samt SFTP-domänen och -porten (standardporten är 22).

Gränssnittet återges med SFTP med autentisering med SSH-nyckel

Om du vill konfigurera SFTP-autentisering med SSH-nyckel för målet konfigurerar du parametern customerAuthenticationConfigurations i slutpunkten /destinations enligt nedan:

"customerAuthenticationConfigurations":[
   {
      "authType":"SFTP_WITH_SSH_KEY"
   }
]

Google Cloud Storage autentisering :headding-anchor:gcs

Google Cloud Storage-autentisering stöds för filbaserade mål i Experience Platform.

När du konfigurerar autentiseringstypen Google Cloud Storage måste användarna ange Google Cloud Storage access key ID och secret access key.

Användargränssnittet återges med autentisering av Google Cloud-lagring

Konfigurera parametern customerAuthenticationConfigurations i slutpunkten /destinations så som visas nedan om du vill konfigurera Google Cloud Storage-autentisering för ditt mål:

"customerAuthenticationConfigurations":[
   {
      "authType":"GOOGLE_CLOUD_STORAGE"
   }
]

Nästa steg :headding-anchor:next-steps

När du har läst den här artikeln bör du få en bättre förståelse för hur du kan konfigurera användarautentisering för målplattformen.

Mer information om de andra målkomponenterna finns i följande artiklar:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6