Apple署名
MacなしでiOS配布または開発用証明書を作成し、AppleにCSRをアップロードし、発行された証明書を.p12ファイルに変換して署名する。
ワークフロー
ステップ1
アップル証明書要求で同じ人物または組織のアイデンティティを使用する
出力
CSRが生成されるまで何も表示されません。生成が完了したら、両方のファイルをダウンロードし、プライベートキーを安全に保存してください。
ステップ2
Appleの.cerを.p12に変換 .cer 1から取得した秘密鍵を使用してパスワード保護された
.p12 Xcode、fastlane、CI、またはCapgo Cloud Build用
ブラウザ上で実行されます。 サーバーにアップロードされることなく、ローカルでのみ証明書、秘密鍵、パスワードを読み取ります。
出力
Select your .cer and private key, set a password, and build the .p12. It uses 3DES encryption with a SHA-1 MAC, the format macOS Keychain and Xcode accept.
Basics
Apple requires every iOS app to be code signed. A signing certificate proves the build comes from a member of your Apple Developer team, and iOS refuses to install or launch apps whose signature it cannot trust.
取得するには3つのファイルが必要です。 CSR (.csr)には公開鍵とアイデンティティが含まれ、Appleに送信されます。 プライベートキー (.pem)はあなたと一緒に残ります。 The 証明書 Appleが返すものは(.cer)です。 ビルドツールは証明書と秘密鍵を合わせて.p12ファイルとして必要とします。 .p12 セキュリティとプライバシー
秘密鍵の取り扱い
CSRと2048ビットのRSA秘密鍵は、HTTPSでstateless __CAPGO_KEEP_0__エンドポイントによってオンデマンドで作成され、ブラウザに直接返されます。
Cache-Control: no-storeHow your private key is handledローカルでキーを生成したい場合はこちらのOpenSSLコマンドを使用してください。
openssl req -new -newkey rsa:2048 -nodes \
-keyout ios-private-key.pem \
-out ios-certificate-request.csr \
-subj "/emailAddress=jane@company.com/CN=Jane Doe/C=US"ステップバイステップ
CSRからテストフライトで署名されたビルドまで。すべてのステップはブラウザとWindows、Linux、macOSのターミナルから実行できます。
ステップ1
Enter your name, email, and two-letter country code in the form above and select Generate CSR and private key. Download both files and keep the private key safe.
ステップ2
Apple Developer のサイトにサインインし、Certificates, Identifiers & Profiles を開き、+ をクリックし、Apple Distribution または Apple Development を選択します。
Step 3
ios-certificate-request.csr ファイルをアップロードし、続行し、発行された証明書をダウンロードします。通常、distribution.cer または development.cer になります。
Step 5
.cer とプライベート キーを選択し、パスワードを設定し、.p12 をダウンロードします。ブラウザで実行するか、OpenSSL コマンドを使用することもできます。
Step 6
Step 7
アプリを署名し、配信します。
Xcode、fastlane、CIのシークレット、またはCapgo Cloud Buildに.p12とプロファイルをインポートし、テストフライトまたはApp Storeにアプリをビルドしてアップロードしてください。
出力結果を使用してください。
最速のパスは ブラウザ内で.cerを.p12に変換する 上記の手順に従ってください。 コマンドラインを使用したい場合は、OpenSSLを使用します。OpenSSLは.p12のパスワードを求めます。
OpenSSLはmacOSと多くのLinuxディストリビューションにプリインストールされており、WindowsではGit BashまたはWSLを使用して入手できます。
# 1. Convert Apple's DER .cer to PEM
openssl x509 -inform DER -in distribution.cer -out distribution.pem
# 2. Bundle the certificate and private key into a .p12
# -legacy (OpenSSL 3) keeps the file compatible with macOS Keychain.
# Drop it on OpenSSL 1.1 or LibreSSL, which do not support the flag.
openssl pkcs12 -export -legacy \
-inkey ios-private-key.pem \
-in distribution.pem \
-name "Apple Distribution" \
-out distribution.p12p12とプロビジョニングプロファイルを一度保存し、 Capgo Cloud Build Macを必要とせずにiOSビルドを署名してアップロードできます。
bunx @capgo/cli@latest build credentials save \
--platform ios \
--certificate ./distribution.p12 \
--p12-password "your-p12-password" \
--ios-provisioning-profile "com.example.app=./profile.mobileprovision" \
--apple-team-id "TEAM123456"Mac上では、.p12ファイルをダブルクリックしてKeychainにインポートし、Xcodeがそれを認識します。CIランナー上では、fastlaneで一時的なKeychainにインポートします。
import_certificate(
certificate_path: "distribution.p12",
certificate_password: ENV["P12_PASSWORD"],
keychain_name: "build.keychain",
keychain_password: ENV["KEYCHAIN_PASSWORD"]
)GitHubアクションまたはGitLabシークレット用に署名ファイルをbase64でエンコードし、証明書がプライベートキーと一致することを確認します。
# Encode the .p12 and profile for CI secrets
base64 -i distribution.p12 | tr -d '\n' > p12.base64
base64 -i profile.mobileprovision | tr -d '\n' > profile.base64
# Check that the certificate and key match (both hashes must be equal)
openssl x509 -noout -modulus -in distribution.pem | openssl md5
openssl rsa -noout -modulus -in ios-private-key.pem | openssl md5トラブルシューティング
署名後
ネイティブバイナリが署名されたら、Capgoライブアップデートは、Capacitorウェブ層の変更をオーバーザエアで配信できます—チャンネル、ロールバック、既存のCI/CDを含む。 その時までに、OTAを同じリリースパスに組み込む準備ができたら、無料で試すことができます。
FAQ
CSRs、証明書タイプ、.p12の変換、Apple Developerアカウント、MacなしでiOSアプリを署名する方法についての質問
Certificate Signing Request (.csr)と対応するRSA 2048-bitの秘密鍵(.pem)を作成します。アップロードしたCSRをApple Developerに送信すると、Apple DistributionまたはApple Development証明書(.cer)が発行されます。 .cerを秘密鍵と組み合わせて、Xcode、fastlane、CI、またはCapgoCloud Buildで使用できる.p12ファイルを作成します。
CSRは、公開鍵と識別情報（名前、メール、国名）を含む小さなファイルで、プライベート鍵で署名されています。Appleは、その鍵に紐づいた署名証明書を発行します。プライベート鍵はAppleに渡されないため、ツールが提供する.pemファイルを安全に保管する必要があります。
はい。CSRと秘密鍵をここで生成し、Apple Developer ポータルにアップロードし、.cerファイルをダウンロードし、ステップ2のこのページにあるコンバーターで.p12に変換してください。Windows、Linux、macOSからでも動作するので、Keychain Accessは必要ありません。
Apple Developmentを選択して、登録済みテストデバイスでXcodeからビルドを実行します。Apple Distributionを選択して、App Store、TestFlight、ad hoc配布用にビルドを署名します。同じCSRはどちらのタイプでも使用できます。タイプはApple Developerで選択し、このツールでは選択しません。
いいえ。ステップ1では、HTTPSでstateless CapgoエンドポイントによってCSRと秘密鍵がオンデマンドで生成され、Cache-Control: no-store; で返され、ブラウザに直接返され、データベースに書き込まれず、返答後に保存されません。ステップ2では、.cerファイルから.p12ファイルに変換するコンバーターは、ブラウザ上で実行され、アップロードされません。ローカルキーの生成が必要な場合は、このページの同等のOpenSSLコマンドを使用してください。
.cerファイルはAppleから提供されるものだけが公開証明書を含みます。アプリを署名するには秘密鍵も必要なので、パスワードで保護された.p12ファイルが証明書と秘密鍵を含むことをビルドツールが期待します。
このページのステップ2を使用してください: Appleの.cer (DERまたはPEM)を選択し、CSRを作成したプライベートキー.pemを選択し、パスワードを入力し、ビルド.p12ファイルを選択します。ブラウザは証明書がキーと一致するかどうかを確認し、macOS Keychain、Xcode、fastlaneが受け入れる3DES暗号化.p12ファイルを作成します。アップロードは行われません。CIシークレットとしても.p12をbase64でコピーできます。
はい。アップロードするCSRと署名証明書を発行するには、有料のApple Developer Programの会員資格 (年間99ドル、またはインハウス配布用のエンタープライズプログラム) が必要です。CSR自体はアカウントなしで生成できます。
Apple DevelopmentとApple Distribution証明書は1年間有効です。App Storeにすでに公開されているアプリは証明書が期限切れになったり、取り消されたりしても機能を維持しますが、次のビルドに署名するには新しい証明書とプロビジョニングプロファイルが必要になります。
できますが、安全かつ簡単にローテーションできる新しいキーペアを使用する方が安全です。混ぜてはなりません: .cerはそのCSRを作成した正確なプライベートキーとしか機能しません。キーが失われた場合は証明書を取り消し、新しいCSRを作成してください。
はい。AppleはAPNs SSL証明書を作成するときにCSRを要求します。新しいアプリの場合、APNs認証キー (.p8) は永続的に機能し、アプリすべてに使用できるため、より簡単です。
続けてください
ツールスタック
これらのジェネレータとデバイスユーティリティを組み合わせて、ブラウザ内で署名、テスト、配信を継続的に行うことができます。
