Konfiguration av kundautentisering

Senaste uppdatering: 2023-11-07
  • Skapat för:
  • Developer
    User
    Admin
    Leader

Experience Platform erbjuder stor flexibilitet i de autentiseringsprotokoll som är tillgängliga för partners och kunder. Du kan konfigurera destinationen så att den stöder någon av de autentiseringsmetoder som är branschstandard, som OAuth2, autentisering av 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.

Mer information om var den här komponenten passar in i en integrering som skapas med Destination SDK finns i diagrammet i konfigurationsalternativ eller se följande sidor med översikt över målkonfigurationen:

Innan kunderna 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 målanslutning självstudie.

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

  • För destinationer som använder grundläggande autentiseringmåste användare ange ett användarnamn och lösenord direkt på inloggningssidan för användargränssnittet i Experience Platform.
  • För destinationer som använder innehavarautentiseringmåste användaren ange en innehavartoken.
  • För destinationer som använder OAuth2-auktorisering, dirigeras användare till målets inloggningssida där de kan logga in med sina inloggningsuppgifter.
  • För Amazon S3 mål, användare måste ange sina Amazon S3 åtkomstnyckel och hemlig nyckel.
  • För Azure Blob mål, användare måste ange sina Azure Blob anslutningssträng.

Du kan konfigurera kundautentiseringsinformation via /authoring/destinations slutpunkt. 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.

VIKTIGT

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 skapa eller uppdatera en målkonfiguration, så ser dina användare motsvarande autentiseringsskärm i plattformsgränssnittet.

VIKTIGT

Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänslig. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

Integrationstyper som stöds

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

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

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

Grundläggande autentisering

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 customerAuthenticationConfigurations via /destinations slutpunkt enligt nedan:

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

Bärarautentisering

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änssnittsåtergivning med innehavarautentisering

Konfigurera customerAuthenticationConfigurations via /destinations slutpunkt enligt nedan:

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

OAuth 2-autentisering

Användarna 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 i den dedikerade Destination SDK OAuth 2-autentiseringssida.

Gränssnittsåtergivning med OAuth 2-autentisering

Så här konfigurerar du OAuth2 autentisering för ditt mål, konfigurera customerAuthenticationConfigurations via /destinations slutpunkt enligt nedan:

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

Amazon S3-autentisering

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

Så här konfigurerar du Amazon S3 autentisering för ditt mål, konfigurera customerAuthenticationConfigurations via /destinations slutpunkt enligt nedan:

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

Azure Blob-autentisering

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.

Gränssnittsåtergivning med blobautentisering

Så här konfigurerar du Azure Blob autentisering för ditt mål, konfigurera customerAuthenticationConfigurations -parametern i /destinations slutpunkt enligt nedan:

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

Azure Data Lake Storage autentisering

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

När du konfigurerar Azure Data Lake Storage autentiseringstyp, användare måste ange autentiseringsuppgifter för Azure Service Principal och klientinformation.

Gränssnittsåtergivning med Azure Data Lake Storage autentisering

Så här konfigurerar du Azure Data Lake Storage (ADLS) autentisering för ditt mål, konfigurera customerAuthenticationConfigurations -parametern i /destinations slutpunkt enligt nedan:

"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).

Användargränssnittet återges med SFTP med lösenordsautentisering

Konfigurera customerAuthenticationConfigurations -parametern i /destinations slutpunkt enligt nedan:

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

SFTP med autentisering med SSH-nyckel

SFTP autentisering med SSH -nyckeln 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änssnittsåtergivning med SFTP med SSH-nyckelautentisering

Konfigurera customerAuthenticationConfigurations -parametern i /destinations slutpunkt enligt nedan:

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

Google Cloud Storage autentisering

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

När du konfigurerar Google Cloud Storage autentiseringstyp, användare måste ange sina Google Cloud Storage access key ID och secret access key.

Gränssnittsåtergivning med Google Cloud Storage-autentisering

Så här konfigurerar du Google Cloud Storage autentisering för ditt mål, konfigurera customerAuthenticationConfigurations -parametern i /destinations slutpunkt enligt nedan:

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

Nästa steg

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:

På denna sida