1.1.2 Ottimizzare il processo Firefly utilizzando Microsoft Azure e gli URL prefirmati

Scopri come ottimizzare il processo di Firefly utilizzando Microsoft Azure e gli URL prefirmati.

1.1.2.1 Cosa sono gli URL prefirmati?

Un URL preceduto è un URL che consente l'accesso temporaneo a un oggetto specifico in un percorso di archiviazione. Utilizzando l’URL, un utente può ad esempio LEGGERE l’oggetto o SCRIVERE un oggetto (o aggiornare un oggetto esistente). L’URL contiene parametri specifici impostati dall’applicazione.

Nel contesto della creazione dell'automazione della supply chain dei contenuti, spesso è necessario eseguire più operazioni sui file per un caso d'uso specifico. Ad esempio, potrebbe essere necessario modificare lo sfondo di un file, il testo di vari livelli, ecc. Non è sempre possibile eseguire tutte le operazioni sui file contemporaneamente, il che rende necessario un approccio in più passaggi. Dopo ogni passaggio intermedio, l’output è quindi un file temporaneo necessario per l’esecuzione del passaggio successivo. Una volta eseguito il passaggio successivo, il file temporaneo perde rapidamente valore e spesso non è più necessario, pertanto deve essere eliminato.

Adobe Firefly Services attualmente supporta i seguenti domini:

Il motivo per cui spesso vengono utilizzate soluzioni di archiviazione cloud è che le risorse intermedie che vengono create perdono valore rapidamente. Il problema che viene risolto tramite URL prefirmati è spesso risolto al meglio con una soluzione di storage di base, che in genere è uno dei servizi cloud sopra indicati.

All’interno dell’ecosistema Adobe sono inoltre disponibili soluzioni di storage come Frame.io, Workfront Fusion e Adobe Experience Manager assets. Queste soluzioni supportano anche URL prefirmati, che spesso diventano una scelta da effettuare durante l’implementazione. La scelta è spesso basata su una combinazione di applicazioni già disponibili e costi di storage.

Di conseguenza, gli URL prefirmati vengono utilizzati in combinazione con le operazioni di Adobe Firefly Services per i seguenti motivi:

Un URL prefirmato utilizza tre parametri per limitare l’accesso all’utente:

Esempio:

1.1.2.2 Crea una sottoscrizione Azure

Vai a https://portal.azure.com e accedi con il tuo account di Azure. Se non ne hai uno, utilizza il tuo indirizzo e-mail personale per creare il tuo account di Azure.

{modal="regular"}

Dopo aver effettuato l’accesso, viene visualizzata la seguente schermata:

{modal="regular"}

Nel menu a sinistra, seleziona Tutte le risorse. Se non hai ancora effettuato l'abbonamento, viene visualizzata la schermata dell'abbonamento di Azure.

Se non sei abbonato, seleziona Inizia con una versione di valutazione gratuita di Azure.

{modal="regular"}

Compila il modulo di abbonamento Azure e fornisci il telefono cellulare e la carta di credito per l’attivazione (avrai un livello gratuito per 30 giorni e non ti verrà addebitato alcun importo, a meno che non esegui l’aggiornamento).

Al termine del processo di abbonamento, sei a posto.

{modal="regular"}

1.1.2.3 Crea account di archiviazione Azure

Cercare storage account e selezionare Account di archiviazione.

{modal="regular"}

Selezionare + Crea.

{modal="regular"}

Seleziona la sottoscrizione e seleziona (o crea) un gruppo di risorse.

In Nome account di archiviazione utilizzare --aepUserLdap--.

Seleziona Rivedi + crea.

{modal="regular"}

Seleziona Crea.

{modal="regular"}

Dopo la conferma, seleziona Vai alla risorsa.

{modal="regular"}

L’account di archiviazione Azure è ora pronto per essere utilizzato.

{modal="regular"}

Selezionare Archiviazione dati, quindi passare a Contenitori. Selezionare + Contenitore.

{modal="regular"}

Utilizza --aepUserLdap-- per il nome e seleziona Crea.

{modal="regular"}

Il contenitore è ora pronto per essere utilizzato.

{modal="regular"}

1.1.2.4 Installare Azure Storage Explorer

Scarica Microsoft Azure Storage Explorer per gestire i file. Selezionare la versione corretta per il sistema operativo specifico, scaricarla e installarla.

{modal="regular"}

Apri l'applicazione e seleziona Accedi con Azure.

{modal="regular"}

Selezionare Sottoscrizione.

{modal="regular"}

Selezionare Azure e quindi Next.

{modal="regular"}

Selezionare l'account di Microsoft Azure e completare il processo di autenticazione.

{modal="regular"}

Dopo l’autenticazione, viene visualizzato questo messaggio.

{modal="regular"}

Nell'app Microsoft Azure Storage Explorer, selezionare la sottoscrizione e scegliere Apri Explorer.

{modal="regular"}

L'account di archiviazione viene visualizzato in Account di archiviazione.

{modal="regular"}

Apri Contenitori BLOB e seleziona il contenitore creato nell'esercizio precedente.

{modal="regular"}

1.1.2.5 Caricamento manuale del file e utilizzo di un file immagine come riferimento di stile

Carica un file di immagine di tua scelta o questo file nel contenitore.

Una volta caricato, puoi visualizzarlo nel contenitore:

{modal="regular"}

Fare clic con il pulsante destro del mouse su gradient.jpg, quindi selezionare Ottieni firma di accesso condiviso.

{modal="regular"}

In Autorizzazioni, è richiesto solo Lettura. Seleziona Crea.

{modal="regular"}

Copia l’URL prefirmato del file di immagine per la successiva richiesta API in Firefly.

{modal="regular"}

In Postman apri la richiesta POST - Firefly - T2I (styleref) V3.
Viene visualizzato in Corpo.

{modal="regular"}

Sostituisci l'URL segnaposto con l'URL preceduto per il file di immagine e seleziona Invia.

{modal="regular"}

Apri la nuova immagine del Firefly Services di risposta nel browser.

{modal="regular"}

Un'altra immagine viene visualizzata con horses in a field, ma questa volta lo stile è simile al file di immagine fornito come riferimento di stile.

{modal="regular"}

Caricamento file programmatico 1.1.2.6

Per utilizzare il caricamento di file a livello di programmazione con gli account di archiviazione di Azure, è necessario creare un nuovo token firma di accesso condiviso (SAS) con autorizzazioni che consentono di scrivere un file.

In Azure Storage Explorer, fare clic con il pulsante destro del mouse sul contenitore e selezionare Ottieni firma di accesso condiviso.

{modal="regular"}

In Autorizzazioni, seleziona le seguenti autorizzazioni richieste:

Seleziona Crea.

{modal="regular"}

Dopo aver ricevuto la firma di accesso condiviso, seleziona Copia per copiare l'URL.

{modal="regular"}

Utilizza l'URL del token SAS per caricare un file nell'account di archiviazione di Azure.

In Postman, seleziona la cartella FF - Firefly Services Tech Insiders, quindi … nella cartella Firefly, quindi seleziona Aggiungi richiesta.

{modal="regular"}

Modifica il nome della richiesta vuota in Carica file nell'account di archiviazione Azure, cambia il Tipo di richiesta in PUT e incolla l'URL del token SAS nella sezione URL, quindi seleziona Corpo.

{modal="regular"}

Quindi, seleziona un file dal computer locale o usa un altro file di immagine che si trova qui.

In Body, selezionare binary, Seleziona file, quindi selezionare + Nuovo file dal computer locale.

{modal="regular"}

Selezionare il file desiderato e selezionare Apri.

{modal="regular"}

Specificare quindi il nome del file da utilizzare nell'account di archiviazione Azure posizionando il cursore davanti al punto interrogativo ? nell'URL come segue:

{modal="regular"}

L’URL ha attualmente questo aspetto, ma deve essere modificato.

https://vangeluw.blob.core.windows.net/vangeluw?sv=2023-01-03...

Cambia il nome del file in gradient2-p.jpg e cambia l'URL in modo da includere il nome del file come segue:

https://vangeluw.blob.core.windows.net/vangeluw/gradient2-p.jpg?sv=2023-01-03...

{modal="regular"}

Quindi, vai a Intestazioni per aggiungere manualmente una nuova intestazione come questa:

{modal="regular"}

Vai a Autorizzazione e imposta il Tipo di autenticazione su Nessuna autenticazione, quindi seleziona Invia.

{modal="regular"}

Successivamente, questa risposta vuota viene visualizzata in Postman, il che significa che il caricamento del file è corretto.

{modal="regular"}

In Azure Storage Explorer aggiorna il contenuto della cartella e viene visualizzato il file appena caricato.

{modal="regular"}

1.1.2.7 utilizzo file programmatico

Per leggere a livello di programmazione i file dagli account di archiviazione di Azure nel lungo termine, è necessario creare un nuovo token firma di accesso condiviso (SAS), con autorizzazioni che consentono di leggere un file. Tecnicamente puoi utilizzare il token SAS creato nell'esercizio precedente, ma è consigliabile disporre di un token separato con solo autorizzazioni Lettura e un token separato con solo autorizzazioni Scrittura.

Token SAS lettura a lungo termine

Torna ad Azure Storage Explorer, fai clic con il pulsante destro del mouse sul contenitore, quindi seleziona Ottieni firma di accesso condiviso.

{modal="regular"}

In Autorizzazioni, seleziona le seguenti autorizzazioni richieste:

Imposta Scadenza su 1 anno a partire da ora.

Seleziona Crea.

{modal="regular"}

Copiare l'URL e scriverlo in un file sul computer per ottenere il token SAS a lungo termine con autorizzazioni di lettura.

{modal="regular"}

L’URL deve essere simile al seguente:

https://vangeluw.blob.core.windows.net/vangeluw?sv=2023-01-03&st=2025-01-13T07%3A36%3A35Z&se=2026-01-14T07%3A36%3A00Z&sr=c&sp=rl&sig=4r%2FcSJLlt%2BSt9HdFdN0VzWURxRK6UqhB8TEvbWkmAag%3D

Puoi derivare un paio di valori dall’URL precedente:

Token SAS scrittura a lungo termine

Torna ad Azure Storage Explorer, fai clic con il pulsante destro del mouse sul contenitore e seleziona Ottieni firma di accesso condiviso.

{modal="regular"}

In Autorizzazioni, seleziona le seguenti autorizzazioni richieste:

Imposta Scadenza su 1 anno a partire da ora.

Seleziona Crea.

{modal="regular"}

Copiare l'URL e scriverlo in un file sul computer per ottenere il token SAS a lungo termine con autorizzazioni di lettura/scrittura.

{modal="regular"}

L’URL deve essere simile al seguente:

https://vangeluw.blob.core.windows.net/vangeluw?sv=2023-01-03&st=2025-01-13T07%3A38%3A59Z&se=2026-01-14T07%3A38%3A00Z&sr=c&sp=acw&sig=lR9%2FMUfyYLcBK7W9Kv7YJdYz5HEEEovExAdOCOCUdMk%3D

Puoi derivare un paio di valori dall’URL precedente:

Variabili in Postman

Come puoi vedere nella sezione precedente, esistono alcune variabili comuni sia nel token di lettura che in quello di scrittura.

Successivamente, devi creare in Postman le variabili che memorizzano i vari elementi dei token SAS di cui sopra. Alcuni valori sono identici in entrambi gli URL:

Per le interazioni API future, la cosa principale che cambia è il nome della risorsa, mentre le variabili di cui sopra rimangono le stesse. In tal caso, ha senso creare variabili in Postman in modo da non doverle specificare manualmente ogni volta.

In Postman, seleziona Ambienti, apri Tutte le variabili e seleziona Ambiente.

{modal="regular"}

Crea queste 4 variabili nella tabella visualizzata e per le colonne Valore iniziale e Valore corrente, immetti i tuoi valori personali specifici.

Seleziona Salva.

{modal="regular"}

Variabili in PostBuster

Come puoi vedere nella sezione precedente, esistono alcune variabili comuni sia nel token di lettura che in quello di scrittura.

Successivamente è necessario creare variabili in PostBuster che memorizzino i vari elementi dei token SAS di cui sopra. Alcuni valori sono identici in entrambi gli URL:

Aprire PostBuster. Seleziona Ambiente base, quindi fai clic sull'icona modifica per aprire l'Ambiente base.

Vedrai quindi 4 variabili vuote. Immetti qui i dettagli dell’account di archiviazione Azure.

Il file dell’ambiente di base dovrebbe ora avere questo aspetto. Fai clic su Chiudi.

Verifica la configurazione

In uno degli esercizi precedenti, il Corpo della richiesta Firefly - T2I (styleref) V3 era simile al seguente:

"url": "https://vangeluw.blob.core.windows.net/vangeluw/gradient.jpg?sv=2023-01-03&st=2025-01-13T07%3A16%3A52Z&se=2026-01-14T07%3A16%3A00Z&sr=b&sp=r&sig=x4B1XZuAx%2F6yUfhb28hF0wppCOMeH7Ip2iBjNK5A%2BFw%3D"

{modal="regular"}

Modifica l’URL in:

"url": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/gradient.jpg{{AZURE_STORAGE_SAS_READ}}"

Seleziona Invia per verificare le modifiche apportate.

{modal="regular"}

Se le variabili sono state configurate correttamente, viene restituito un URL immagine.

{modal="regular"}

Apri l’URL dell’immagine per verificarla.

Passaggi successivi

Vai a Utilizzo delle API di Photoshop

Torna a Panoramica di Adobe Firefly Services

Torna a Tutti i moduli