Configurazione dei segreti nell’inoltro degli eventi

In caso di inoltro, un segreto è una risorsa che rappresenta una credenziale di autenticazione per un altro sistema, che consente lo scambio sicuro di dati. I segreti possono essere creati solo all'interno delle proprietà di inoltro degli eventi.

Al momento sono disponibili tre tipi di segreto supportati:

Questa guida fornisce una panoramica di alto livello su come configurare i segreti per un inoltro di eventi (Bordo) nell'interfaccia utente Raccolta dati.

Prerequisiti

Questa guida presuppone che tu abbia già familiarità con le modalità di gestione delle risorse per i tag e l’inoltro degli eventi nell’interfaccia utente della raccolta dati, inclusa la modalità di creazione di un elemento dati e di una regola di inoltro degli eventi. Consulta la guida su gestione delle risorse se hai bisogno di un’introduzione.

È inoltre necessario avere una conoscenza approfondita del flusso di pubblicazione per tag e inoltro eventi, tra cui come aggiungere risorse a una libreria e installare una build sul sito web per il test. Consulta la sezione panoramica sulla pubblicazione per ulteriori dettagli.

Creare un segreto

Per creare un segreto, accedi all’interfaccia utente di raccolta dati e apri la proprietà di inoltro eventi in cui desideri aggiungere il segreto. Quindi, seleziona Segreti nella navigazione a sinistra, seguita da Crea nuovo segreto.

La schermata successiva ti consente di configurare i dettagli del segreto. Affinché un segreto possa essere utilizzato dall'inoltro eventi, deve essere assegnato a un ambiente esistente. Se non sono stati creati ambienti per la proprietà di inoltro eventi, consulta la guida in ambienti per informazioni su come configurarli prima di continuare.

Sotto Ambiente di destinazione, utilizza il menu a discesa per selezionare l’ambiente a cui assegnare il segreto. Sotto Nome segreto, specifica un nome per il segreto nel contesto dell'ambiente. Questo nome deve essere univoco in tutti i segreti della proprietà di inoltro dell'evento.

Un segreto può essere assegnato a un solo ambiente alla volta, ma se lo desideri puoi assegnare le stesse credenziali a più segreti in ambienti diversi. Seleziona Aggiungi ambiente per aggiungere un’altra riga all’elenco.

Per ogni ambiente aggiunto, devi fornire un altro nome univoco per il segreto associato. Se scarichi tutti gli ambienti disponibili, la Aggiungi ambiente il pulsante non sarà disponibile.

Da qui, i passaggi per creare il segreto variano a seconda del tipo di segreto che stai creando. Per ulteriori informazioni, consulta le sottosezioni seguenti:

• Token
• HTTP
• OAuth2

Token

Per creare un segreto token, seleziona Token dal Tipo a discesa. In Token specificare la stringa di credenziale riconosciuta dal sistema a cui si sta eseguendo l'autenticazione. Seleziona Crea segreto per salvare il segreto.

HTTP

Per creare un segreto HTTP, seleziona HTTP semplice dal Tipo a discesa. Nei campi visualizzati di seguito, fornisci un nome utente e una password per la credenziale prima di selezionare Crea segreto per salvare il segreto.

OAuth2

Per creare un segreto OAuth2, seleziona OAuth2 dal Tipo a discesa. Nei campi visualizzati di seguito, fornisci ID client e Segreto client, nonché URL autorizzazione per l’integrazione con OAuth. La URL autorizzazione Nell’interfaccia utente Raccolta dati è presente una concatenazione tra l’host del server di autorizzazione e il percorso del token.

Sotto Opzioni credenziali, è possibile fornire altre opzioni di credenziale, ad esempio scope e audience sotto forma di coppie chiave-valore. Per aggiungere altre coppie chiave-valore, seleziona Aggiungi un altro.

Infine, puoi configurare il Aggiorna offset valore del segreto. Rappresenta il numero di secondi prima della scadenza del token per cui il sistema eseguirà un aggiornamento automatico. L’ora equivalente in ore e minuti viene visualizzata a destra del campo e si aggiorna automaticamente durante la digitazione.

Ad esempio, se l'offset di aggiornamento è impostato sul valore predefinito di 14400 (quattro ore) e il token di accesso ha un expires_in valore 86400 (24 ore), il sistema aggiornerà automaticamente il segreto in 20 ore.

Al termine, seleziona Crea segreto per salvare il segreto.

Modificare un segreto

Dopo aver creato segreti per una proprietà, puoi trovarli elencati nella sezione Segreti workspace. Per modificare i dettagli di un segreto esistente, selezionane il nome dall’elenco.

La schermata successiva ti consente di modificare il nome e le credenziali del segreto.

Ritentare uno scambio segreto

È possibile riprovare o aggiornare uno scambio segreto dalla schermata di modifica. Questo processo varia a seconda del tipo di segreto in corso di modifica:

Elimina un segreto

Per eliminare un segreto esistente nel Segreti area di lavoro, seleziona la casella di controllo accanto al nome prima di selezionare Elimina.

Utilizzo dei segreti nell’inoltro degli eventi

Per utilizzare un segreto nell'inoltro degli eventi, devi prima creare un elemento dati che fa riferimento al segreto stesso. Dopo aver salvato l'elemento dati, puoi includerlo nell'inoltro degli eventi regole e aggiungi tali regole a un libreria, che a sua volta può essere distribuito ai server di Adobe come build.

Quando crei l’elemento dati, seleziona la Core estensione , quindi seleziona Segreto per il tipo di elemento dati. Il pannello a destra aggiorna e fornisce controlli a discesa per assegnare fino a tre segreti all’elemento dati: uno per Sviluppo, Staginge Produzione rispettivamente.

Assegnando più segreti a un singolo elemento dati e includendolo in una regola, puoi modificare il valore dell'elemento dati a seconda di dove si trova la libreria contenitore nel flusso di pubblicazione.

Passaggi successivi

Questa guida illustra come gestire i segreti nell’interfaccia utente di raccolta dati. Per informazioni su come interagire con i segreti utilizzando l’API di Reactor, consulta la guida all’endpoint segreti.