Guida alle credenziali

Ultimo aggiornamento: 4 aprile 2025

Creato per:

  • Utente
  • Sviluppatore

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.

NOTE
Il pannello Credenziali non è disponibile automaticamente per tutti gli utenti. Contatta il team del tuo account Adobe per richiedere che la scheda Credenziali sia inclusa nell'area di lavoro del servizio query se necessario. Se richiesto, la modifica interessa l’intera organizzazione ed è eseguita dal team di progettazione di Adobe. Non si tratta di un’impostazione controllata dagli utenti.

Credenziali in scadenza

È possibile utilizzare le credenziali in scadenza per impostare rapidamente una connessione a un client esterno.

Scheda Credenziali del dashboard delle query con la sezione Credenziali in scadenza evidenziata.

La sezione Credenziali in scadenza fornisce le seguenti informazioni:

  • Host: nome dell'host a cui connettere il client. Questo incorpora il nome dell’organizzazione come visualizzato nella barra multifunzione superiore dell’interfaccia utente di Experience 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 ( 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 di Admin Console.
TIP
Per modificare la durata della sessione per la connessione delle credenziali in scadenza a Query Service, passa a Admin Console e seleziona le seguenti opzioni sullo schermo: Impostazioni > Privacy e sicurezza > Impostazioni autenticazione > Impostazioni avanzate > Durata massima sessione.
Scheda Impostazioni di Admin Console con Privacy e sicurezza, Impostazioni autenticazione e Durata massima sessione evidenziate.
Per ulteriori informazioni sulle Impostazioni avanzate offerte da Admin Console, consulta la Guida di Adobe.

Connettersi ai dati Customer Journey Analytics nelle sessioni di query

Utilizza l'estensione Customer Journey Analytics BI con Power BI o Tableau per accedere alle visualizzazioni dati di 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 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

IMPORTANT
Per utilizzare questa funzionalità sono necessari un progetto Workspace di Customer Journey Analytics e una visualizzazione dati.

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 Power BI o Tableau.

Scheda Credenziali di Query Service con il menu a discesa del database evidenziato.

NOTE
Quando si collega Power BI o Tableau a Customer Journey Analytics, viene utilizzato il diritto "sessioni simultanee" di Query Service. Se sono necessarie sessioni e query aggiuntive, è possibile acquistare un componente aggiuntivo per il pacchetto di utenti di query ad hoc per ottenere cinque sessioni simultanee aggiuntive e una query concorrente aggiuntiva.

Puoi anche accedere ai dati 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

È possibile utilizzare credenziali senza scadenza per impostare una connessione più permanente a un client esterno.

NOTE
Le credenziali senza scadenza presentano le seguenti limitazioni:
  • 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 query CTAS o ITAS, 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:

  1. Accedi a Adobe Admin Console e seleziona l'organizzazione pertinente dalla barra di navigazione superiore.
  2. Seleziona un profilo di prodotto.
  3. Configura le autorizzazioni Sandbox e Gestione integrazione servizio query per il profilo di prodotto.
  4. Aggiungi un nuovo utente a un profilo di prodotto in modo che possa disporre delle autorizzazioni configurate.
  5. Aggiungi l'utente come amministratore del profilo di prodotto per consentire la creazione di un account per qualsiasi profilo di prodotto attivo.
  6. 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

Per creare un set di credenziali senza scadenza, torna all'interfaccia utente di Experience Platform e seleziona Query dal menu di navigazione a sinistra per accedere all'area di lavoro Query. Quindi, selezionare la scheda Credenziali seguita da Genera credenziali.

Dashboard delle query con la scheda Credenziali e lopzione Genera credenziali evidenziate.

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.

La finestra di dialogo Genera credenziali è evidenziata.

IMPORTANT
Quando è selezionata l'opzione Genera credenziali, nel computer locale viene scaricato un file JSON di configurazione. Poiché Adobe non registra le credenziali generate, è necessario archiviare in modo sicuro il file scaricato e conservare un record delle credenziali.
Inoltre, se le credenziali non vengono utilizzate per 90 giorni, verranno eliminate.

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.

Scheda Credenziali del dashboard delle query con la sezione Credenziali senza scadenza evidenziata.

È possibile modificare o eliminare le credenziali senza scadenza. Per modificare una credenziale senza scadenza, selezionare l'icona della matita ( Unicona della matita. ). Per eliminare una credenziale senza scadenza, selezionare l'icona Elimina ( Icona Cestino. ).

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.

Finestra di dialogo Aggiorna account.

Dopo aver fornito tutti i dettagli richiesti, seleziona Aggiorna account per completare l'aggiornamento delle credenziali.