CAPHTECH iOS Code Signing
iOSアプリのコード署名設定とトラブルシューティングを支援する。
概要
このスキルは以下の領域をカバーする:
- コード署名の仕組みと概念
- 証明書（Certificates）の管理
- Provisioning Profile の管理
- Keychain の設定
- CI/CD 環境での署名自動化
実行条件
- Apple Developer Program に登録済み
- macOS 環境でXcodeがインストールされている
- App Store Connect / Apple Developer Portal へのアクセス権限がある
プロセス
Phase 1: 現状診断
1.1 証明書の確認
# キーチェーン内の証明書一覧
security find-identity -v -p codesigning
# 有効な証明書のみ
security find-identity -v -p codesigning | grep "Apple Development\|Apple Distribution"
期待される出力例:
1) XXXXXXXXXX "Apple Development: Your Name (TEAM_ID)"
2) YYYYYYYYYY "Apple Distribution: Your Company (TEAM_ID)"
1.2 Provisioning Profile の確認
# インストール済みProfile一覧
ls -la ~/Library/MobileDevice/Provisioning\ Profiles/
# Profile内容の確認
security cms -D -i ~/Library/MobileDevice/Provisioning\ Profiles/XXXX.mobileprovision
1.3 プロジェクト設定の確認
# ビルド設定の署名関連項目
xcodebuild -showBuildSettings -project Project.xcodeproj | grep -E "CODE_SIGN|PROVISIONING|DEVELOPMENT_TEAM"
Phase 2: 問題特定
よくある署名エラーと原因
| エラー | 原因 | 解決方法 |
|---|---|---|
No signing certificate found |
証明書がない/期限切れ | 証明書の作成/更新 |
Profile doesn't include signing certificate |
Profile と証明書の不一致 | Profile の再生成 |
App ID doesn't match bundle identifier |
Bundle ID の不一致 | App ID の確認/修正 |
Provisioning profile expired |
Profile 期限切れ | Profile の更新 |
Device not included in profile |
デバイス未登録 | デバイス追加と Profile 再生成 |
診断フロー
1. 証明書は有効か？
├─ NO → 証明書を作成/更新
└─ YES
↓
2. Profile に証明書が含まれているか？
├─ NO → Profile を再生成
└─ YES
↓
3. Bundle ID が一致しているか？
├─ NO → Bundle ID を修正
└─ YES
↓
4. デバイスが登録されているか？（Ad Hoc/Development）
├─ NO → デバイス追加と Profile 再生成
└─ YES → その他の問題を調査
Phase 3: 解決策実行
詳細は以下の参照ドキュメントを確認:
- references/certificate-guide.md - 証明書管理
- references/provisioning-profile-guide.md - Profile管理
- references/ci-signing-guide.md - CI/CD署名
3.1 証明書の作成（開発用）
Keychain Access でCSRを作成
- Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority
- 「Save to disk」を選択
Apple Developer Portal で証明書発行
- Certificates, Identifiers & Profiles > Certificates
- 「+」ボタン > 「Apple Development」を選択
- CSRをアップロード
証明書のダウンロードとインストール
- ダウンロードした .cer ファイルをダブルクリック
3.2 Provisioning Profile の作成
- Apple Developer Portal にアクセス
- Profiles > 「+」ボタン
- Profile タイプを選択
- iOS App Development（開発）
- Ad Hoc（テスト配布）
- App Store（App Store 配布）
- App ID を選択
- 証明書を選択
- デバイスを選択（Development/Ad Hoc の場合）
- Profile 名を入力して生成
3.3 Xcode への適用
Automatic Signing（推奨: 開発時）:
CODE_SIGN_STYLE = Automatic
DEVELOPMENT_TEAM = XXXXXXXXXX
Manual Signing（推奨: リリース時）:
CODE_SIGN_STYLE = Manual
DEVELOPMENT_TEAM = XXXXXXXXXX
CODE_SIGN_IDENTITY = Apple Distribution
PROVISIONING_PROFILE_SPECIFIER = MyApp_AppStore
Phase 4: CI/CD 設定
4.1 必要なファイル
- 証明書 (.p12): 秘密鍵を含むエクスポートされた証明書
- Provisioning Profile (.mobileprovision): 配布用 Profile
- Keychain パスワード: 一時的な Keychain 用
4.2 GitHub Actions での設定例
- name: Install Certificates
env:
CERTIFICATE_BASE64: ${{ secrets.CERTIFICATE_BASE64 }}
CERTIFICATE_PASSWORD: ${{ secrets.CERTIFICATE_PASSWORD }}
KEYCHAIN_PASSWORD: ${{ secrets.KEYCHAIN_PASSWORD }}
run: |
# 一時キーチェーン作成
security create-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security default-keychain -s build.keychain
security unlock-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
# 証明書インストール
echo "$CERTIFICATE_BASE64" | base64 --decode > certificate.p12
security import certificate.p12 -k build.keychain -P "$CERTIFICATE_PASSWORD" -T /usr/bin/codesign
security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "$KEYCHAIN_PASSWORD" build.keychain
- name: Install Provisioning Profile
env:
PROVISIONING_PROFILE_BASE64: ${{ secrets.PROVISIONING_PROFILE_BASE64 }}
run: |
mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
echo "$PROVISIONING_PROFILE_BASE64" | base64 --decode > ~/Library/MobileDevice/Provisioning\ Profiles/profile.mobileprovision
Phase 5: 検証
# 署名の検証
codesign -vvv --deep --strict /path/to/App.app
# Profile の検証
security cms -D -i ~/Library/MobileDevice/Provisioning\ Profiles/profile.mobileprovision | grep -A1 "ExpirationDate"
出力形式
診断レポート
## 署名診断レポート
### 証明書ステータス
| 種類 | 名前 | 有効期限 | ステータス |
|------|------|----------|-----------|
| Development | Apple Development: Name | 2025-01-01 | OK |
| Distribution | Apple Distribution: Company | 2024-12-31 | WARNING: 30日以内に期限切れ |
### Provisioning Profile ステータス
| Profile名 | App ID | 種類 | 有効期限 | ステータス |
|-----------|--------|------|----------|-----------|
| MyApp_Dev | com.company.myapp | Development | 2024-06-01 | OK |
| MyApp_AppStore | com.company.myapp | App Store | 2024-03-15 | ERROR: 期限切れ |
### 検出された問題
#### ERROR
- [ ] Distribution Profile が期限切れです
- 影響: App Store へのアップロードができません
- 対応: Apple Developer Portal で Profile を再生成してください
#### WARNING
- [ ] Distribution 証明書が 30 日以内に期限切れになります
- 対応: 証明書の更新を計画してください
解決手順
## 署名問題の解決手順
### 手順 1: 証明書の更新
1. Keychain Access で CSR を作成
2. Apple Developer Portal で証明書を発行
3. 証明書をダウンロードしてインストール
### 手順 2: Profile の再生成
1. Apple Developer Portal > Profiles にアクセス
2. 対象の Profile を編集または新規作成
3. 新しい証明書を選択
4. Profile をダウンロードしてインストール
### 手順 3: Xcode 設定の更新
1. Xcode > Preferences > Accounts で更新
2. プロジェクト設定で新しい Profile を選択
3. ビルドして確認
ガードレール
禁止事項
- 証明書の秘密鍵を平文で保存・共有
- 本番用証明書を開発環境に不用意にインストール
- 期限切れ証明書でのアーカイブ作成
- チーム外への証明書・Profile の共有
確認必須事項
- 証明書操作前に現在の状態をバックアップ
- p12 ファイルのパスワードは安全に管理
- CI/CD シークレットは暗号化して保存
- 証明書/Profile の有効期限を定期的に確認
推奨事項
- 開発時は Automatic Signing を使用
- リリース時は Manual Signing を使用
- 証明書は期限切れ 30 日前に更新
- 不要な証明書・Profile は定期的に整理
- App Store Connect API キーの活用を検討
セキュリティ考慮事項
- p12 ファイルには強力なパスワードを設定
- CI/CD では一時的な Keychain を使用
- ビルド後は証明書・Keychain を削除
- シークレット管理サービスの活用を検討