Androidin koodin allekirjoittaminen

Tässä artikkelissa käsitellään Android (APK) -koodin allekirjoitusta. Sovelluksen Android-allekirjoitus on tehtävä, jos Android on valittu yhdeksi ympäristöksi paketointiprojektia luotaessa ja muodostettaessa.

Tietokoneen valmisteleminen

Aloittamista varten tarvitaan seuraavat tiedot:

• Android Studio -asennus
• OpenSSL-asennus

Avaimien luonti

Käytämme tiedostoa keytool.exe (saatavana Android Studio asennuksen jälkeen kansiosijainnista "Drive:\Program Files\Android\Android Studio\jre\bin\keytool.exe") varmenteen luomiseksi sovelluspaketin allekirjoitusta varten. Keytool-komennolla hallitaan salausavaimien, X.509-varmenneketjujen ja luotettavien varmenteiden avainsäilöä (tietokantaa).

Avain luodaan avaamalla komentokehot ja suorittamalla seuraava komento:

keytool -genkey -alias SIGNATURE_ALIAS -keyalg RSA -keystore PATH_TO_KEYSTORE -keysize 2048 -validity 10000

Parametrit:

• genkey – avaimen luontikomento.
• alias – ilmaisee aliaksen, jolla viitataan jatkossa luotavat avaimet sisältävään avainsäilömerkintään.
• keyalg – avainalgoritmin nimi.
• keystore – käytettävän avainsäilön nimi.
• keysize – kunkin luotavan avaimen koko.
• validity – avaimen voimassaoloaika päivinä.

Esimerkki:

• Key Vault -säilöä valmisteltaessa PATH_TO_KEYSTORE-arvossa oltava .pfx-tunniste.

  keytool -genkey -alias powerappswrap -keyalg RSA -keystore powerappswrap.pfx -keysize 2048 -validity 10000

• Jos valmistelet manuaalista allekirjoitusta, PATH_TO_KEYSTORE:lla tulisi olla .jks-tunniste.

  keytool -genkey -alias powerappswrap -keyalg RSA -keystore powerappswrap.jks -keysize 2048 -validity 10000

Allekirjoituksen hajautusarvon luominen

Avaimen luonnin jälkeen avainsäilövarmenne viedään keytool-komennon exportcert-komennolla.

keytool -exportcert -alias SIGNATURE_ALIAS -keystore PATH_TO_KEYSTORE | openssl sha1 -binary | openssl base64

Parametrit:

• exportcert – Lukee avainsäilöstä aliakseen liitetyn varmenteen ja tallentaa sen cert_file-tiedostoon. Jos tiedostoa ei ole määritetty, varmenteen tulos on stdout.
• alias – alias, jota käytettiin aiemmin avaimia luotaessa.
• keystore – käytettävän avainsäilön nimi.
• openssl – luo Android SHA1-avaimen.

Lisää luotu allekirjoituksen hajautusarvo Uudelleenohjaukseen URI -osoitteeseen sovellusta rekisteröitäessä.

SHA1-heksadesimaalikoodin muuntaminen Base64-koodatuksi allekirjoituksen hajautusarvoksi manuaalisesti

Jos allekirjoituksen hajautusarvoa ei ole koodattu oikein tai sitä ei hyväksytä Azure-portaalissa, saatat nähdä seuraavan virheen:

"Allekirjoituksen hajautusarvon on oltava Base64-koodattu SHA1."

Kun tämä virhe tulee näkyviin, yritä luoda allekirjoituksen hajautusarvo sen sijaan käyttämällä näitä vaiheita:

1. Luetteloi varmenteen tiedot selväsanaisesti suorittamalla keytool -list -v -alias SIGNATURE_ALIAS -keystore PATH_TO_KEYSTORE.
2. Kopioi tulosteen Varmenteen sormenjäljet-osan SHA1-arvo. Varmista, että kopioit vain heksadesimaaliarvon.
   Esimerkki: EF:11:45:3D:F1:72:D9:8C:43:32:CD:0A:49:C2:E4:75:2D:B3:2D:9F
3. Käytä mitä tahansa käytettävissä olevaa heksadesimaali-Base64-muunninta muuntaaksesi kopioidun varmenteen sormenjäljen heksadesimaaliarvon Base64-koodatuksi arvoksi.
   Esimerkki Base64-koodatusta arvosta: 8CPPeLaz9etdqQyaQubcqsy2Tw=
4. Kopioi luotu Base64-koodattu arvo Azure-portaaliin Allekirjoituksen hajautusarvona sovelluksen rekisteröinnin yhteydessä.

APK-paketin allekirjoittaminen

APK-paketin allekirjoittamiseen käytetään apksigner-työkalua. Sen avulla voidaan allekirjoittaa APK-paketit ja varmistaa, että APK-pakettien allekirjoituksen vahvistaminen onnistuu kaikissa APK-pakettien tukemissa Android-ympäristöissä.

apksigner-tiedoston etsiminen

1. Tarkista Android SDK -polku Android Studio.

2. Valitse Työkalu > SDK-hallinta > Android SDK -sijainti.

   Jos käytössä on iOS, apksigner-tiedoston voi tarkistaa buildTools Version -hakemistossa:

   Valitse SDK-hakemisto > build-tools > buildToolsVersion > lib ja tarkista apksigner.jar-tiedosto

apksigner-tiedoston käyttäminen

Käytä apksigner-työkalua ja allekirjoita paketti suorittamalla seuraava komento:

apksigner.bat sign --ks PATH_TO_KEYSTORE --ks-key-alias KEY_ALIAS PATH_TO_APK

Parametrit:

• ks – avainsäilön polku.
• ks-key-alias – avainaliaksen polku APK-tiedostoon.

Anna salasana pyydettäessä.

Lisätietoja: Android Studio komentorivityökalut: apksigner

Sovelluksen jakelu

Pakettia voi isännöidä jakelupalvelussa, kuten App Centerissä. Lisätietoja jakelusta Microsoft Intunen avulla on kohdassa Android-toimialasovelluksen lisääminen Microsoft Intuneen. Lisätietoja Intune-sovelluksen suojauspalvelun käyttöoikeuksien antamisesta sovellukselle: Anna sovellukselle käyttöoikeudet Intune-sovelluksen suojauspalveluun.

Katso myös

• Paketoinnin yleiskatsaus
• APK-paketin manuaalinen allekirjoittaminen – Xamarin
• iOSin koodin allekirjoittaminen