Hvala za povratne informacije.

Kako uporabljamo format JWE

V tem razdelku je opisano, kako pričakujemo, da bo JWE ustvarjen kot vhod v naprave, tako da lahko ustvarite lastno orodje za ustvarjanje blobov iz potrdil in ključev.

Glejte spletno šifriranje JSON (JWE) https://datatracker.ietf.org/doc/html/rfc7516 in spletni podpis JSON (JWS) https://datatracker.ietf.org/doc/html/rfc7515.

Za ustvarjanje JWE blobov uporabljamo kompaktno serializ acijo dokumenta JSON. Parametri, ki jih morate vključiti pri ustvarjanju blobov JWE, so:

• Glava JOSE (zaščitena). V glavo za podpisovanje in šifriranje predmetov JSON MORATE vključiti naslednje pare ključ-vrednost:

  • »alg« :"dir«

    Neposredni algoritem je edini, ki ga podpiramo za šifriranje koristnega obremenitve, zato morate uporabiti začetno skrivnost odjemalca naprave.

  • »enc« :"A128GCM« ali »enc« :"A256GCM«

    Podpiramo ta dva algoritma šifriranja.

  • »cisco-action«: »add« or »cisco-action«: »populate« or »cisco-action«: »aktiviraj« ali »cisco-action«: »deaktiviraj«

    To je lastniški ključ in štiri vrednosti, ki jih lahko sprejme. Ta ključ smo uvedli za signalizacijo namena šifriranih podatkov ciljni napravi. Vrednosti so poimenovane po ukazih XAPI v napravi, kjer uporabljate šifrirane podatke.

    Poimenovali smo ga cisco-action za ublažitev morebitnih spopadov s prihodnjimi razširitvami JWE.

  • »cisco-kdf«: {»version«: »1", »salt«: »base64URLENcodeDrandom4+bajtov«}

    Še en lastniški ključ. Vrednosti, ki jih navedete, uporabljamo kot vhode za izpeljavo ključev na napravi. Raz ličica mora biti 1 (različica naše funkcije izpeljave ključev). Vrednost soli mora biti zaporedje, kodirano z URL-om base64, vsaj 4 bajtov, ki ga morate izbrati naključno.

• JWE šifrirani ključ. To polje je prazno. Naprava ga izpelje iz začetnega Client Secret.

• Vektor inicializacije J WE. Za dešifriranje koristnega obremenitve morate navesti inicializacijski vektor, kodiran base64url. IV MORA biti naključna 12-bajtna vrednost (uporabljamo družino šifer AES-GCM, ki zahteva, da je IV dolg 12 bajtov).

• JWE AAD (dodatni overjeni podatki). To polje morate izpustiti, ker ni podprto v kompaktni serializaciji.

• JWE Ciphertext: To je šifrirani tovor, ki ga želite obdržati v skrivnosti.

  Tovor je lahko prazen. Na primer, če želite ponastaviti skrivnost odjemalca, jo morate prepisati s prazno vrednostjo.

  Obstajajo različne vrste koristnih obremenitev, odvisno od tega, kaj poskušate storiti v napravi. Različni ukazi XAPI pričakujejo različne uporabne obremenitve, namen uporabnega obremenitve pa morate določiti s ključem cisco- action, kot sledi:

  • Z »cisco-action« :"populate« je šifrirano besedilo novo Client Secret.

  • Z "»cisco-action« :"add« je šifrirano besedilo PEM blob s certifikatom in njegovim zasebnim ključem (povezanim).

  • Z "»cisco-action« :"activate« je šifrirano besedilo prstni odtis (šestnajstični prikaz sha-1) certifikata, ki ga aktiviramo za preverjanje identitete naprave.

  • Z "»cisco-action« :"deaktiviraj« je šifrirano besedilo prstni odtis (šestnajstični prikaz sha-1) potrdila, ki ga deaktiviramo za preverjanje identitete naprave.

• Oznaka za preverjanje pristnosti JWE: To polje vsebuje oznako za preverjanje celovitosti celotnega kompaktno serializiranega bloba JWE

Kako izpeljemo šifrirni ključ iz ClientSecret

Po prvi objavi skrivnosti skrivnosti ne sprejemamo ali izdajamo skrivnosti kot navadnega besedila. To je namenjeno preprečevanju morebitnih napadov slovarja s strani nekoga, ki bi lahko dostopal do naprave.

Programska oprema naprave uporablja skrivnost odjemalca kot vhod v funkcijo izpeljave ključev (kdf) in nato uporabi izpeljani ključ za dešifriranje/šifriranje vsebine v napravi.

To za vas pomeni, da mora vaše orodje za izdelavo blobov JWE slediti istemu postopku, da iz skrivnosti odjemalca izpelje isti ključ za šifriranje/dešifriranje.

Naprave uporabljajo scrypt za izpeljavo ključev (glej https://en.wikipedia.org/wiki/Scrypt) z naslednjimi parametri:

• CostFactor (N) je 32768

• BlocksizeFactor (r) je 8

• Faktor paralelizacije (p) je 1

• Sol je naključno zaporedje vsaj 4 bajtov; isto sol morate navesti pri določanju paramet ra cisco- kdf.

• Dolžine ključev so 16 bajtov (če izberete algoritem AES-GCM 128) ali 32 bajtov (če izberete algoritem AES-GCM 256)

• Največja zapora pomnilnika je 64 MB

Ta niz parametrov je edina konfiguracija scrypta, ki je združljiva s funkcijo izpeljave ključev na napravah. Ta kdf na napravah se imenuje »version« :"1", kar je edina različica, ki jo trenutno uporablja parameter ci sco-kdf.

Delan primer

Tu je primer, ki mu lahko sledite in preverite, ali vaš postopek šifriranja JWE deluje enako kot postopek, ki smo ga ustvarili v napravah.

Primer scenarija je dodajanje PEM bloba v napravo (posnema dodajanje potrdila z zelo kratkim nizom namesto celotnega ključa cert +). Skrivnost stranke v primeru je ossifrage.

1. Izberite šifro za šifriranje. Ta primer uporablja A128GCM (A ES s 128-bitnimi tipkami v načinu števca Galois). Vaše orodje lahko uporablja A256GCM, če želite.

2. Izberite sol (mora biti naključno zaporedje vsaj 4 bajtov). Ta primer uporablja (heksadestni bajti) E5 E6 53 08 03 F8 33 F 6. Base64URL kodira zaporedje, da dobite 5eztcap4 m_y (odstranite podlogo base64).

3. Tu je vzorec scrypt klica za ustvarjanje ključa za šifriranje vsebine (cek):

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

   Izpeljani ključ mora biti 16 bajtov (hex), kot sledi: 95 9e ba 6d d1 22 01 05 78 fe 6a 9d 22 78 ff ac, ki base64url kodira na LZ66bdeiAQV4_MQDINj_RA.

4. Izberite naključno zaporedje 12 bajtov, ki ga boste uporabili kot inicializacijski vektor. Ta primer uporablja (hex) 34 b3 5d dd 5f 53 7b af 2d 92 95 83, ki base64url kodira na nlnd3v9te68tkpwd.

5. Ustvarite glavo JOSE s kompaktno serializacijo (sledite istemu vrstnemu redu parametrov, ki jih uporabljamo tukaj) in jo nato base64url kodirajte:

   {"alg« :"dir«, "cisco-action« :"add«, "cisco-kdf«: {"salt« :"5eZtCap4M_Y«, "version« :"1"}, "enc« :"A128GCM "}

   Base64url kodirana glava JOSE je eyJHBgCioijKaxiilCjjaXnjBy1hy3rpb24ioIJhZgQiLcJjaXnjBy1rZGYionsic2fsdci6ijvlwlrdqva0tv9ziiwidmvyc2lvbii6IJeifswizw5jiJoiqTeyoeddtsj9

   To bo prvi element JWE bloba.

6. Drugi element JWE bloba je prazen, ker ne dobavljamo šifrirnega ključa JWE.

7. Tretji element JWE bloba je inicializacijski vektor NLND3v9TE68tkpwd.

8. Uporabite svoje orodje za šifriranje JWE za ustvarjanje šifrirane nosilnosti in oznake. V tem primeru bo nešifrirana nosilnost ponarejena PEM blob, to je datoteka PEM

   Parametri šifriranja, ki jih morate uporabiti, so:

   • Uporabna obremenitev je to datoteka PEM

   • Šifrirna šifra je AES 128 GCM

   • Base64url je kodiral GLAVO JOSE kot dodatne avtentificirane podatke (AAD)

   Base64URL kodira šifrirano koristno tovor, kar naj bi imelo za posledico F5LLvUWnfkfmZYCO1yjfodhq

   To je četrti element (JWE Ciphertext) v JWE blobu.

9. Base64URL kodira oznako, ki ste jo ustvarili v koraku 8, kar naj bi imelo za posledico PE-wdfwgxffbeo928cfz1q

   To je peti element v JWE blobu.

10. Združite pet elementov JWE bloba s pikami (JoseHeader.. iv.CipherText.tag), da dobite:

    EYJHBgCioIJkaXiilCjJAxNjBy1Hy3Rpb24ioIJhZgQiLcJjaXnjBy1rZgYionsIC2fSDCI6IJvLwlRdqVA0TV9ziiwidmvyc2lVBii6IJeifswizw5JiJoiqteYoeddtsJ.. 9nLnd3v9te68tkpwd.f5llvUVud.f5lLvUVuDd FKFmZyCO1yJFODHQ.PE-WDFWGXFFBEO928CFZ1Q

11. Če ste z lastnimi orodji izpeljali enake vrednosti, kodirane z base64url, kot jih prikazujemo tukaj, ste jih pripravljeni uporabiti za zaščito šifriranja E2E in preverjene identitete vaših naprav.

12. Ta primer dejansko ne bo deloval, načeloma pa bi bil vaš naslednji korak uporaba JWE bloba, ki ste ga ustvarili zgoraj, kot vhod v ukaz xv na napravi, ki doda potrdilo:

    XCommand varnostna potrdila Dodaj EyjHBGCioIJkAxiilCJJAxnjby1hy3rpb24ioijhzgQiLcJjaXnjBy1rZgYionsIC2fSDCI6IJvLwlRdQVA0tv9ziiwidmvyc2lvbii6IJeifswizw5JiJoiQTeYoEdDTsJ.. 9nLnd3v9te68pwtkd.pwtkd.F5 LLvUWnfkfmZYCO1yJfodHq.PE-WdfWg XFFBEo928CFz1Q