Ďakujeme za vašu spätnú väzbu.

Ako používame formát JWE

Táto časť popisuje, ako očakávame, že JWE bude vytvorený ako vstup do zariadení, aby ste si mohli vytvoriť vlastný nástroj na vytváranie blobov z vašich certifikátov a kľúčov.

Pozrite si webové šifrovanie JSON (JWE) https://datatracker.ietf.org/doc/html/rfc7516 a webový podpis JSON (JWS) https://datatracker.ietf.org/doc/html/rfc7515.

Na vytvorenie blobov JWE používame kompaktnú serializ áciu dokumentu JSON. Parametre, ktoré musíte zahrnúť pri vytváraní blobov JWE, sú:

• Hlavička JOSE (chránená). V hlavičke podpisovania a šifrovania objektu JSON MUSÍTE zahrnúť nasledujúce páry kľúč-hodnota:

  • „alg“ :"rež“

    Priamy algoritmus je jediný, ktorý podporujeme na šifrovanie užitočného zaťaženia, a musíte použiť počiatočné klientske tajomstvo zariadenia.

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

    Podporujeme tieto dva šifrovacie algoritmy.

  • „cisco-action“: „pridať“ alebo „cisco-action“: „vyplniť“ alebo „cisco-action“: „aktivovať“ alebo „cisco-action“: „deaktivovať“

    Toto je vlastný kľúč a štyri hodnoty, ktoré môže mať. Tento kľúč sme zaviedli na signalizáciu účelu šifrovaných údajov cieľovému zariadeniu. Hodnoty sú pomenované podľa príkazov XAPI v zariadení, kde používate šifrované údaje.

    Nazvali sme to cisco-action na zmiernenie potenciálnych konfliktov s budúcimi rozšíreniami JWE.

  • „cisco-kdf“: {„version“: „1", „salt“: „base64URLENcodeDrandom4+bajtov“}

    Ďalší proprietárny kľúč. Hodnoty, ktoré poskytnete, používame ako vstupy na odvodenie kľúčov na zariadení. Verzia musí byť 1 (verzia našej funkcie odvodenia kľúčov). Hodnota soli musí byť sekvencia kódovaná base64 URL s minimálne 4 bajtmi, ktorú musíte vybrať náhodne.

• JWE šifrovaný kľúč. Toto pole je prázdne. Zariadenie ho odvodzuje od počiatočného Client Secret.

• Inicializačný vektor JWE. Na dešifrovanie užitočného zaťaženia musíte poskytnúť inicializačný vektor kódovaný base64url. IV MUS Í byť náhodná 12-bajtová hodnota (používame rodinu šifrov AES-GCM, ktorá vyžaduje, aby bol IV dlhý 12 bajtov).

• JWE AAD (dodatočné overené údaje). Toto pole musíte vynechať, pretože nie je podporované v kompaktnej serializácii.

• JWE Ciphertext: Toto je šifrované užitočné zaťaženie, ktoré chcete zachovať v tajnosti.

  Užitočné zaťaženie môže byť prázdne. Napríklad, ak chcete obnoviť tajomstvo klienta, musíte ho prepísať prázdnou hodnotou.

  Existujú rôzne typy užitočných nákladov v závislosti od toho, čo sa snažíte na zariadení urobiť. Rôzne príkazy XAPI očakávajú rôzne užitočné zaťaženie a účel užitočného zaťaženia musíte zadať pomocou kľúča cisco- action nasledovne:

  • S „cisco-action“ :"vyplniť“ je šifrovaný text novým Client Secret.

  • S "„cisco-action“ :"add“ je šifrovaný text PEM blob s certifikátom a jeho súkromným kľúčom (spojený).

  • Pomocou "„cisco-action“ :"aktivovať“ je šifrovaný text odtlačok prsta (hexadecimálne znázornenie sha-1) certifikátu, ktorý aktivujeme na overenie identity zariadenia.

  • S "„cisco-action“ :"deaktivovať“ je šifrovaný text odtlačok prsta (hexadecimálne znázornenie sha-1) certifikátu, ktorý deaktivujeme na overenie identity zariadenia.

• JWE overovacia značka: Toto pole obsahuje autentifikačnú značku na zistenie integrity celého kompaktne sérializovaného blobu JWE

Ako odvodíme šifrovací kľúč z ClientSecret

Po prvom vyhlásení tajomstva tajomstvo neprijímame ani nevypíšeme ako obyčajný text. To má zabrániť potenciálnym útokom slovníka niekoho, kto by mohol pristupovať k zariadeniu.

Softvér zariadenia používa tajomstvo klienta ako vstup do funkcie odvodenia kľúča (kdf) a potom používa odvodený kľúč na dešifrovanie/šifrovanie obsahu v zariadení.

To pre vás znamená, že váš nástroj na výrobu blobov JWE musí postupovať rovnakým postupom na odvodenie rovnakého šifrovaní/dešifrovacieho kľúča z tajomstva klienta.

Zariadenia používajú scrypt na od vodenie kľúčov (pozri https://en.wikipedia.org/wiki/Scrypt) s nasledujúcimi parametrami:

• CostFactor (N) je 32768

• BlocksizeFactor (r) je 8

• Paralelizačný faktor (p) je 1

• Soľ je náhodná sekvencia najmenej 4 bajtov; tú istú soľ musíte dodať pri zadá vaní parametra cisco-kdf.

• Dĺžka kľúčov je buď 16 bajtov (ak vyberiete algoritmus AES-GCM 128) alebo 32 bajtov (ak vyberiete algoritmus AES-GCM 256)

• Maximálny pamäťový kryt je 64 MB

Táto sada parametrov je jedinou konfiguráciou scryp tu, ktorá je kompatibilná s funkciou odvodenia kľúčov na zariadeniach. Tento kdf na zariadeniach sa nazýva „version“ :"1", čo je jediná verzia, ktorú momentálne používa parameter ci sco-kdf.

Pracovaný príklad

Tu je príklad, ktorý môžete sledovať a overiť, či váš proces šifrovania JWE funguje rovnako ako proces, ktorý sme vytvorili na zariadeniach.

Príkladom scenára je pridanie blobu PEM do zariadenia (napodobňuje pridanie certifikátu s veľmi krátkym reťazcom namiesto úplného klávesu cert +). Tajomstvo klienta v príklade je ossifrage.

1. Vyberte šifrovaciu šifru. Tento príklad používa A128GCM (A ES so 128-bitovými klávesmi v režime Galois Counter Mode). Váš nástroj by mohol používať A256GCM, ak chcete.

2. Vyberte soľ (musí byť náhodná sekvencia najmenej 4 bajtov). Tento príklad používa (šesťhranné bajty) E5 E6 53 08 03 F8 33 F 6. Base64URL kóduje sekvenciu, aby ste získali 5eztcap4 m_y (odstráňte polstrovanie base64).

3. Tu je ukážka scrypt volania na vytvore nie kľúča šifrovania obsahu (cek):

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

   Odvodený kľúč by mal byť 16 bajtov (hex) nasledovne: 95 9e ba 6d d1 22 01 05 78 fe 6a 9d 22 78 ff ac ktorý base64url kóduje na LZ66bdeiAQV4_MQDINJ_RA.

4. Vyberte náhodnú sekvenciu 12 bajtov, ktorú chcete použiť ako inicializačný vektor. Tento príklad používa (hex) 34 b3 5d dd 5f 53 7b af 2d 92 95 83, ktorý base64url kóduje na nlnd3v9te68tkpwd.

5. Vytvorte hlavičku JOSE s kompaktnou serializáciou (postupujte podľa rovnakého poradia parametrov, ktoré tu používame) a potom ju kódujte base64url:

   {"alg“ :"dir“, "cisco-action“ :"pridať“, "cisco-kdf“: {"salt“ :"5eZtCap4m_Y“, "verzia“ :"1"}, "enc“ :"A128GCM "}

   Záhlavička JOSE kódovaná base64url je eyJhbGCioIJkaxiilcjJAxnjby1hy3rpb24ioijhzgQiLcjJAxnjby1rzgyionsic2fsdci6IJvlwlrdqva0tv9ziiwidmvyc2lvbii6IJeifswizw5jiJoiqTeyoeddtsj9

   Toto bude prvý prvok blobu JWE.

6. Druhý prvok blobu JWE je prázdny, pretože neposkytujeme šifrovací kľúč JWE.

7. Tretím prvkom blobu JWE je inicializačný vektor NLND3v9TE68tkpwd.

8. Použite šifrovací nástroj JWE na vytvorenie šifrovaného užitočného zaťaženia a značky. V tomto príklade bude nešifrované užitočné zaťaženie falošným PEM blob, toto je súbor PEM

   Šifrovacie parametre, ktoré by ste mali použiť, sú:

   • Užitočné zaťaženie je toto je súbor PEM

   • Šifrovacia šifra je AES 128 GCM

   • base64url kódovala hlavičku JOSE ako dodatočné overené údaje (AAD)

   Base64URL kóduje šifrované užitočné zaťaženie, čo by malo mať za následok f5llvUWnfkfmzyCO1yjfodhq

   Toto je štvrtý prvok (JWE Ciphertext) v blobe JWE.

9. Base64URL kóduje značku, ktorú ste vytvorili v kroku 8, čo by malo mať za následok PE-wdfwgxffbeo928cfz1q

   Toto je piaty prvok v blobe JWE.

10. Spojte päť prvkov blobu JWE s bodkami (JoseHeader.. iv.CipherText.tag) a získajte:

    EYJHBgCioIJkaXiilCjJAxNjBy1hY3Rpb24ioIJhZgQiLcJjaXnjBy1rZgYionsIC2fSDCI6IJvLwlRdqVA0TV9ziiwidmvyc2lVBii6IJeifswizw5JiJoiqTeyoeddtsJ.. 9nlnd3v9te68tkpwd.f5llvUVuUD.f5llvUVuNd FKFmZyCO1yJFODHQ.PE-WDFWGXFFBEO928CFZ1Q

11. Ak ste pomocou vlastných nástrojov odvodili rovnaké hodnoty kódované base64url, ako tu zobrazujeme, ste pripravení ich použiť na zabezpečenie šifrovania E2E a overenej identity vašich zariadení.

12. Tento príklad v skutočnosti nebude fungovať, ale v zásade by vaším ďalším krokom bolo použiť JWE blob, ktorý ste vytvorili vyššie, ako vstup do príkazu xcommand na zariadení, ktoré pridáva certifikát:

    Bezpečnostné certifikáty XCommand Pridajte EyjHBGCioIJkaxiilCjJAxnjBy1hy3rpb24ioijhzgQiLcJjaXnjBy1rZgYionsIC2FSDCI6IJvLwlRdQVA0TV9ziiwidmVYc2LVbii6IJeifswizw5JiJoiQTeYoeddtsJ.. 9nLnd3v9TE68PWtkD.pWtkd.F5 LLvUWnfKfMZYCO1yJFODHQ.PE-WDFWG XFFBEO928CFz1Q