Slide 1

Slide 1 text

リリース時までに知っておきたい署名まわりの話 mrtry 2022/01/19 1

Slide 2

Slide 2 text

自己紹介 とらい(@mrtry) Yamamoto Shinnosuke 株式会社JMDC Android / React Native 最近放送大学で心理学系をお勉強してる 2

Slide 3

Slide 3 text

署名まわり、あたふたしがち 対応を後回しにしがちで、ファーストリリース前に稀によくコケる 運用フェーズになったら、そんなに触らないので忘れがち 基礎的なところを完全に理解していきたい 3

Slide 4

Slide 4 text

目次 署名とは Platformごとの署名方法 Androidの署名 iOSの署名 よくあるユースケースとその対応方法 4

Slide 5

Slide 5 text

署名とは? 5

Slide 6

Slide 6 text

署名とは? 「秘密鍵を用いて、アプリにデジタル署名する」プロセスのこと アプリの作者を保証し、改ざんやなりすまし防止のために行われる 各Platformごとに署名の手続きをする必要がある 6

Slide 7

Slide 7 text

Platformごとの署名方法 7

Slide 8

Slide 8 text

Androidの署名 8

Slide 9

Slide 9 text

Androidの署名 Java Keystore を作成し、それを用いて署名を行う Developerが署名する鍵は Upload Key と呼ばれている 9

Slide 10

Slide 10 text

Androidの署名 Java Keystore とは 「秘密鍵」「公開鍵証明書」をセットにしたもの 10

Slide 11

Slide 11 text

Androidの署名 Java Keystore の作り方 Android Studioをポチポチしてたらできる 公式ドキュメントが丁寧なので、読めば作れるはず アプリへの署名 | Android デベロッパー | Android Developers 11

Slide 12

Slide 12 text

Androidの署名 Keystoreを用いて署名する android/app/build.gradle にKeystoreの設定する ... android { ... signingConfigs { release { storeFile file(MYAPP_UPLOAD_KEYSTORE_FILE) storePassword MYAPP_UPLOAD_STORE_PASSWORD keyAlias MYAPP_UPLOAD_KEY_ALIAS keyPassword MYAPP_UPLOAD_KEY_PASSWORD } } } ... $ cd android && ./gradlew bundleRelease で署名されたApp Bundleができる 12

Slide 13

Slide 13 text

Androidの署名 やることまとめ Java Keystore を作成する android/app/build.gradle にKeystoreの設定する Release buildをする 13

Slide 14

Slide 14 text

iOSの署名 14

Slide 15

Slide 15 text

iOSの署名 Provisioning Profile をPackagingする必要がある 15

Slide 16

Slide 16 text

iOSの署名 Provisioning Profile とは 「App ID」「Device ID」「証明書」をまとめたもの インストールや実行時に参照され、不正なアプリではないかをチェックしている 16

Slide 17

Slide 17 text

iOSの署名 証明書 の種類 Development Production Provisioning Profile の種類 AppStore Adhoc Development 今日はAppStoreから配信する際のパターンについて紹介します Production の証明書 x AppStore の Provisioning Profile 17

Slide 18

Slide 18 text

iOSの署名 Provisioning Profile の作り方 App IDを登録する Device IDを登録する 証明書 (Production) → 作業や管理を簡略化するために fastlane を利用する 18

Slide 19

Slide 19 text

iOSの署名 fastlane とは 19

Slide 20

Slide 20 text

iOSの署名 App IDを登録する $ fastlane produce --app_identifier [App ID] --company_name [company name] [Option] Push通知などを利用している場合は、利用する機能を有効にしておく see: Adding Capabilities to Your App | Apple Developer Documentation $ fastlane produce enable_services [service name] 20

Slide 21

Slide 21 text

iOSの署名 [Option] Device IDを登録する AppStoreに配信するだけならSkipして問題ない 実機で動作確認する場合は、実機のUDIDをApple登録する必要がある WhitelistとしてProvisioning Profileに保持される AppStore用のProvisioning Profileでは、Apple側で再署名される その際に、Device IDの項目がWhitelistがwildcardのようになってくれる $ fastlane run register_device name:"[device name]" udid:"[udid]" 21

Slide 22

Slide 22 text

iOSの署名 証明書とProvisioning Profileを作成する fastlane match を利用する 発行した証明書とProvisioning ProfileをRepository管理する仕組み 22

Slide 23

Slide 23 text

iOSの署名 証明書とProvisioning Profileを作成する Githubなどに管理用Repositoryつくる 23

Slide 24

Slide 24 text

iOSの署名 証明書とProvisioning Profileを作成する パスワードの設定 $ fastlane match change_password 24

Slide 25

Slide 25 text

iOSの署名 証明書とProvisioning Profileを作成する 初期化する $ fastlane match nuke distribution --app_identifier [App ID] 25

Slide 26

Slide 26 text

iOSの署名 証明書とProvisioning Profileを作成する AppStore用の証明書とProvisioning Profileを発行 作成したRepositoryに保存 実行環境に証明書インストール $ fastlane match appstore --app_identifier [App ID] 他の開発環境で証明書とProvisioning Profileを取得する際には readonly をつける $ fastlane match appstore --app_identifier [App ID] --readonly 26

Slide 27

Slide 27 text

iOSの署名 Xcodeの設定を色々して、Release buildする Automatically manage signing を外す 作成したProvisioning Profileを選択する Release buildする 27

Slide 28

Slide 28 text

iOSの署名 やることまとめ Provisioning Profile を作成する App IDを登録する Device IDを登録する fastlane match で証明書とProvisioning Profileを作成する Xcodeで証明書とProvisioning Profileの設定をする Release buildをする 28

Slide 29

Slide 29 text

iOSの署名 補足 Provisioning Profileは定期的に再発行イベントがある 証明書の期限が切れたとき Appleから発行された証明書は、有効期限が 1 年 となってる Androidのほうは 25 年 なので、あんまり気にしなくていい Push通知などのCapabilities追加したとき Provisoning Profileに有効になっているCapabilitiesが書いてある 機能追加したら更新する必要がある 検証端末を増やしたとき UDIDが登録されていない検証端末では、アプリが動作しない 新しい検証端末のUDIDを登録してから、Provisioning Profileを再発行する 29

Slide 30

Slide 30 text

よくあるユースケースとその対応方法 30

Slide 31

Slide 31 text

Staging環境つくりたい 31

Slide 32

Slide 32 text

Staging環境つくりたい Androidでやること package nameを環境ごとに分ける see: ビルド バリアントを設定する | Android デベロッパー | Android Developers Staging用に新しくkeystoreを作る必要はない debug用のkeystoreがあるので、それを使えばいい android.app/debug.keystore 32

Slide 33

Slide 33 text

Staging環境つくりたい iOSでやること package nameを環境ごとに分ける see: XcodeでDevelop/Staging/Release環境を上手に切り分ける方法 - Qiita Staging用にProvisioning Profileを作る必要がある 検証端末のDevice IDを登録する 21枚目のスライド参照 App IDをwildcardで指定して登録する $ fastlane produce --app_indetifier [App ID].* Provisionig Profileを作る $ fastlane match adhoc --app_identifier [App ID].* 33

Slide 34

Slide 34 text

CIでSignging済みのパッケージファイルをつくりたい 34

Slide 35

Slide 35 text

CIでSignging済みのパッケージファイルをつくりたい 署名関連ファイルは基本リポジトリに含めないので、CIでビルドするときにそれらを取 ってくる必要がある Androidは、keystoreをbase64してCIの環境変数にいれる iOSは、matchを利用して証明書をローカルにとってくる 35

Slide 36

Slide 36 text

各種設定ファイルとかをfastlane matchのように管理した い 36

Slide 37

Slide 37 text

各種設定ファイルとかをfastlane matchのように管理した い 各種設定ファイル keystore, google-services.json, sentry.properties, ... 大きく2パターンあるのでお好みでどうぞ 機密情報管理サービスを利用し、セットアップ時に設定ファイルを生成する AWS Secret manager GCP Secret Manager Hashicorp Vault 設定ファイルを暗号化し、git管理に含めてしまう git-secret git-cript 37