Kód aláíró tanúsítványának használata

Ez a weboldal útmutatást nyújt az SSL.com használatához OV or EV kód aláíró tanúsítvány a Microsoft SignTool és SSL.com segítségével SSL Manager.

Ezek az utasítások feltételezik, hogy a kódaláíró tanúsítvány telepítve van, vagy hardveres jogkivonattal rendelkezik. Az eSigner platformot használó felhő alapú kódaláírással kapcsolatban tekintse meg a Áttekintés oldalon és ez a beiratkozási útmutató.

Ne feledje, hogy a hardver alapú OV és EV kód aláíró tanúsítványok esetében a privát kulcs csak a YubiKey FIPS USB tokenen létezik amit neked küldtek, és hogy a token csatolni kell a számítógépre, amelyet az alkalmazás aláírására használnak. A YubiKey FIPS tokennel rendelkező Windows felhasználóknak le kell tölteniük és telepíteniük kell a YubiKey Smart Card Minidriver mielőtt felhasználnák a tokenjüket.

OV és Az EV-kód aláíró tanúsítványokat nem szabad manuálisan telepíteni a számítógépre, ami konfigurációs problémákat okozhat. Az SSL-től YubiKeys-re szállított tanúsítványok további telepítés nélkül használhatók a YubiKey Smart Card Minidriver és összekapcsolja a tokent a számítógépével. Keresztül megrendelt tanúsítványok távoli igazolás a magánkulcsot tartalmazó eszközre (pl. YubiKey FIPS vagy más támogatott hardverre) kell letölteni és telepíteni, nem pedig a számítógép tanúsítványtárolójára.
Ha azt tervezi, hogy aláírja a Windows 10 illesztőprogramokat EV-kód aláíró tanúsítvánnyal, akkor ezt meg kell tennie Regisztráció a Windows Hardware Developer Programmal.
Az OV / IV vagy EV kód aláíró tanúsítvány Java-val történő használatával kapcsolatos útmutatásokat a következő oldalon találja Java kód aláírási útmutató.

Végrehajtható fájl aláírása a SignTool segítségével

felszerel Windows SDK és SignTool

A SignTool a csomag része Windows 10 SDK. A telepítés után a SignTool a következő helyen található:

C: \ Program Files (x86) \ Windows Kits \ 10 \ bin \ \ x64 \ signtool.exe

Rajt PowerShell

Indítása PowerShell parancsablakot a „Powershell” kifejezésre keresve a Rajt menüt, és kattintson az asztali alkalmazásra.

A Powershell egy parancssori felület a Windows alapszolgáltatásaihoz. Használhatja a SignTool végrehajtására és a kód aláírására.

EV-hez kód aláírásakor csatlakoztassa az USB tokent a számítógépéhez (ha még nem tette meg). Ha eSignert használ, telepítse eSigner Cloud Key Adapter

Ne feledje, hogy a privát kulcs csak az Ön számára elküldött USB-tokennél létezik a tokent hozzá kell csatolni az alkalmazás aláírására használt számítógépre. Ezt a lépést ki kell hagyni, ha OV-kód aláíró tanúsítványt használ.

Jel Végrehajtható

A végrehajtható fájl aláírásához a következő parancsot adja ki a Powershell ablakban. Ha eSigner felhőalapú aláírást használ a signtool.exe fájllal, feltétlenül telepítse eSigner CKA

. \ signtool.exe sign / fd sha256 / a "C: \ path \ to \ MyExecutable.exe"
  • A /fd opció kiválasztja az aláíráskor használandó összefoglaló algoritmust. A Windows 10 SDK, HLK, WDK és ADK buildek 20236 és újabb ezt az opciót aláíráskor be kell állítani. A biztonság érdekében az SHA256 ajánlott az SHA1 helyett.
  • A /a opció arra utasítja a SignTool-t, hogy automatikusan keresse meg a megfelelő kód aláíró tanúsítványt a végrehajtható fájlhoz.
  • Ha EV-kód aláíró tanúsítványt használ, akkor az USB-token PIN-kódját kéri. Ha segítségre van szüksége a PIN-kód megtalálásában, kérjük, olvassa el a következőt: ez a hogyan.Írja be a PIN-kódot
Jegyzet: Ha olyan kódfájlokat ír alá, amelyek egy telepítőbe kerülnek (például egy Windows MSI fájlba), akkor a telepítő felépítése előtt ezeket a fájlokat alá kell írnia, majd magát a telepítő fájlt is alá kell írnia.

Aláírási tanúsítvány kiválasztása

Adja meg a Tárgy nevét

Ha egynél több kód van aláírva az USB tokenekhez vagy tanúsítványokhoz, akkor ezt megteheti adja meg a tanúsítványt használni szeretné, ha belefoglalja a Tárgy neve keresztül /n opciót.

Az EV CS tanúsítvány Tárgynevét a Microsoft tanúsítványkezelő eszközével találhatja meg certmgr. Nyissa meg az eszközt a Start menüből, és keresse meg az EV CS tanúsítványát a „Személyes” mappában, a „Tanúsítványok” részben, az alábbi képen látható módon. A Tárgy neve a „Kiadva” mező a certmgr-ben.

A fenti képen a tanúsítvány Tárgy neve van example. Megadhatja ezt az értéket a SignTool alkalmazásban a következő paranccsal.

. \ signtool.exe sign / fd sha256 / n "példa" "C: \ path \ to \ MyExecutable.exe"

Adja meg az SHA1 Hash értéket

Ha több tanúsítványa van ugyanazzal a Tárgynévvel, akkor az igazolás SHA1 kivonatát (vagy „ujjlenyomatát”) is felhasználhatja az aláíráshoz. Cserélje ki THUMBPRINT az alábbi parancsban az aktuális SHA1 kivonatolással. Ezt az értéket a certmgr tanúsítvány részleteinek megtekintésével és az Thumbprint mező (mindenképpen távolítsa el a szóközöket az ujjlenyomatból, mielőtt felhasználná a parancsban).

. \ signtool.exe sign / fd sha256 / sha1 THUMBPRINT "C: \ elérési út a \ MyExecutable.exe fájlhoz"

Használjon PKCS # 12 / PFX fájlt

Ha van egy kód-aláíró tanúsítvány és egy magánkulcs egy PKCS # 12 fájlban (más néven PFX vagy P12 fájl), akkor megadhatja a fájlt és annak jelszavát a parancssorban:

. \ signtool.exe sign / fd sha256 / f "C: \ path \ to \ MyCertificate.pfx" / p jelszó "C: \ path \ to \ MyExecutable.exe"

Időbélyegzés

A kód időbélyegzése lehetővé teszi, hogy megbízható legyen a kód-aláíró tanúsítvány lejárta után. Ha hozzá akar adni egy időbélyeg az aláírt bináris fájlban a SignTool's segítségével teheti meg /tr opció, amelyet az időbélyeg-kivonat algoritmus beállításával kell követni /td. Az alábbi kódrészletben szereplő parancs tartalmaz egy időbélyeget SSL.comidőbélyegző szolgáltatása futtatható fájl aláírása közben.

. \ signtool.exe jel / fd sha256 / tr http://ts.ssl.com / td sha256 / a "C: \ elérési út a \ MyExecutable.exe fájlhoz"
Jegyzet: Ügyeljen arra, hogy a SignTool programot használja /tr opció (adja meg az RFC 3161 időbélyegző-kiszolgáló URL-jét), nem /t (Az időbélyegző kiszolgáló URL-je), amely nem kompatibilis az SSL.com időbélyegző szerverével.
Jegyzet: A /td lehetőségek kell Kövesd a /tr választási lehetőség. Ha az időbélyeg-összefoglaló algoritmust az időbélyeg-kiszolgáló előtt adják meg, akkor az alapértelmezett SHA-1 algoritmust kell használni. A Windows 10 SDK, HLK, WDK és ADK buildek 20236 és újabb használatát megkövetelik /tr amikor az időbélyeget. Az SHA256 használata az SHA1 felett ajánlott a biztonság érdekében.
Jegyzet: Alapértelmezés szerint az SSL.com támogatja az ECDSA kulcsokból származó időbélyegeket.

Ha ezt a hibát tapasztalja: The timestamp certificate does not meet a minimum public key length requirement, vegye fel a kapcsolatot a szoftver szállítójával, hogy engedélyezze az időbélyegeket az ECDSA-kulcsokból.

Ha a szoftvergyártó nem tudja engedélyezni a normál végpont használatát, használhatja ezt a régi végpontot. http://ts.ssl.com/legacy hogy időbélyeget kapjon egy RSA időbélyegző egységtől.

Egyéb beállítások

További fontos SignTool lehetőségek:

  • /d: Adja hozzá az aláírt kód leírását. Például, /d "test code".
  • /du: URL hozzáadása az aláírt kód kibővített leírásával. Például, /du https://your_website.tld/project/description.

Az összes fenti lehetőség használata (de kihagyása /a, /sha1vagy /f mert a tanúsítvány Tárgynevét azzal adjuk meg /n, parancssorunk így néz ki:

signtool.exe sign / n "example" / fd sha256 / tr http://ts.ssl.com / td sha256 / d "test code" / du https: //y_webhely.tld/project/description "C: \ path \ to \ MyExecutable.exe "

Ellenőrizze az aláírást

Ezzel a paranccsal ellenőrizheti az aláírt kódot (vegye figyelembe, hogy a /pa opciónak jelen kell lennie a parancsban):

. \ signtool.exe ellenőrizze / pa "C: \ path \ to \ MyExecutable.exe"

Ha a fájlodat sikeresen aláírták, akkor a következő kimenetet kell látnia:

Fájl: C: elérési út MyExecutable.exe index algoritmus időbélyegzőjéhez =================================== ===== 0 sha256 RFC3161 Sikeresen ellenőrizve: C: \ path \ to \ MyExecutable.exe

Azt is ellenőrizheti, hogy egy fájlt aláírtak-e, ha jobb gombbal kattint az ikonjára, és kiválasztja Ingatlanok a menüből, majd válassza a Digitális aláírások fülre. Az aláírás részleteinek megtekintéséhez válassza ki azt, majd kattintson a gombra Részletek gombot.

Digitális aláírások

Itt láthatjuk, hogy a fájl érvényes digitális aláírást tartalmaz, amelyet az SSL Corp készített 28. június 2020-án.

Digitális aláírás részletei

Végrehajtható fájl aláírása a SSL Manager

Ha inkább egy grafikán alapuló megközelítést szerez, akkor ezt használhatja SSL.comházon belüli szoftvere, SSL Manager, hogy aláírja a fájljait. Sok ügyfél inkább használja SSL Manager mert további előnye, hogy egyszerűen hozzáférhet minden tanúsítványhoz egy egységes felületen. A letöltésre és a telepítésre vonatkozó utasításokat SSL Manager, kérjük, olvassa el a Telepítési útmutató.

Futtatható fájl aláírásához kezdje a kiválasztással Kód aláírás> Jel és időbélyegző kódcsomag ból ből SSL Managermenüje.

Sign & Timestamp kódcsomag

A kód aláírási űrlapon kiválaszthatja a végrehajtható és a kód aláíró tanúsítványt (akár fájlból, akár egy igazolástárolóból) és az elérhető időbélyegző-kiszolgálók egyikét. Ha kész, kattintson a gombra Jel gombra a kód aláírásához. Ha PFX fájlból tölt be tanúsítványt, meg kell adnia a fájl jelszavát. Ha EV kód aláíró tanúsítványt használ, akkor a rendszer kéri az USB token PIN kódját.

A kód aláírása mellett SSL Manager számos nagyteljesítményű funkciót kínál. További részletek: SSL Managerdokumentációja, különösen a Kód aláírás menü.

Köszönjük, hogy az SSL.com-t választotta! Ha bármilyen kérdése van, kérjük lépjen kapcsolatba velünk e-mailben a címen Support@SSL.com, hívás 1-877-SSL-SECURE, vagy kattintson az oldal jobb alsó sarkában található csevegési linkre.

Feliratkozás az SSL.com hírlevelére

Ne hagyja ki az SSL.com új cikkeit és frissítéseit

Legyen tájékozott és biztonságos

SSL.com világelső a kiberbiztonság területén, PKI és digitális tanúsítványok. Iratkozzon fel, hogy megkapja a legújabb iparági híreket, tippeket és termékbejelentéseket SSL.com.

Örülnénk a visszajelzésének

Töltse ki felmérésünket, és ossza meg velünk véleményét legutóbbi vásárlásával kapcsolatban.