Děkujeme za vaši zpětnou vazbu.

Jak používáme formát JWE

Tato část popisuje, jak očekáváme vytvoření JWE jako vstup do zařízení, abyste si mohli vytvořit svůj vlastní nástroj pro vytváření objektů blob z vašich certifikátů a klíčů.

Viz webové šifrování JSON (JWE) https://datatracker.ietf.org/doc/html/rfc7516 a webový podpis JSON (JWS) https://datatracker.ietf.org/doc/html/rfc7515.

K vytváření objektů blob JWE používáme kompaktní serializaci dokumentu JSON. Parametry, které musíte zahrnout při vytváření objektů blob JWE, jsou:

• Záhlaví JOSE (chráněno). V záhlaví JSON Object Signing and Encryption MUSÍTE zahrnout následující páry klíč-hodnota:

  • „alg“ :"adresář“

    Přímý algoritmus je jediný, který podporujeme pro šifrování užitečného zatížení, a musíte použít počáteční klientské tajemství zařízení.

  • „enc“ :"A128GCM“ nebo „enc“: „A256GCM“

    Podporujeme tyto dva šifrovací algoritmy.

  • „cisco-action“: „přidat“ nebo „cisco-action“: „naplnit“ nebo „cisco-action“: „aktivovat“ nebo „cisco-action“: „deaktivovat“

    Toto je proprietární klíč a čtyři hodnoty, které může mít. Zavedli jsme tento klíč, abychom signalizovali účel šifrovaných dat cílovému zařízení. Hodnoty jsou pojmenovány podle příkazů xAPI v zařízení, kde používáte šifrovaná data.

    Pojmenovali jsme to cisco-action, abychom zmírnili potenciální střety s budoucími rozšířeními JWE.

  • „cisco-kdf“: {„version“: „1", „salt“: „base64UrlenCodeDrandom4+bajty“}

    Další proprietární klíč. Hodnoty, které zadáte, používáme jako vstupy pro odvození klíčů na zařízení. Verze musí být 1 (verze naší funkce odvození klíčů). Hodnota soli musí být base64 URL kódovaná sekvence alespoň 4 bajtů, kterou musíte zvolit náhodně.

• Šifro@@ vaný klíč JWE. Toto pole je prázdné. Zařízení jej odvozuje od počátečního ClientSecret.

• Inici@@ alizační vektor JWE. Pro dešifrování užitečného zatížení musíte zadat inicializační vektor zakódovaný base64url. IV MUSÍ být náhodná hodnota 12 bajtů (používáme rodinu šifra AES-GCM, která vyžaduje, aby IV měl délku 12 bajtů).

• JWE AAD (další ověřená data). Toto pole musíte vynechat, protože není podporováno v kompaktní serializaci.

• JWE Ciphertext: Toto je šifrované užitečné zatížení, které chcete udržet v tajnosti.

  Užitečné zatížení může být prázdné. Chcete-li například resetovat tajemství klienta, musíte jej přepsat prázdnou hodnotou.

  Existují různé typy užitečného zatížení v závislosti na tom, co se snažíte na zařízení udělat. Různé příkazy xAPI očekávají různá užitečná zatížení a je nutné zadat účel užitečného zatížení pomocí klíče cisco-action následujícím způsobem:

  • S „cisco-action“ :"naplate“ je šifrovaný text novým Cli entSecret.

  • S "„cisco-action“ :"add“ je šifrovaný text blob PEM nesoucí certifikát a jeho soukromý klíč (zřetězený).

  • U "„cisco-action“ :"activate“ je šifrovaný text otiskem prstu (hexadecimální reprezentace sha-1) certifikátu, který aktivujeme pro ověření identity zařízení.

  • Při "„cisco-action“ :"deaktivaci“ je šifrovaný text otiskem prstu (hexadecimální reprezentace sha-1) certifikátu, který deaktivujeme, aby byl použit pro ověření identity zařízení.

• Ověřovací značka JWE: Toto pole obsahuje ověřovací značku pro zjištění integrity celého kompaktně serializovaného objektu blobu JWE

Jak odvozujeme šifrovací klíč z ClientSecret

Po první populaci tajemství nepřijímáme ani nevydáváme tajemství jako prostý text. Tím se zabrání potenciálním slovníkovým útokům někoho, kdo by mohl přistupovat k zařízení.

Software zařízení používá klientské tajemství jako vstup do funkce odvození klíče (kdf) a poté použije odvozený klíč pro dešifrování/šifrování obsahu v zařízení.

To pro vás znamená, že váš nástroj pro vytváření objektů blob JWE musí postupovat stejným postupem, aby odvodil stejný šifrování/dešifrovací klíč z klientského tajemství.

Zařízení používají k odvození klíčů scrypt (viz https://en.wikipedia.org/wiki/Scrypt) s následujícími parametry:

• Nákladový faktor (N) je 32768

• Velikost blokuFactor (r) je 8

• ParalelizationFactor (p) je 1

• Salt je náhodná sekvence nejméně 4 bajtů; stejnou sůl musíte zadat při zadávání parametru cisco-kdf.

• Délka klíčů je buď 16 bajtů (pokud vyberete algoritmus AES-GCM 128), nebo 32 bajtů (pokud vyberete algoritmus AES-GCM 256)

• Maximální kapacita paměti je 64 MB

Tato sada parametrů je jedinou konfigurací scryptu, která je kompatibilní s funkcí odvození klíčů na zařízeních. Tento kdf na zařízeních se nazývá „version“ :"1", což je jediná verze aktuálně převzatá parametrem cisco-kdf.

Propracovaný příklad

Zde je příklad, který můžete sledovat, abyste ověřili, že váš proces šifrování JWE funguje stejně jako proces, který jsme vytvořili na zařízeních.

Příkladem scénáře je přidání blobu PEM do zařízení (napodobuje přidání certifikátu, s velmi krátkým řetězcem namísto úplného klíče cert +). Klientským tajemstvím v příkladu je ossifrage.

1. Vyberte šifrovací šifru. Tento příklad používá A128GCM (AES se 128bitovými klávesami v režimu počítadla Galois). Váš nástroj může použít A256GCM, pokud chcete.

2. Vyberte sůl (musí být náhodná sekvence nejméně 4 bajtů). Tento příklad používá (hexadecimální bajty) E5 E6 53 08 03 F8 33 F 6. Base64URL zakóduje sekvenci pro získání 5eztcap4 m_y (odstraňte polstrování base64).

3. Zde je ukázkové volání scrypt pro vytvoření šifrovacího klíče obsahu (cek):

   cek=scrypt(password="ossifrage", salt=4-byte-sequence, N=32768, r=8, p=1, keylength=16)

   Odvozený klíč by měl být 16 bajtů (hex) následovně: 95 9e ba 6d d1 22 01 05 78 fe 6a 9d 22 78 ff ac, který base64url kóduje do LZ66BDeiaqv4_mqdinj_ra.

4. Vyberte náhodnou sekvenci 12 bajtů, kterou chcete použít jako inicializační vektor. Tento příklad používá (hex) 34 b3 5d dd 5f 53 7b af 2d 92 95 83 které base64url kóduje do nLnd3v9te68tkpwd.

5. Vytvořte záhlaví JOSE s kompaktní serializací (postupujte podle stejného pořadí parametrů, které zde používáme) a poté base64url zakódujte:

   {"alg“ :"dir“, "cisco-action“ :"add“, "cisco-kdf“: {"salt“ :"5eztcap4M_y“, "verze“ :"1"}, "enc“ :"A128GCM "}

   Hlavička JOSE kódovaná base64url je EYJhbGcioIJkAxiiLcJjaXnJbY1hy3rpb24ioiJhzgqILcJjaXnjbY1rzGyionSiC2fsdCi6ijvLwLrdqVA0tV9ziiWIDmVyc2LvBii6iJiIFsWiZw5jiJoiqTeYoEddTSj9

   Toto bude první prvek JWE blobu.

6. Druhý prvek JWE blobu je prázdný, protože nedodáváme šifrovací klíč JWE.

7. Třetím prvkem JWE blobu je inicializační vektor nLND3v9TE68tkpwd.

8. Použijte svůj šifrovací nástroj JWE k vytvoření šifrovaného užitečného zatížení a značky. V tomto příkladu bude nešifrovaným užitečným zatížením falešný blok PEM, jedná se o soubor PEM

   Parametry šifrování, které byste měli použít, jsou:

   • Užitečné zatížení je toto je soubor PEM

   • Šifrovací šifra je AES 128 GCM

   • Záhlaví JOSE kódované base64url jako další ověřená data (AAD)

   Base64URL zakóduje šifrované užitečné zatížení, což by mělo vést k F5llVUWNfkfmzyco1yjfodhq

   Toto je čtvrtý prvek (JWE Ciphertext) v JWE blobu.

9. Base64URL zakóduje značku, kterou jste vytvořili v kroku 8, což by mělo vést k PE-wdfwgxffbeo928cfz1q

   Toto je pátý prvek v JWE blobu.

10. Zřetězte pět prvků blobu JWE tečkami (JoseHeader.. iv.CipherText.tag), abyste získali:

    EYJhbgCIoIJkAXiiLCJaxnjbY1hy3rpb24ioiJhzgQiLCJjaXnJbY1rZgyiOnSiC2fsdCi6ijVLrdQva0tV9ZiiWiDMvYc2LvBiI6iJeiFsWiZw5jiJoiqTeyOeddTSj.. 9nLnd3v9TE68pWlLd.f5tKf5tKlLd.9nLnd3v9TE68pWf5lld.pWf5tKf5tKlLd.9nLnd3v9TE68pWf5lld.pWf5tKf5tKlLd.9nLnd3V9TE68pWfVUWNfkfmzyco1yjfodhq.pe-wdfwgxffbeo928cfz1q

11. Pokud jste odvodili stejné hodnoty zakódované base64url, jaké zde zobrazujeme, pomocí vlastních nástrojů, jste připraveni je použít k zabezpečení šifrování E2E a ověřené identity vašich zařízení.

12. Tento příklad ve skutečnosti nebude fungovat, ale v zásadě by vaším dalším krokem bylo použít JWE blob, který jste vytvořili výše, jako vstup do příkazu xcommand na zařízení, které přidává certifikát:

    Cer@@ tifikáty zabezpečení XCommand Přidat eyJhbgCIoIJkAxiiLcJjaXnjbY1hy3rpb24ioiJhzgQiLCjJAxnjby1rzGYiOnSiC2fsdci6iJvLwLrdQva0tV9ZiiWiDMvYc2LvBii6iJEifsWiZw5jiJoiqTeyOeDDtSj.. 9nLnND3v9Tk68TkJ.. PW D.F5LLVUWNfkfmzyco1yjfodhq.pe-wdfwg xffbeo928cfz1q