1.1.2 Optimisez votre processus Firefly à l’aide de Microsoft Azure et des URL présignées.

Découvrez comment optimiser votre processus Firefly à l’aide de Microsoft Azure et des URL présignées.

1.1.2.1 Que sont les URL présignées ?

Une URL présignée est une URL qui vous accorde un accès temporaire à un objet spécifique dans un emplacement de stockage. En utilisant l’URL, un utilisateur peut par exemple LIRE l’objet ou ÉCRIRE un objet (ou mettre à jour un objet existant). L’URL contient des paramètres spécifiques définis par votre application.

Dans le contexte de la création de l’automatisation de la chaîne d’approvisionnement du contenu, plusieurs opérations de fichiers doivent souvent se produire pour un cas d’utilisation spécifique. Par exemple, il se peut que l’arrière-plan d’un fichier doive être modifié, que le texte de différents calques doive être modifié, etc. Il n’est pas toujours possible d’effectuer toutes les opérations de fichier en même temps, ce qui rend nécessaire une approche à plusieurs étapes. Après chaque étape intermédiaire, la sortie est alors un fichier temporaire qui est nécessaire pour que l’étape suivante soit exécutée. Une fois cette étape suivante exécutée, le fichier temporaire perd rapidement de la valeur et n’est souvent plus nécessaire, il doit donc être supprimé.

Adobe Firefly Services prend actuellement en charge les domaines suivants :

La raison pour laquelle des solutions de stockage dans le cloud sont souvent utilisées, c’est que les ressources intermédiaires en cours de création perdent rapidement de la valeur. Le problème résolu par les URL présignées est souvent mieux résolu avec une solution de stockage de ressources, qui est généralement l’un des services cloud ci-dessus.

L’écosystème Adobe comprend également des solutions de stockage, telles que Frame.io, Workfront Fusion et Adobe Experience Manager Assets. Ces solutions prennent également en charge les URL présignées, ce qui fait qu’il s’agit souvent d’un choix à effectuer lors de la mise en œuvre. Le choix est alors souvent basé sur une combinaison d'applications déjà disponibles et de coûts de stockage.

Par conséquent, les URL présignées sont utilisées conjointement avec les opérations Adobe Firefly Services pour les raisons suivantes :

Une URL présignée utilise trois paramètres pour limiter l’accès à l’utilisateur :

Exemple :

1.1.2.2 Créer un abonnement Azure

Accédez à https://portal.azure.com et connectez-vous avec votre compte Azure. Si vous n’en avez pas, veuillez utiliser votre adresse e-mail personnelle pour créer votre compte Azure.

{modal="regular"}

Une fois la connexion établie, l’écran suivant s’affiche :

{modal="regular"}

Dans le menu de gauche, sélectionnez Toutes les ressources, l’écran d’abonnement Azure s’affiche si vous n’êtes pas encore abonné.

Si vous n’êtes pas abonné, sélectionnez Commencer avec une version d’évaluation gratuite d’Azure.

{modal="regular"}

Remplissez le formulaire d'abonnement Azure et fournissez votre téléphone mobile et votre carte de crédit pour l'activation (vous aurez un niveau gratuit pendant 30 jours et vous ne serez pas facturé, sauf si vous effectuez une mise à niveau).

Une fois le processus d’abonnement terminé, tout est prêt.

{modal="regular"}

1.1.2.3 Créer Un Compte De Stockage Azure

Recherchez storage account puis sélectionnez Comptes de stockage.

{modal="regular"}

Sélectionnez + Créer.

{modal="regular"}

Sélectionnez votre Abonnement et sélectionnez (ou créez) un Groupe de ressources.

Sous Nom du compte de stockage utilisez --aepUserLdap--.

Sélectionnez Réviser + créer.

{modal="regular"}

Sélectionnez Créer.

{modal="regular"}

Après confirmation, sélectionnez Accéder à la ressource.

{modal="regular"}

Votre compte de stockage Azure est maintenant prêt à être utilisé.

{modal="regular"}

Sélectionnez Stockage de données, puis accédez à Conteneurs. Sélectionnez Conteneur +.

{modal="regular"}

Utilisez --aepUserLdap-- pour le nom et sélectionnez Créer.

{modal="regular"}

Votre conteneur est maintenant prêt à être utilisé.

{modal="regular"}

1.1.2.4 Installer l’explorateur de stockage Azure

Téléchargez l’explorateur de stockage Azure Microsoft pour gérer vos fichiers. Sélectionnez la version appropriée pour votre système d’exploitation spécifique, téléchargez-la et installez-la.

{modal="regular"}

Ouvrez l’application et sélectionnez Se connecter avec Azure.

{modal="regular"}

Sélectionnez Abonnement.

{modal="regular"}

Sélectionnez Azure puis Suivant.

{modal="regular"}

Sélectionnez votre compte Microsoft Azure et terminez le processus d’authentification.

{modal="regular"}

Une fois l’authentification terminée, ce message s’affiche.

{modal="regular"}

De retour dans l’application Microsoft Azure Storage Explorer, sélectionnez votre abonnement et choisissez Ouvrir l’explorateur.

{modal="regular"}

Votre compte de stockage apparaît sous Comptes de stockage.

{modal="regular"}

Ouvrez Conteneurs Blob puis sélectionnez le conteneur que vous avez créé dans l’exercice précédent.

{modal="regular"}

1.1.2.5 Chargement manuel du fichier et utilisation d’un fichier image comme référence de style

Chargez un fichier image de votre choix ou ce fichier dans le conteneur.

Une fois le chargement effectué, vous pouvez le voir dans votre conteneur :

{modal="regular"}

Cliquez avec le bouton droit sur gradient.jpg, puis sélectionnez Obtenir la signature d’accès partagé.

{modal="regular"}

Sous Autorisations, seule la mention Lecture est requise. Sélectionnez Créer.

{modal="regular"}

Copiez l’URL prédéfinie de ce fichier image pour la prochaine demande d’API dans Firefly.

{modal="regular"}

De retour dans Postman, ouvrez la requête POST - Firefly - T2I (styleref) V3.
Elle apparaît dans Corps.

{modal="regular"}

Remplacez l’URL de l’espace réservé par l’URL présignée pour votre fichier image et sélectionnez Envoyer.

{modal="regular"}

Ouvrez la nouvelle image du Firefly Services de réponse dans votre navigateur.

{modal="regular"}

Une autre image apparaît avec horses in a field, mais cette fois, le style est similaire au fichier image que vous avez fourni comme référence de style.

{modal="regular"}

1.1.2.6 Chargement de fichier par programmation

Pour utiliser le chargement de fichiers par programmation avec des comptes de stockage Azure, vous devez créer un jeton Signature d’accès partagé (SAS) avec des autorisations qui vous permettent d’écrire un fichier.

Dans l’explorateur de stockage Azure, cliquez avec le bouton droit sur votre conteneur, puis sélectionnez Obtenir la signature d’accès partagé.

{modal="regular"}

Sous Autorisations, sélectionnez les autorisations requises suivantes :

Sélectionnez Créer.

{modal="regular"}

Après avoir reçu votre Signature d’accès partagé, sélectionnez Copier pour copier l’URL.

{modal="regular"}

Utilisez l’URL du jeton SAS pour charger un fichier dans votre compte de stockage Azure.

De retour dans Postman, sélectionnez le dossier FF - Firefly Services Tech Insiders, puis sélectionnez … dans le dossier Firefly et enfin sélectionnez Ajouter une requête.

{modal="regular"}

Modifiez le nom de la requête vide en Télécharger le fichier sur le compte de stockage Azure, modifiez le Type de requête en PUT et collez l’URL du jeton SAS dans la section URL, puis sélectionnez Corps.

{modal="regular"}

Sélectionnez ensuite un fichier sur votre ordinateur local ou utilisez un autre fichier image situé ici.

Dans Corps, sélectionnez binaire puis Sélectionner un fichier, puis sélectionnez + Nouveau fichier à partir de l’ordinateur local.

{modal="regular"}

Sélectionnez le fichier de votre choix et sélectionnez Ouvrir.

{modal="regular"}

Indiquez ensuite le nom du fichier à utiliser dans votre compte de stockage Azure en plaçant votre curseur devant le point d’interrogation ? dans l’URL comme suit :

{modal="regular"}

L’URL ressemble actuellement à ceci, mais doit être modifiée.

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

Remplacez le nom du fichier par gradient2-p.jpg, puis modifiez l’URL afin d’inclure le nom du fichier comme suit :

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

{modal="regular"}

Accédez ensuite à En-têtes pour ajouter manuellement un nouvel en-tête comme celui-ci :

{modal="regular"}

Accédez à Autorisation et définissez le Type d’authentification sur Aucune authentification, puis sélectionnez Envoyer.

{modal="regular"}

Ensuite, cette réponse vide s’affiche dans Postman, ce qui signifie que votre chargement de fichier est correct.

{modal="regular"}

De retour dans l’explorateur de stockage Azure, actualisez le contenu de votre dossier pour faire apparaître le fichier nouvellement chargé.

{modal="regular"}

1.1.2.7 Utilisation des fichiers par programmation

Pour lire par programmation les fichiers des comptes de stockage Azure à long terme, vous devez créer un jeton Signature d’accès partagé (SAS) avec des autorisations qui vous permettent de lire un fichier. Techniquement, vous pouvez utiliser le jeton SAS créé dans l’exercice précédent, mais il est recommandé d’avoir un jeton distinct avec uniquement des autorisations Lecture et un jeton distinct avec uniquement des autorisations Écriture.

Jeton SAS de lecture à long terme

Revenez à l’Explorateur de stockage Azure, cliquez avec le bouton droit sur votre conteneur, puis sélectionnez Obtenir la signature d’accès partagé.

{modal="regular"}

Sous Autorisations, sélectionnez les autorisations requises suivantes :

Définissez Délai d’expiration sur 1 an à partir de maintenant.

Sélectionnez Créer.

{modal="regular"}

Copiez l’URL et écrivez-la dans un fichier sur votre ordinateur pour obtenir votre jeton SAS à long terme avec les autorisations de lecture.

{modal="regular"}

Votre URL doit se présenter comme suit :

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

Vous pouvez dériver quelques valeurs de l’URL ci-dessus :

Jeton SAS d’écriture à long terme

Revenez à l’Explorateur de stockage Azure, cliquez avec le bouton droit sur votre conteneur et sélectionnez Obtenir la signature d’accès partagé.

{modal="regular"}

Sous Autorisations, sélectionnez les autorisations requises suivantes :

Définissez la variable Délai d’expiration sur 1 an à partir de maintenant.

Sélectionnez Créer.

{modal="regular"}

Copiez l’URL et écrivez-la dans un fichier sur votre ordinateur pour obtenir votre jeton SAS à long terme avec les autorisations de lecture/écriture.

{modal="regular"}

Votre URL doit se présenter comme suit :

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

Vous pouvez dériver quelques valeurs de l’URL ci-dessus :

Variables dans Postman

Comme vous pouvez le voir dans la section ci-dessus, il existe des variables communes dans les jetons Lecture et Écriture .

Vous devez ensuite créer des variables dans Postman qui stockent les différents éléments des jetons SAS ci-dessus. Certaines valeurs sont identiques dans les deux URL :

Pour les interactions d’API futures, la principale chose qui change est le nom de la ressource, tandis que les variables ci-dessus restent les mêmes. Dans ce cas, il est logique de créer des variables dans Postman afin de ne pas avoir à les spécifier manuellement à chaque fois.

Dans Postman, sélectionnez Environnements, ouvrez Toutes les variables et sélectionnez Environnement.

{modal="regular"}

Créez ces 4 variables dans le tableau qui s’affiche. Pour les colonnes Valeur initiale et Valeur actuelle, saisissez vos valeurs personnelles spécifiques.

Sélectionnez Enregistrer.

{modal="regular"}

Variables dans PostBuster

Comme vous pouvez le voir dans la section ci-dessus, il existe des variables communes dans les jetons Lecture et Écriture .

Vous devez ensuite créer des variables dans PostBuster qui stockent les différents éléments des jetons SAS ci-dessus. Certaines valeurs sont identiques dans les deux URL :

Ouvrez PostBuster. Sélectionnez Environnement de base puis cliquez sur l’icône Modifier pour ouvrir l’environnement de base.

Vous verrez alors 4 variables vides. Saisissez les détails de votre compte de stockage Azure ici.

Votre fichier d’environnement de base doit maintenant se présenter comme suit : Cliquez sur Fermer.

Tester votre configuration

Dans l’un des exercices précédents, le Corps de votre requête Firefly - T2I (styleref) V3 ressemblait à ceci :

"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"}

Modifiez l’URL en :

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

Sélectionnez Envoyer pour tester les modifications que vous avez apportées.

{modal="regular"}

Si les variables ont été configurées correctement, une URL d’image est renvoyée.

{modal="regular"}

Ouvrez l’URL de l’image pour vérifier votre image.

Étapes suivantes

Accédez à Utilisation des API Photoshop

Revenez à Présentation de Adobe Firefly Services

Revenir à Tous les modules