1.1.2 Optimieren Sie Ihren Firefly-Prozess mithilfe von Microsoft Azure und vordefinierten URLs

Erfahren Sie, wie Sie Ihren Firefly-Prozess mithilfe von Microsoft Azure und vorsignierten URLs optimieren können.

1.1.2.1 Was sind vorsignierte URLs?

Eine vordefinierte URL ist eine URL, die Ihnen temporären Zugriff auf ein bestimmtes Objekt an einem Speicherort gewährt. Mithilfe der URL kann ein Benutzer beispielsweise entweder das Objekt LESEN oder ein Objekt SCHREIBEN (oder ein vorhandenes Objekt aktualisieren). Die URL enthält bestimmte Parameter, die von Ihrer Anwendung festgelegt werden.

Im Zusammenhang mit der Erstellung der Automatisierung der Content-Supply-Chain gibt es oft mehrere Dateivorgänge, die für einen bestimmten Anwendungsfall erfolgen müssen. Beispielsweise kann es erforderlich sein, den Hintergrund einer Datei zu ändern, den Text verschiedener Ebenen zu ändern usw. Es ist nicht immer möglich, alle Dateioperationen gleichzeitig auszuführen, was einen mehrstufigen Ansatz erforderlich macht. Nach jedem Zwischenschritt ist die Ausgabe dann eine temporäre Datei, die für die Ausführung des nächsten Schritts benötigt wird. Sobald dieser nächste Schritt ausgeführt wird, verliert die temporäre Datei schnell an Wert und wird oft nicht mehr benötigt, sodass sie gelöscht werden sollte.

Adobe Firefly Services unterstützt derzeit die folgenden Domains:

Der Grund, warum häufig Cloud-Speicherlösungen verwendet werden, ist, dass die Zwischenelemente, die erstellt werden, schnell an Wert verlieren. Das Problem, das durch vorsignierte URLs gelöst wird, lässt sich am besten mit einer Massenspeicherlösung lösen, die in der Regel einer der oben genannten Cloud-Services ist.

Innerhalb des Adobe-Ökosystems gibt es auch Speicherlösungen wie Frame.io, Workfront Fusion und Adobe Experience Manager Assets. Diese Lösungen unterstützen auch vorsignierte URLs, sodass während der Implementierung häufig eine Auswahl getroffen werden muss. Die Auswahl basiert dann oft auf einer Kombination aus bereits verfügbaren Anwendungen und Speicherkosten.

Vorsignierte URLs werden daher aus folgenden Gründen in Kombination mit Adobe Firefly Services-Vorgängen verwendet:

Eine vorsignierte URL verwendet drei Parameter, um den Zugriff auf den Benutzer zu beschränken:

Beispiel:

1.1.2.2 Erstellen eines Azure-Abonnements

Wechseln Sie zu https://portal.azure.com und melden Sie sich mit Ihrem Azure-Konto an. Wenn Sie noch keine haben, verwenden Sie bitte Ihre persönliche E-Mail-Adresse, um Ihr Azure-Konto zu erstellen.

{modal="regular"}

Nach erfolgreicher Anmeldung sollte der folgende Bildschirm angezeigt werden:

{modal="regular"}

Wählen Sie im linken Menü Alle Ressourcen aus. Wenn Sie noch kein Abonnement haben, wird der Azure-Abonnementbildschirm angezeigt.

Wenn Sie noch kein Abonnement haben, wählen Sie Mit einer kostenlosen Azure-Testversion beginnen.

{modal="regular"}

Füllen Sie das Azure-Abonnementformular aus und stellen Sie Ihr Mobiltelefon und Ihre Kreditkarte zur Aktivierung bereit (Sie haben 30 Tage lang eine kostenlose Stufe und werden nicht belastet, es sei denn, Sie führen ein Upgrade durch).

Wenn der Abonnementprozess abgeschlossen ist, sind Sie bereit.

{modal="regular"}

1.1.2.3 Azure-Speicherkonto erstellen

Suchen Sie nach storage account und wählen Sie Speicherkonten aus.

{modal="regular"}

Wählen Sie + Erstellen aus.

{modal="regular"}

Wählen Sie Ihr Abonnement und wählen (oder erstellen) Sie eine Ressourcengruppe.

Verwenden unter „Speicherkontoname die --aepUserLdap--.

Wählen Sie Überprüfen + Erstellen aus.

{modal="regular"}

Wählen Sie Erstellen aus.

{modal="regular"}

Wählen Sie nach der Bestätigung Zur Ressource wechseln aus.

{modal="regular"}

Ihr Azure-Speicherkonto ist jetzt einsatzbereit.

{modal="regular"}

Wählen Sie Datenspeicher aus und navigieren Sie dann zu Container. Wählen Sie + Container.

{modal="regular"}

Verwenden Sie --aepUserLdap-- für den Namen und wählen Sie Erstellen.

{modal="regular"}

Ihr Container kann jetzt verwendet werden.

{modal="regular"}

1.1.2.4 Installieren von Azure Storage Explorer

Laden Sie den Microsoft Azure Storage Explorer herunter, um Ihre Dateien zu verwalten. Wählen Sie die richtige Version für Ihr Betriebssystem aus, laden Sie sie herunter und installieren Sie sie.

{modal="regular"}

Öffnen Sie die Anwendung und wählen Sie Mit Azure anmelden aus.

{modal="regular"}

Wählen Sie Abonnement aus.

{modal="regular"}

Wählen Sie Azure und dann Weiter aus.

{modal="regular"}

Wählen Sie Ihr Microsoft Azure-Konto aus und schließen Sie den Authentifizierungsprozess ab.

{modal="regular"}

Nach der Authentifizierung wird diese Meldung angezeigt.

{modal="regular"}

Zurück in der Microsoft Azure Storage Explorer-App, wählen Sie Ihr Abonnement und dann Explorer öffnen.

{modal="regular"}

Ihr Speicherkonto wird unter Speicherkonten angezeigt.

{modal="regular"}

Öffnen Sie Blob-Container und wählen Sie dann den Container aus, den Sie in der vorherigen Übung erstellt haben.

{modal="regular"}

1.1.2.5 Manueller Datei-Upload und Verwendung einer Grafikdatei als Stilreferenz

Laden Sie eine Bilddatei Ihrer Wahl oder diese Datei in den Container hoch.

Nach dem Hochladen wird sie in Ihrem Container angezeigt:

{modal="regular"}

Klicken Sie mit der rechten Maustaste auf gradient.jpg und wählen Sie Freigegebene Zugriffssignatur abrufen.

{modal="regular"}

Unter Berechtigungen ist nur Lesen erforderlich. Wählen Sie Erstellen aus.

{modal="regular"}

Kopieren Sie Ihre vordefinierte URL für diese Bilddatei für die nächste API-Anfrage an Firefly.

{modal="regular"}

Zurück in Postman öffnen Sie die Anfrage POST - Firefly - T2I (styleref) V3.
Dies wird in "".

{modal="regular"}

Ersetzen Sie die Platzhalter-URL durch die vordefinierte URL für Ihre Bilddatei und wählen Sie Senden.

{modal="regular"}

Öffnen Sie das neue Firefly Services-Antwortbild in Ihrem Browser.

{modal="regular"}

Mit horses in a field wird ein weiteres Bild angezeigt, aber dieses Mal ähnelt der Stil der Bilddatei, die Sie als Stilreferenz bereitgestellt haben.

{modal="regular"}

Programmgesteuertes 1.1.2.6 von Dateien

Um den programmgesteuerten Datei-Upload mit Azure Storage-Konten zu verwenden, müssen Sie ein neues Shared Access Signature (SAS)- mit Berechtigungen erstellen, die Ihnen das Schreiben einer Datei ermöglichen.

Klicken Sie im Azure Storage Explorer mit der rechten Maustaste auf Ihren Container und wählen Sie Freigegebene Zugriffssignatur abrufen.

{modal="regular"}

Wählen unter die folgenden erforderlichen Berechtigungen aus:

Wählen Sie Erstellen aus.

{modal="regular"}

Nachdem Sie Ihre Shared Access Signature erhalten haben, wählen Sie Kopieren aus, um die URL zu kopieren.

{modal="regular"}

Verwenden Sie die SAS-Token-URL, um eine Datei in Ihr Azure-Speicherkonto hochzuladen.

Zurück in Postman, wählen Sie den Ordner FF - Firefly Services Tech Insiders und dann … im Ordner Firefly aus und klicken Sie dann auf Anfrage hinzufügen.

{modal="regular"}

Ändern Sie den Namen der leeren Anfrage in Datei in Azure-Speicherkonto hochladen ändern Sie den Anfragetyp in PUT und fügen Sie die SAS-Token-URL in den URL-Abschnitt ein und wählen Sie dann body.

{modal="regular"}

Wählen Sie anschließend eine Datei auf Ihrem lokalen Computer aus oder verwenden Sie eine andere Bilddatei hier.

Wählen Hauptteil die Option Binär dann Datei auswählen und wählen Sie dann + Neue Datei vom lokalen Computer aus.

{modal="regular"}

Wählen Sie die gewünschte Datei aus und klicken Sie auf Öffnen.

{modal="regular"}

Geben Sie als Nächstes den Dateinamen an, der in Ihrem Azure-Speicherkonto verwendet werden soll, indem Sie den Cursor vor das Fragezeichen setzen? in der URL wie folgt aus:

{modal="regular"}

Die URL sieht derzeit wie folgt aus, muss jedoch geändert werden.

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

Ändern Sie den Dateinamen in gradient2-p.jpg und ändern Sie die URL so, dass sie den Dateinamen wie folgt enthält:

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

{modal="regular"}

Gehen Sie dann zu Headers, um einen neuen Header wie den folgenden manuell hinzuzufügen:

{modal="regular"}

Wechseln Sie zu Autorisierung und legen Sie Auth-Typ auf Keine Autorisierung fest und wählen Sie Senden.

{modal="regular"}

Als Nächstes wird diese leere Antwort in Postman angezeigt, was bedeutet, dass Ihr Datei-Upload gut ist.

{modal="regular"}

Aktualisieren Sie im Azure Storage Explorer den Inhalt Ihres Ordners, und die neu hochgeladene Datei wird angezeigt.

{modal="regular"}

1.1.2.7 Verwendung der programmgesteuerten Datei

Um langfristig programmgesteuert Dateien aus Azure Storage-Konten lesen zu können, müssen Sie ein neues Shared Access Signature (SAS)-Token Berechtigungen erstellen, mit denen Sie eine Datei lesen können. Technisch gesehen könnten Sie das in der vorherigen Übung erstellte SAS-Token verwenden, aber es empfiehlt sich, ein separates Token mit nur Lese-Berechtigungen und ein separates Token mit nur Schreib-Berechtigungen zu verwenden.

Langfristiges SAS-Token lesen

Gehen Sie zurück zum Azure Storage-Explorer, klicken Sie mit der rechten Maustaste auf Ihren Container und wählen Sie Freigegebene Zugriffssignatur abrufen.

{modal="regular"}

Wählen unter die folgenden erforderlichen Berechtigungen aus:

Legen Sie Ablaufzeit auf einen Zeitraum von 1 Jahr fest.

Wählen Sie Erstellen aus.

{modal="regular"}

Kopieren Sie die URL und schreiben Sie sie in eine Datei auf Ihrem Computer, um Ihr langfristiges SAS-Token mit Leseberechtigung zu erhalten.

{modal="regular"}

Ihre URL sollte wie folgt aussehen:

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

Sie können aus der obigen URL mehrere Werte ableiten:

Langfristiges SAS-Token schreiben

Gehen Sie zurück zum Azure Storage-Explorer, klicken Sie mit der rechten Maustaste auf Ihren Container und wählen Sie Freigegebene Zugriffssignatur abrufen.

{modal="regular"}

Wählen unter die folgenden erforderlichen Berechtigungen aus:

Legen Sie die Ablaufzeit auf ein Jahr fest.

Wählen Sie Erstellen aus.

{modal="regular"}

Kopieren Sie die URL und schreiben Sie sie in eine Datei auf Ihrem Computer, um Ihr langfristiges SAS-Token mit Lese-/Schreibberechtigungen zu erhalten.

{modal="regular"}

Ihre URL sollte wie folgt aussehen:

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

Sie können aus der obigen URL mehrere Werte ableiten:

Variablen in Postman

Wie Sie im obigen Abschnitt sehen können, gibt es einige allgemeine Variablen sowohl im Lese- als auch im Schreib-Token.

Als Nächstes müssen Sie Variablen in Postman erstellen, die die verschiedenen Elemente der oben genannten SAS-Token speichern. Es gibt einige Werte, die in beiden URLs identisch sind:

Für zukünftige API-Interaktionen ändert sich hauptsächlich der Asset-Name, während die oben genannten Variablen unverändert bleiben. In diesem Fall ist es sinnvoll, Variablen in Postman zu erstellen, sodass Sie sie nicht jedes Mal manuell angeben müssen.

Wählen Sie in Postman Umgebungen, öffnen Sie Alle Variablen und wählen Sie Umgebung.

{modal="regular"}

Erstellen Sie diese 4 Variablen in der angezeigten Tabelle und geben Sie für die Spalten Anfangswert und Aktueller Wert Ihre spezifischen persönlichen Werte ein.

Wählen Sie Speichern aus.

{modal="regular"}

Variablen in PostBuster

Wie Sie im obigen Abschnitt sehen können, gibt es einige allgemeine Variablen sowohl im Lese- als auch im Schreib-Token.

Als Nächstes müssen Sie Variablen in PostBuster erstellen, die die verschiedenen Elemente der oben genannten SAS-Token speichern. Es gibt einige Werte, die in beiden URLs identisch sind:

Öffnen Sie PostBuster. Wählen Sie Basisumgebung und klicken Sie dann auf das Symbol Bearbeiten, um die Basisumgebung zu öffnen.

Anschließend werden 4 leere Variablen angezeigt. Geben Sie hier Ihre Azure Storage-Kontodetails ein.

Ihre Basisumgebungsdatei sollte jetzt wie folgt aussehen. Klicken Sie auf Schließen.

Testen der Konfiguration

In einer der vorherigen Übungen sah der Hauptteil Ihrer Anfrage Firefly - T2I (styleref) V3 wie folgt aus:

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

Ändern Sie die URL in:

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

Wählen Sie Senden aus, um die vorgenommenen Änderungen zu testen.

{modal="regular"}

Wenn die Variablen richtig konfiguriert waren, wird eine Bild-URL zurückgegeben.

{modal="regular"}

Öffnen Sie die Bild-URL, um Ihr Bild zu überprüfen.

Nächste Schritte

Navigieren Sie zu Arbeiten mit Photoshop-APIs

Zurück zu Übersicht über Adobe Firefly Services

Zurück zu Alle Module