Guida alle credenziali
Adobe Experience Platform Query Service consente di connettersi con client esterni. È possibile connettersi a questi client esterni utilizzando credenziali in scadenza o credenziali senza scadenza.
Credenziali in scadenza expiring-credentials
È possibile utilizzare le credenziali in scadenza per impostare rapidamente una connessione a un client esterno.
La sezione Credenziali in scadenza fornisce le seguenti informazioni:
- Host: nome dell'host a cui connettere il client. Incorpora il nome dell’organizzazione, come visualizzato nella barra multifunzione superiore dell’interfaccia utente di Platform.
- Porta: numero di porta dell'host a cui connettersi.
- Database: nome del database a cui connettere un client.
- Nome utente: nome utente utilizzato per connettersi a Query Service.
- Password: password utilizzata per la connessione a Query Service. Le password nell’interfaccia utente sono state sottoposte a hashing per motivi di sicurezza. Selezionare l'icona Copia ( ) per copiare le credenziali complete senza hash negli Appunti.
- Comando PSQL: comando che ha inserito automaticamente tutte le informazioni rilevanti per la connessione a Query Service tramite PSQL nella riga di comando.
- Scadenza: data e ora di scadenza delle credenziali. La durata di validità predefinita del token è di 24 ore, ma può essere modificata nelle impostazioni avanzate dell’Admin Console.
Connettersi ai dati di Customer Journey Analytics nelle sessioni di query connect-to-customer-journey-analytics
Utilizza l'estensione Customer Journey Analytics BI con Power BI o Tableau per accedere alle visualizzazioni dati del tuo Customer Journey Analytics con SQL. Integrando Query Service con l’estensione BI, puoi accedere alle visualizzazioni dati direttamente all’interno delle sessioni di Query Service. Questa integrazione semplifica le funzionalità degli strumenti BI che utilizzano Query Service come interfaccia PostgreSQL. Questa funzionalità elimina la necessità di duplicare le visualizzazioni dati negli strumenti di business intelligence, garantisce la coerenza dei rapporti tra le piattaforme e semplifica l'integrazione dei dati di Customer Journey Analytics con altre origini nelle piattaforme di business intelligence.
Consulta la documentazione per scoprire come connettere Query Service a diverse applicazioni client desktop, ad esempio Power BI o Tableau
Per accedere ai dati di Customer Journey Analytics in Power BI o Tableau, selezionare il menu a discesa Database, quindi selezionare prod:cja
tra le opzioni disponibili. Copiare quindi i parametri delle credenziali Postgres (Host, Porta, Database, Nome utente e altri) da utilizzare nella configurazione di Power BI o Tableau.
Puoi anche accedere ai dati del Customer Journey Analytics direttamente da Query Editor o Postgres CLI. A tale scopo, fare riferimento al database cja
durante la scrittura della query. Per ulteriori informazioni su come scrivere, eseguire e salvare le query, vedere la guida all'authoring delle query di Query Editor.
Per istruzioni complete sull'accesso alle visualizzazioni dati di Customer Journey Analytics con SQL, consulta la BI extension guide.
Credenziali senza scadenza non-expiring-credentials
È possibile utilizzare credenziali senza scadenza per impostare una connessione più permanente a un client esterno.
- Gli utenti devono effettuare l'accesso con il proprio nome utente e password nel formato
{technicalAccountId}:{credential}
. Ulteriori informazioni sono disponibili nella sezione Genera credenziali. - Per impostazione predefinita, alle credenziali senza scadenza vengono concesse le autorizzazioni per eseguire solo
SELECT
query. Per eseguire le queryCTAS
oITAS
, aggiungere manualmente le autorizzazioni "Gestisci set di dati" e "Gestisci schemi" al ruolo associato alle credenziali senza scadenza. L'autorizzazione "Gestisci schemi" si trova nella sezione "Modellazione dati" e l'autorizzazione "Gestisci set di dati" nella sezione "Gestione dati" di Adobe Developer Console. - I client di terze parti possono ottenere prestazioni diverse da quelle previste quando si elencano oggetti di query. Ad esempio, alcuni client di terze parti come DB Visualizer non visualizzeranno il nome della visualizzazione nel pannello sinistro. Tuttavia, il nome della visualizzazione è accessibile se chiamato all'interno di una query
SELECT
. Analogamente, PowerUI potrebbe non elencare le viste temporanee create tramite SQL per la selezione nella creazione del dashboard.
Prerequisiti
Prima di poter generare credenziali senza scadenza, è necessario completare i seguenti passaggi in Adobe Admin Console:
- Accedi a Adobe Admin Console e seleziona l'organizzazione pertinente dalla barra di navigazione superiore.
- Seleziona un profilo di prodotto.
- Configura le autorizzazioni Sandbox e Gestione integrazione servizio query per il profilo di prodotto.
- Aggiungi un nuovo utente a un profilo di prodotto in modo che possa disporre delle autorizzazioni configurate.
- Aggiungi l'utente come amministratore del profilo di prodotto per consentire la creazione di un account per qualsiasi profilo di prodotto attivo.
- Aggiungi l'utente come sviluppatore del profilo di prodotto per creare un'integrazione.
Per ulteriori informazioni su come assegnare le autorizzazioni, leggere la documentazione sul controllo di accesso.
In Adobe Developer Console sono ora configurate tutte le autorizzazioni necessarie affinché l’utente possa utilizzare la funzione delle credenziali in scadenza.
Genera credenziali generate-credentials
Per creare un set di credenziali senza scadenza, torna all'interfaccia utente di Platform e seleziona Query dalla navigazione a sinistra per accedere all'area di lavoro Query. Quindi, selezionare la scheda Credenziali seguita da Genera credenziali.
Viene visualizzata una finestra di dialogo che consente di generare le credenziali. Per creare credenziali senza scadenza, è necessario fornire i dettagli seguenti:
- Nome: nome delle credenziali che si stanno generando.
- Descrizione: (facoltativo) una descrizione per le credenziali che si stanno generando.
- Assegnato a: l'utente a cui verranno assegnate le credenziali. Questo valore deve essere l’indirizzo e-mail dell’utente che sta creando le credenziali.
- Password (Facoltativo) Password facoltativa per le credenziali. Se la password non è impostata, Adobe genererà automaticamente una password.
Dopo aver fornito tutti i dettagli richiesti, selezionare Genera credenziali per generare le credenziali.
Il file JSON di configurazione contiene informazioni come il nome dell’account tecnico, l’ID dell’account tecnico e le credenziali. Viene fornito nel seguente formato.
{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}
Dopo aver salvato le credenziali generate, seleziona Chiudi. È ora disponibile un elenco di tutte le credenziali senza scadenza.
È possibile modificare o eliminare le credenziali senza scadenza. Per modificare una credenziale senza scadenza, selezionare l'icona della matita ( ). Per eliminare una credenziale senza scadenza, selezionare l'icona Elimina ( ).
Quando si modifica una credenziale senza scadenza, viene visualizzata una finestra modale. Puoi fornire i seguenti dettagli da aggiornare:
- Nome: nome delle credenziali che si stanno generando.
- Descrizione: (facoltativo) una descrizione per le credenziali che si stanno generando.
- Assegnato a: l'utente a cui verranno assegnate le credenziali. Questo valore deve essere l’indirizzo e-mail dell’utente che sta creando le credenziali.
Dopo aver fornito tutti i dettagli richiesti, seleziona Aggiorna account per completare l'aggiornamento delle credenziali.
Utilizzare le credenziali per connettersi ai client esterni use-credential-to-connect
Puoi utilizzare le credenziali in scadenza o non in scadenza per connetterti con client esterni, ad esempio Aqua Data Studio, Looker o Power BI. Il metodo di input per queste credenziali varia a seconda del client esterno. Per istruzioni specifiche sull’utilizzo di queste credenziali, consulta la documentazione del client esterno.
L’immagine indica la posizione di ciascun parametro trovato nell’interfaccia utente, ad eccezione della password delle credenziali senza scadenza. Anche se le credenziali senza scadenza vengono fornite dai relativi file di configurazione JSON, puoi visualizzare le credenziali in scadenza nella scheda Credenziali nell'interfaccia utente.
La tabella seguente illustra i parametri normalmente necessari per la connessione ai client esterni.
Il formato per l'immissione del nome utente e della password utilizza valori separati da due punti come mostrato in questo esempio
username:{your_username}
e password:{password_string}
.Il nome del server/host a cui ti stai connettendo.
- Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e assume la forma di
server.adobe.io
. Il valore si trova in Host nella sezione EXPIRING CREDENTIALS.
acme.platform.adobe.io
Porta del server/host a cui ci si sta connettendo.
- Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e si trova in Porta nella sezione CREDENZIALI IN SCADENZA.
80
Il database a cui ci si connette.
- Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza e si trova in Database nella sezione EXPIRING CREDENTIALS.
prod:all
Nome utente dell'utente che si connette al client esterno.
- Questo valore viene utilizzato sia per le credenziali in scadenza che per quelle senza scadenza. Deve essere una stringa alfanumerica prima di
@AdobeOrg
. Questo valore si trova in Nome utente.
ECBB80245ECFC73E8A095EC9@AdobeOrg
Password dell'utente che si connette al client esterno.
- Se utilizzi credenziali in scadenza, puoi trovarle nella sezione Password all'interno della sezione EXPIRING CREDENTIALS.
- Se utilizzi credenziali senza scadenza, questo valore corrisponde agli argomenti concatenati di technicalAccountID e alle credenziali prese dal file JSON di configurazione. Il valore della password assume la forma:
{technicalAccountId}:{credential}
.
- Una password delle credenziali in scadenza supera un migliaio di caratteri alfanumerici. Non verrà fornito alcun esempio.
- La password delle credenziali senza scadenza è la seguente:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee
Passaggi successivi
Ora che hai compreso il funzionamento sia delle credenziali in scadenza che di quelle non in scadenza, puoi utilizzare queste credenziali per connettersi ai client esterni. Per ulteriori informazioni dettagliate sui client esterni, leggere la guida alla connessione dei client a Query Service.