1.1.2 Optimaliseer uw Firefly-proces met Microsoft Azure en vooraf ondertekende URL's
Leer hoe u uw Firefly-proces kunt optimaliseren met Microsoft Azure en vooraf ondertekende URL's.
1.1.2.1 Wat zijn vooraf ondertekende URL's?
Een vooraf ondertekende URL is een URL die u tijdelijke toegang verleent tot een specifiek object op een opslaglocatie. Met de URL kan een gebruiker bijvoorbeeld het object LEZEN of een object SCHRIJVEN (of een bestaand object bijwerken). De URL bevat specifieke parameters die door de toepassing worden ingesteld.
Bij het maken van de automatisering van de toeleveringsketen voor inhoud zijn er vaak meerdere bestandsbewerkingen die moeten worden uitgevoerd voor een bepaald geval van gebruik. Het kan bijvoorbeeld nodig zijn de achtergrond van een bestand te wijzigen, de tekst van verschillende lagen te wijzigen, enzovoort. Het is niet altijd mogelijk om alle dossierverrichtingen tezelfdertijd te doen die tot de behoefte aan een multi-step benadering leidt. Na elke tussenstap is de uitvoer een tijdelijk bestand dat nodig is voor de volgende stap die moet worden uitgevoerd. Wanneer die volgende stap is uitgevoerd, verliest het tijdelijke bestand snel zijn waarde en is het vaak niet meer nodig, dus moet het worden verwijderd.
Adobe Firefly Services biedt momenteel ondersteuning voor de volgende domeinen:
- Amazon AWS: *.amazonaws.com
- Microsoft Azure: *.windows.net
- Dropbox: *.dropboxusercontent.com
De reden waarom vaak cloudopslagoplossingen worden gebruikt, is dat de tussenliggende elementen die worden gemaakt, snel waarde verliezen. Het probleem dat wordt opgelost door vooraf ondertekende URL's, kan het beste worden opgelost met een opslagoplossing voor basisproducten, die doorgaans een van de bovenstaande cloudservices is.
Binnen het ecosysteem van Adobe zijn er ook opslagoplossingen, zoals Frame.io, Workfront Fusion en Adobe Experience Manager assets. Deze oplossingen ondersteunen ook vooraf ondertekende URL's, zodat het vaak een keuze wordt die tijdens de implementatie moet worden gemaakt. De keuze wordt dan vaak gebaseerd op een combinatie van reeds beschikbare toepassingen en opslagkosten.
Vooraf ondertekende URL's worden daarom gebruikt in combinatie met Adobe Firefly Services-bewerkingen omdat:
- organisaties moeten vaak meerdere wijzigingen in hetzelfde image in tussenliggende stappen verwerken en tussenliggende opslag is nodig om dat mogelijk te maken.
- de toegang tot lezen en schrijven van de plaatsen van de cloudopslag zou veilig moeten zijn en in een server-zijmilieu, is het niet mogelijk manueel login zodat de veiligheid in URL direct moet worden bewaard.
Een vooraf ondertekende URL gebruikt drie parameters om de toegang tot de gebruiker te beperken:
- Opslaglocatie: dit kan een AWS S3 bucket-locatie zijn, een Microsoft Azure-opslaglocatie met container
- Bestandsnaam: het specifieke bestand dat moet worden gelezen, bijgewerkt, verwijderd.
- De het koordparameter van de vraag: een parameter van het vraagkoord begint altijd met een vraagteken en door een complexe reeks paramaters wordt gevolgd
Voorbeeld:
- Amazon AWS:
https://bucket.s3.eu-west-2.amazonaws.com/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AXXXXXXXXXX%2Feu-west-2%2Fs3%2Faws4_request&X-Amz-Date=20250510T171315Z&X-Amz-Expires=1800&X-Amz-Signature=XXXXXXXXX&X-Amz-SignedHeaders=host - Microsoft Azure:
https://storageaccount.blob.core.windows.net/container/image.png?sv=2023-01-03&st=2025-01-13T07%3A16%3A52Z&se=2026-01-14T07%3A16%3A00Z&sr=b&sp=r&sig=XXXXXX%3D
1.1.2.2 Een Azure-abonnement maken
Ga naar https://portal.azure.com en login met uw Azure rekening. Als je er geen hebt, gebruik dan je persoonlijke e-mailadres om je Azure-account te maken.
Na succesvolle login zou u het volgende scherm moeten zien:
Op het linkermenu uitgezocht Alle Middelen, verschijnt het Azure abonnementsscherm als u nog niet wordt ingetekend.
Als u niet wordt geabonneerd, uitgezochte Begin met een Azure vrije Proef.
Vul het Azure-abonnementsformulier in en geef uw mobiele telefoon en creditcard op voor activering (u hebt 30 dagen een gratis label en u wordt geen kosten in rekening gebracht, tenzij u een upgrade uitvoert).
Als het abonnementsproces is voltooid, kunt u het beste gaan.
1.1.2.3 Azure Storage Account maken
Onderzoek naar storage account en selecteer dan rekeningen van de Opslag.
Selecteer + creëren.
Selecteer uw Abonnement en selecteer (of creeer) de groep van het Middel van a .
Onder naam van de de rekeningsrekening van de Opslag gebruik --aepUserLdap--.
Selecteer Overzicht + creeer.
Selecteer creeer.
Na bevestiging selecteert ga naar middel.
Uw Azure-opslagaccount is nu klaar om te worden gebruikt.
Selecteer Opslag van Gegevens, en ga dan naar Containers. Selecteer + Container.
Het gebruik --aepUserLdap-- voor de naam en selecteert creeert.
Uw container is nu klaar om te worden gebruikt.
1.1.2.4 Azure Storage Explorer installeren
Download Microsoft Azure Storage Explorer om uw dossiers te beheren. Selecteer de juiste versie voor uw specifieke besturingssysteem, download en installeer deze.
Open de toepassing en selecteer Teken binnen met Azure.
Selecteer Abonnement.
Selecteer Azure en dan daarna.
Selecteer uw Microsoft Azure-account en voltooi het verificatieproces.
Na de verificatie wordt dit bericht weergegeven.
Terug in Microsoft Azure de app van de Ontdekkingsreiziger van de Opslag, selecteer uw abonnement en kies Open Ontdekkingsreiziger.
Uw opslagrekening verschijnt onder Rekeningen van de Opslag.
Open Containers van de Klodder en selecteer dan de container u in de vorige oefening creeerde.
1.1.2.5 Handmatig bestanden uploaden en een afbeeldingsbestand gebruiken als stijlverwijzing
Upload een beelddossier van uw keus of dit dossier in de container.
- image/jpeg
- image/png
- image/webpagina
Na het uploaden kunt u het zien in uw container:
Klik op gradient.jpg met de rechtermuisknop aan en selecteer dan krijgen de Gedeelde Handtekening van de Toegang.
Onder Toestemmingen, slechts Gelezen wordt vereist. Selecteer creeer.
Kopieer uw vooraf ondertekende URL voor dit afbeeldingsbestand voor de volgende API-aanvraag naar Firefly.
Terug in Postman open het verzoek POST - Firefly - T2I (styleref) V3.
Dit verschijnt in Lichaam.
Vervang placeholder URL met presigned URL voor uw beelddossier en selecteer verzend.
Open de reactie Firefly Services nieuwe afbeelding in uw browser.
Er wordt een andere afbeelding weergegeven bij horses in a field , maar deze keer lijkt de stijl op het afbeeldingsbestand dat u als stijlverwijzing hebt opgegeven.
1.1.2.6 Programmatische bestandsupload
Om programmatic dossierupload met de Rekeningen van de Opslag te gebruiken Azure, moet u een nieuw Gedeelde handtekening van de Toegang (SAS) met toestemmingen tot stand brengen die u toestaan om een dossier te schrijven.
In de Verkenner van de Opslag van Azure, klik uw container met de rechtermuisknop aan, en selecteer krijgen de Gedeelde Ondertekening van de Toegang.
Onder Toestemmingen, selecteer de volgende vereiste toestemmingen:
- Gelezen
- voeg toe
- creeer
- schrijf
- Lijst
Selecteer creeer.
Na het ontvangen van uw Gedeelde Ondertekening van de Toegang, uitgezochte Exemplaar om URL te kopiëren.
Gebruik SAS-token URL om een dossier in uw Azure Rekening van de Opslag te uploaden.
Terug in Postman, selecteer de omslag FF - de Tech Insiders van Firefly Services, dan uitgezocht … op de Firefly omslag, en selecteer dan verzoek toevoegen.
Verander de naam van het lege verzoek aan uploadt dossier aan de Rekening van de Opslag Azure, verander het Type van Verzoek in PUT en kleef SAS-token URL in de sectie URL, dan uitgezochte Lichaam.
Daarna, selecteer een dossier van uw lokale machine of gebruik een ander beelddossier dat hier wordt gevestigd.
In Lichaam, selecteer binair toen Uitgezochte dossier, dan uitgezocht + Nieuw dossier van lokale machine.
Selecteer uw dossier van keus en selecteer Open.
Geef vervolgens de bestandsnaam op die in uw Azure Storage Account moet worden gebruikt door de cursor vóór het vraagteken te plaatsen? in de URL als volgt:
De URL ziet er momenteel als volgt uit, maar moet worden gewijzigd.
https://vangeluw.blob.core.windows.net/vangeluw?sv=2023-01-03...
Wijzig de bestandsnaam in gradient2-p.jpg en wijzig de URL zo en voeg de bestandsnaam als volgt toe:
https://vangeluw.blob.core.windows.net/vangeluw/gradient2-p.jpg?sv=2023-01-03...
Daarna, ga aan Kopballen om een nieuwe kopbal manueel als dit toe te voegen:
x-ms-blob-typeBlockBlob
Ga naar Vergunning en plaats het Type van Auth aan Geen Auth, en selecteer verzenden.
Vervolgens wordt deze lege reactie weergegeven in Postman, wat betekent dat het uploaden van het bestand is voltooid.
In Azure Storage Explorer vernieuwt u de inhoud van uw map en wordt het nieuwe geüploade bestand weergegeven.
1.1.2.7 Programmatisch bestandsgebruik
Om dossiers van de Rekeningen van de Opslag van Azure op lange termijn programmatically te lezen, moet u een nieuw Gedeelde handtekening van de Toegang (SAS) teken, met toestemmingen tot stand brengen die u toestaan om een dossier te lezen. Technisch kon u het SAS-teken gebruiken dat in de vorige oefening wordt gecreeerd, maar het is beste praktijken om een afzonderlijk teken met slechts te hebben gelezen toestemmingen en afzonderlijk teken met slechts schrijft toestemmingen.
Leesbaar SAS-token op lange termijn
Ga terug naar Azure de Ontdekkingsreiziger van de Opslag, klik uw container met de rechtermuisknop aan en selecteer dan krijgen de Gedeelde Ondertekening van de Toegang.
Onder Toestemmingen, selecteer de volgende vereiste toestemmingen:
- Gelezen
- Lijst
Plaats Vervaltijd aan 1 jaar van nu.
Selecteer creeer.
Kopieer de URL en noteer deze in een bestand op uw computer om uw SAS-token voor de lange termijn met leesmachtigingen op te halen.
Uw URL moet er als volgt uitzien:
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
U kunt enkele waarden afleiden van de bovenstaande URL:
AZURE_STORAGE_URL:https://vangeluw.blob.core.windows.netAZURE_STORAGE_CONTAINER:vangeluwAZURE_STORAGE_SAS_READ:?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
SAS-token voor schrijven op lange termijn
Ga terug naar Azure de Ontdekkingsreiziger van de Opslag, klik uw container met de rechtermuisknop aan en selecteer krijgen de Gedeelde Ondertekening van de Toegang.
Onder Toestemmingen, selecteer de volgende vereiste toestemmingen:
- Gelezen
- Lijst
- voeg toe
- creeer
- schrijf
Plaats de Vervaltijd aan 1 jaar van nu.
Selecteer creeer.
Kopieer de URL en noteer deze in een bestand op uw computer om uw SAS-token op lange termijn met lees- en schrijfmachtigingen op te halen.
Uw URL moet er als volgt uitzien:
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
U kunt enkele waarden afleiden van de bovenstaande URL:
AZURE_STORAGE_URL:https://vangeluw.blob.core.windows.netAZURE_STORAGE_CONTAINER:vangeluwAZURE_STORAGE_SAS_READ:?sv=2023-01-03&st=2025-01-13T07%3A36%3A35Z&se=2026-01-14T07%3A36%3A00Z&sr=c&sp=rl&sig=4r%2FcSJLlt%2BSt9HdFdN0VzWURxRK6UqhB8TEvbWkmAag%3DAZURE_STORAGE_SAS_WRITE:?sv=2023-01-03&st=2025-01-13T07%3A38%3A59Z&se=2026-01-14T07%3A38%3A00Z&sr=c&sp=acw&sig=lR9%2FMUfyYLcBK7W9Kv7YJdYz5HEEEovExAdOCOCUdMk%3D
Variabelen in Postman
Zoals u in de bovengenoemde sectie kunt zien, zijn er sommige gemeenschappelijke variabelen in zowel Gelezen als het Schrijven teken.
Vervolgens moet u in Postman variabelen maken die de verschillende elementen van de bovenstaande SAS-tokens opslaan. Er zijn enkele waarden die hetzelfde zijn in beide URL's:
AZURE_STORAGE_URL:https://vangeluw.blob.core.windows.netAZURE_STORAGE_CONTAINER:vangeluwAZURE_STORAGE_SAS_READ:?sv=2023-01-03&st=2025-01-13T07%3A36%3A35Z&se=2026-01-14T07%3A36%3A00Z&sr=c&sp=rl&sig=4r%2FcSJLlt%2BSt9HdFdN0VzWURxRK6UqhB8TEvbWkmAag%3DAZURE_STORAGE_SAS_WRITE:?sv=2023-01-03&st=2025-01-13T07%3A38%3A59Z&se=2026-01-14T07%3A38%3A00Z&sr=c&sp=acw&sig=lR9%2FMUfyYLcBK7W9Kv7YJdYz5HEEEovExAdOCOCUdMk%3D
Voor toekomstige API-interacties is de elementnaam het belangrijkste wat verandert, terwijl de bovenstaande variabelen ongewijzigd blijven. In dat geval is het handig om variabelen te maken in Postman, zodat u ze niet telkens handmatig hoeft op te geven.
In Postman, uitgezochte Milieu, open Alle variabelen en selecteer Milieu.
Creeer deze 4 variabelen in de lijst die wordt getoond en voor de kolommen Aanvankelijke waarde en Huidige waarde, ga uw specifieke persoonlijke waarden in.
AZURE_STORAGE_URL: uw URLAZURE_STORAGE_CONTAINER: de naam van uw containerAZURE_STORAGE_SAS_READ: uw SAS-leestokenAZURE_STORAGE_SAS_WRITE: uw SAS-schrijftoken
Selecteer sparen.
Variabelen in PostBuster
Zoals u in de bovengenoemde sectie kunt zien, zijn er sommige gemeenschappelijke variabelen in zowel Gelezen als het Schrijven teken.
Vervolgens moet u variabelen maken in PostBuster waarin de verschillende elementen van de bovenstaande SAS-tokens worden opgeslagen. Er zijn enkele waarden die hetzelfde zijn in beide URL's:
AZURE_STORAGE_URL:https://vangeluw.blob.core.windows.netAZURE_STORAGE_CONTAINER:vangeluwAZURE_STORAGE_SAS_READ:?sv=2023-01-03&st=2025-01-13T07%3A36%3A35Z&se=2026-01-14T07%3A36%3A00Z&sr=c&sp=rl&sig=4r%2FcSJLlt%2BSt9HdFdN0VzWURxRK6UqhB8TEvbWkmAag%3DAZURE_STORAGE_SAS_WRITE:?sv=2023-01-03&st=2025-01-13T07%3A38%3A59Z&se=2026-01-14T07%3A38%3A00Z&sr=c&sp=acw&sig=lR9%2FMUfyYLcBK7W9Kv7YJdYz5HEEEovExAdOCOCUdMk%3D
Open Postbus. Selecteer Milieu van de Basis en klik dan uitgeven pictogram om het Milieu van de Basis te openen.
Dan zie je 4 lege variabelen. Voer hier uw Azure Storage Account-gegevens in.
Het bestand voor de basisomgeving moet er nu zo uitzien. Klik dicht.
Uw configuratie testen
In één van de vorige oefeningen, zag het Lichaam van uw verzoek Firefly - T2I (styleref) V3 als dit:
"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"
Wijzig de URL in:
"url": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/gradient.jpg{{AZURE_STORAGE_SAS_READ}}"
Selecteer verzenden om de veranderingen te testen u aanbracht.
Als de variabelen correct zijn geconfigureerd, wordt een beeld-URL geretourneerd.
Open de URL van de afbeelding om uw afbeelding te controleren.
Volgende stappen
Ga naar Werkend met Photoshop APIs
Ga terug naar Overzicht van Adobe Firefly Services
Ga terug naar Alle Modules