Microsoft Azure / Blob Storage

Zde najdete postup, jak bezpečně nahrávat datové soubory do cloudového úložiště Microsoft Azure Blob Storage prostřednictvím sdíleného přístupového podpisu.

Tato nápověda popisuje, jak nahrávat XML soubory do cloudového úložiště Azure Blob Storage pomocí tzv. sdíleného přístupového podpisu (SAS). Tato metoda se používá např. při přenosu dat mezi partnery a umožňuje jak manuální nahrání dat, tak i jejich automatizaci pomocí příkazového řádku.

Konkrétní přístupové údaje (např. adresa Blob Storage nebo SAS token) nejsou z bezpečnostních důvodů v této nápovědě uvedeny. V případě potřeby vám je zašleme na vyžádání.

Co je sdílený přístupový podpis (SAS)?

Sdílený přístupový podpis (anglicky Shared Access Signature, zkráceně SAS) je zabezpečený způsob, jak dočasně zpřístupnit určitou část úložiště v Azure bez nutnosti znát přístupové údaje k celé službě.

• Nejčastěji se používá pro přístup ke konkrétnímu kontejneru nebo souborům.

• SAS token je platný pouze po omezenou dobu (např. 1 rok).

• Přístup může být omezen jen na určité operace (čtení, zápis, mazání atd.).

---

Manuální nahrání přes Azure Storage Explorer

Pro jednoduché a přehledné nahrávání doporučujeme využít aplikaci Azure Storage Explorer, která je dostupná pro Windows, macOS i Linux.

Postup:

1. Stáhněte si aplikaci z oficiálního webu: https://azure.microsoft.com/cs-cz/products/storage/storage-explorer

2. Spusťte aplikaci Azure Storage Explorer.

3. Na úvodní obrazovce klikněte na možnost Attach to a resource a potvrďte stiskem Next (další). (Tato volba umožňuje připojení bez nutnosti přihlášení k Azure účtu.)

4. V dalším kroku vyberte jako zdroj, ke kterému se chcete připojit Blob container or directory.

5. Zvolte metodu připojení Shared access signature URL (SAS).

6. Do příslušného pole zadejte Display name - libovolný název pro připojení, který slouží pro rozpoznání připojeného úložiště (například: moje firma-XML-storage).

7. Do příslušného pole vložte obdržený SAS URI – jedná se o kompletní URL adresu kontejneru včetně SAS tokenu (začíná např. https://...blob.core.windows.net/ ) a potvrďte.

8. Zobrazí se souhrn (Summary), kde klikněte na Connect (Připojit).

9. Nyní se zobrazí kontejner s otevřenou cílovou složku s názvem, který jste zadali v kroku 5.

10. Nyní můžete jednoduše přetáhnout soubory (např. soubor.xml) do do okna složky kontejneru metodou „drag & drop“.

---

Alternativní možnost: Nahrání z příkazového řádku (curl)

Pro technicky zdatnější uživatele nebo při práci na serveru je možné nahrát soubor i pomocí příkazu curl.

Příklad:

bashZkopírovatUpravitcurl curl -X PUT -T soubor.xml \
  -H "x-ms-date: $(date -u)" \
  -H "x-ms-blob-type: BlockBlob" \
  "https://<blob-storage-url>/nazev-kontejneru/userData/soubor.xml?<sas-token>"

• soubor.xml nahraďte názvem svého souboru.

• userData/ je složka v rámci kontejneru (může se lišit podle pokynů).

• <blob-storage-url> a <sas-token> obdržíte od nás.

Na Windows si můžete stáhnout curl z oficiálních stránek: https://curl.se/windows/

---

Co se stane po nahrání souboru?

Po úspěšném nahrání XML souboru může být v systému Retailys spuštěn automatizovaný proces importu dat, který je aktivován tzv. triggerem – tedy automatickou událostí při nahrání nového souboru.

Tento mechanismus zajišťuje rychlý a bezpečný přenos a zpracování dat bez potřeby manuálního zásahu.