Dokumentation Experience Platform Användarhandbok om Query Service

Handbok för autentiseringsuppgifter

Last update: Tue Aug 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Frågor

Skapat för:

Användare
Utvecklare

Med Adobe Experience Platform Query Service kan du ansluta till externa klienter. Du kan ansluta till dessa externa klienter genom att använda antingen utgångsdatum eller ej utgångsdatum.

NOTE

Autentiseringspanelen är inte automatiskt tillgänglig för alla användare. Kontakta ditt Adobe-kontoteam för att begära att fliken Credentials ska ingå i arbetsytan för frågetjänsten om du behöver det. Om så krävs är denna förändring i hela organisationen och genomförs av Adobe ingenjörsteam. Det är inte en inställning som styrs av användare.

Utgående autentiseringsuppgifter expiring-credentials

Du kan använda utgångsuppgifter för att snabbt konfigurera en anslutning till en extern klient.

Fliken Autentiseringsuppgifter för kontrollpanelen Frågor med avsnittet Utgående autentiseringsuppgifter markerat.

Avsnittet Expiring credentials innehåller följande information:

Host: Namnet på värddatorn som klienten ska anslutas till. Det innehåller namnet på din organisation så som det visas på den översta menyfliken i användargränssnittet för plattformen.
Port: Portnumret för den värd som ska anslutas.
Database: Namnet på databasen som en klient ska anslutas till.
Username: Användarnamnet som används för att ansluta till frågetjänsten.
Password: Lösenordet som används för att ansluta till frågetjänsten. Lösenord i användargränssnittet har hashats av säkerhetsskäl. Välj kopieringsikonen ( ) om du vill kopiera dina fullständiga, ohashade autentiseringsuppgifter till Urklipp.
PSQL command: Ett kommando som automatiskt har infogat all relevant information så att du kan ansluta till frågetjänsten med PSQL på kommandoraden.
Expires: Utgångsdatum och förfallotid för autentiseringsuppgifterna. Standardlängden för token är 24 timmar, men den kan ändras i de avancerade inställningarna för Admin Console.

TIP

Om du vill ändra sessionstiden för din utgående inloggningsanslutning till frågetjänsten går du till Admin Console och väljer följande på skärmen: Inställningar > Sekretess och säkerhet > Autentiseringsinställningar > Avancerade inställningar > Maximal sessionstid.

Inställningsfliken för Admin Console med sekretess och säkerhet, autentiseringsinställningar och maximal sessionstid markerade.

Mer information om de avancerade inställningarna som Admin Console erbjuder finns i hjälpdokumentationen för Adobe.

Ansluta data från Customer Journey Analytics i frågesessioner connect-to-customer-journey-analytics

Använd Customer Journey Analytics BI-tillägget med Power BI eller Tableau för att komma åt datavyer från Customer Journey Analytics med SQL. Genom att integrera frågetjänsten med BI-tillägget kan du komma åt dina datavyer direkt i sessioner med frågetjänsten. Den här integreringen effektiviserar funktionaliteten för BI-verktyg som använder Query Service som PostgreSQL-gränssnitt. Den här funktionen eliminerar behovet av att duplicera datavyer i BI-verktyg, säkerställer enhetlig rapportering på olika plattformar och förenklar integrering av Customer Journey Analytics-data med andra källor i BI-plattformar.

Läs dokumentationen för att lära dig hur du ansluter frågetjänsten till ett antal klientprogram för stationära datorer, till exempel Power BI eller Tableau

IMPORTANT

Ett Customer Journey Analytics-arbetsyteprojekt och en datavy krävs för att den här funktionen ska kunna användas.

Om du vill få åtkomst till dina Customer Journey Analytics-data i Power BI eller Tableau väljer du listrutan Database och sedan prod:cja bland de tillgängliga alternativen. Kopiera sedan dina Postgres-autentiseringsparametrar (Värd, Port, Databas, Användarnamn med flera) för användning i din Power BI- eller Tableau-konfiguration.

Fliken med autentiseringsuppgifter för frågetjänsten med listrutan för databas markerad.

NOTE

När du ansluter Power BI eller Tableau till Customer Journey Analytics förbrukas behörigheten för frågetjänsten 'concurrent sessions'. Om ytterligare sessioner och frågor krävs kan ytterligare ett tillägg för ad hoc-frågeanvändarpaket köpas för att erhålla ytterligare fem samtidiga sessioner och ytterligare en samtidiga fråga.

Du kan även komma åt dina Customer Journey Analytics-data direkt från Frågeredigeraren eller Postgres CLI. Om du vill göra det refererar du till databasen cja när du skriver din fråga. Mer information om hur du skriver, kör och sparar frågor finns i frågeredigeraren frågeredigeringsguiden.

I BI-tilläggsguiden finns fullständiga anvisningar om hur du får åtkomst till datavyer i Customer Journey Analytics med SQL.

Ej förfallande autentiseringsuppgifter non-expiring-credentials

Du kan använda autentiseringsuppgifter som inte upphör att gälla för att konfigurera en mer permanent anslutning till en extern klient.

NOTE

Giltiga autentiseringsuppgifter har följande begränsningar:

Användare måste logga in med sitt användarnamn och lösenord i formatet {technicalAccountId}:{credential}. Mer information finns i avsnittet Generera autentiseringsuppgifter.
Som standard ges autentiseringsuppgifter som inte förfaller behörighet att endast köra SELECT-frågor. Om du vill köra CTAS- eller ITAS-frågor lägger du manuellt till behörigheterna Hantera datauppsättning och Hantera scheman i rollen som är kopplad till de autentiseringsuppgifter som inte förfaller. Behörigheten Hantera scheman finns under avsnittet Datamodellering och behörigheten Hantera datauppsättningar finns under avsnittet Datahantering i [Adobe Developer Console] (https://developer.adobe.com/console/).
Tredjepartsklienter kan fungera annorlunda än väntat när frågeobjekt listas. Vissa tredjepartsklienter, till exempel DB Visualizer, visar inte vynamnet på den vänstra panelen. Visningsnamnet är dock tillgängligt om det anropas i en SELECT-fråga. På samma sätt kanske PowerUI inte listar de tillfälliga vyer som har skapats via SQL för val när kontrollpaneler skapas.

Förhandskrav

Innan du kan generera autentiseringsuppgifter som inte förfaller måste du utföra följande steg i Adobe Admin Console:

Logga in på Adobe Admin Console och välj relevant organisation i det övre navigeringsfältet.
Välj en produktprofil.
Konfigurera både sandlådor och Hantera frågetjänstintegrationför produktprofilen.
Lägg till en ny användare i en produktprofil så att de får sina konfigurerade behörigheter.
Lägg till användaren som produktprofiladministratör om du vill tillåta att ett konto skapas för en aktiv produktprofil.
Lägg till användaren som produktprofilutvecklare för att skapa en integrering.

Läs dokumentationen om åtkomstkontroll om du vill veta mer om hur du tilldelar behörigheter.

Alla nödvändiga behörigheter har nu konfigurerats i Adobe Developer Console så att användaren kan använda funktionen för förfalloinloggningsuppgifter.

Generera autentiseringsuppgifter generate-credentials

Om du vill skapa en uppsättning autentiseringsuppgifter som inte upphör att gälla går du tillbaka till användargränssnittet för plattformen och väljer Queries i den vänstra navigeringen för att komma åt arbetsytan i Queries. Välj sedan fliken Credentials följt av Generate credentials.

Kontrollpanelen Frågor med fliken Autentiseringsuppgifter och Generera autentiseringsuppgifter markerade.

En dialogruta visas där du kan generera autentiseringsuppgifter. Om du vill skapa inloggningsuppgifter som inte förfaller måste du ange följande information:

Name: Namnet på de autentiseringsuppgifter som du genererar.
Description: (Valfritt) En beskrivning av de autentiseringsuppgifter som du genererar.
Assigned to: Den användare som autentiseringsuppgifterna ska tilldelas till. Värdet ska vara e-postadressen till den användare som skapar inloggningsuppgifterna.
Password (Valfritt) Ett valfritt lösenord för dina autentiseringsuppgifter. Om lösenordet inte är inställt genererar Adobe automatiskt ett lösenord åt dig.

När du har angett all nödvändig information väljer du Generate credentials för att generera dina autentiseringsuppgifter.

Dialogrutan Generera autentiseringsuppgifter är markerad.

IMPORTANT

När Generate credentials har valts hämtas en konfigurations-JSON-fil till den lokala datorn. Eftersom Adobe inte spelar in de genererade inloggningsuppgifterna måste du lagra den hämtade filen på ett säkert sätt och spara inloggningsuppgifterna.

Om inloggningsuppgifterna inte används på 90 dagar kommer de dessutom att tas bort.

JSON-konfigurationsfilen innehåller information som namn på tekniskt konto, ID för tekniskt konto och autentiseringsuppgifter. Den tillhandahålls i följande format.

{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}

När du har sparat dina genererade autentiseringsuppgifter väljer du Close. Nu kan du se en lista över alla dina ej förfallna autentiseringsuppgifter.

Fliken Autentiseringsuppgifter för kontrollpanelen Frågor med avsnittet Ej förfallande autentiseringsuppgifter markerat.

Du kan antingen redigera eller ta bort dina uppgifter som inte förfaller. Om du vill redigera en referens som inte upphör att gälla väljer du pennikonen ( ). Om du vill ta bort en autentiseringsuppgift som inte upphör att gälla väljer du borttagningsikonen ( ).

När du redigerar en referens som inte upphör att gälla visas ett modalt värde. Du kan uppdatera följande information:

Name: Namnet på de autentiseringsuppgifter som du genererar.
Description: (Valfritt) En beskrivning av de autentiseringsuppgifter som du genererar.
Assigned to: Den användare som autentiseringsuppgifterna ska tilldelas till. Värdet ska vara e-postadressen till den användare som skapar inloggningsuppgifterna.

Dialogrutan Uppdatera konto.

När du har angett all nödvändig information väljer du Update account för att slutföra uppdateringen av dina autentiseringsuppgifter.

Använd autentiseringsuppgifter för att ansluta till externa klienter use-credential-to-connect

Du kan använda autentiseringsuppgifterna som förfaller eller inte förfaller för att ansluta till externa klienter, som Aqua Data Studio, Looker eller Power BI. Indatametoden för dessa autentiseringsuppgifter varierar beroende på den externa klienten. Mer information om hur du använder dessa autentiseringsuppgifter finns i den externa klientens dokumentation.

Bilden anger platsen för varje parameter som hittas i användargränssnittet, med undantag för lösenordet för de autentiseringsuppgifter som inte förfaller. Även om autentiseringsuppgifter som inte förfaller anges av deras JSON-konfigurationsfiler, kan du visa dina förfallande autentiseringsuppgifter på fliken Autentiseringsuppgifter i användargränssnittet.

Fliken Autentiseringsuppgifter för arbetsytan Frågor med avsnittet Förfallande autentiseringsuppgifter markerat.

Tabellen nedan visar de parametrar som vanligtvis krävs för att ansluta till externa klienter.

NOTE

När du ansluter till en värd med autentiseringsuppgifter som inte upphör att gälla, är det fortfarande nödvändigt att använda alla parametrar som anges i avsnittet EXPIRING CREDENTIALS förutom lösenordet och användarnamnet.
Formatet för att ange ditt användarnamn och lösenord använder kolonavgränsade värden som visas i det här exemplet username:{your_username} och password:{password_string}.

Parameter

Beskrivning

Exempel

Server/värd

Namnet på den server/värd som du ansluter till.

Det här värdet används både för utgångsdatum och icke-utgångsdatum och har formen server.adobe.io. Värdet finns under Host i avsnittet EXPIRING CREDENTIALS.

acme.platform.adobe.io

Port

Porten för den server/värd som du ansluter till.

Det här värdet används både för förfallodatum och icke-förfallande autentiseringsuppgifter och finns under Port i avsnittet EXPIRING CREDENTIALS.

80

Databas

Databasen som du ansluter till.

Det här värdet används både för förfallodatum och icke-förfallande autentiseringsuppgifter och finns under Database i avsnittet EXPIRING CREDENTIALS.

prod:all

Användarnamn

Användarnamnet för användaren som ansluter till den externa klienten.

Det här värdet används både för utgångsdatum och icke-utgångsdatum. Det har formen av en alfanumerisk sträng före @AdobeOrg. Det här värdet finns under Username.

ECBB80245ECFC73E8A095EC9@AdobeOrg

Lösenord

Lösenordet för den användare som ansluter till den externa klienten.

Om du använder förfalloinloggningsuppgifter finns dessa under Password i avsnittet EXPIRING CREDENTIALS.
Om du använder inloggningsuppgifter som inte upphör att gälla är det här värdet de sammanfogade argumenten från technicalAccountID och inloggningsuppgifterna från JSON-konfigurationsfilen. Lösenordsvärdet har formatet: {technicalAccountId}:{credential}.

Ett lösenord för att ange förfallodatum är längre än tusen alfanumeriska tecken. Inget exempel kommer att ges.
Ett lösenord för autentiseringsuppgifter som inte förfaller är följande:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee

Nästa steg

Nu när du förstår hur både förfallodatum och icke-utgångsdatum fungerar kan du använda dessa autentiseringsuppgifter för att ansluta till externa klienter. Mer information om externa klienter finns i guiden Ansluta klienter till frågetjänsten.

recommendation-more-help

ccf2b369-4031-483f-af63-a93b5ae5e3fb