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 証明書の確認

bash

# キーチェーン内の証明書一覧
security find-identity -v -p codesigning

# 有効な証明書のみ
security find-identity -v -p codesigning | grep "Apple Development\|Apple Distribution"

期待される出力例:

code

1) XXXXXXXXXX "Apple Development: Your Name (TEAM_ID)"
2) YYYYYYYYYY "Apple Distribution: Your Company (TEAM_ID)"

1.2 Provisioning Profile の確認

bash

# インストール済みProfile一覧
ls -la ~/Library/MobileDevice/Provisioning\ Profiles/

# Profile内容の確認
security cms -D -i ~/Library/MobileDevice/Provisioning\ Profiles/XXXX.mobileprovision

1.3 プロジェクト設定の確認

bash

# ビルド設定の署名関連項目
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 再生成

診断フロー

code

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（推奨: 開発時）:

xcconfig

CODE_SIGN_STYLE = Automatic
DEVELOPMENT_TEAM = XXXXXXXXXX

Manual Signing（推奨: リリース時）:

xcconfig

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 での設定例

yaml

- 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: 検証

bash

# 署名の検証
codesign -vvv --deep --strict /path/to/App.app

# Profile の検証
security cms -D -i ~/Library/MobileDevice/Provisioning\ Profiles/profile.mobileprovision | grep -A1 "ExpirationDate"

出力形式

診断レポート

markdown

## 署名診断レポート

### 証明書ステータス
| 種類 | 名前 | 有効期限 | ステータス |
|------|------|----------|-----------|
| 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 日以内に期限切れになります
  - 対応: 証明書の更新を計画してください

解決手順

markdown

## 署名問題の解決手順

### 手順 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 を削除
•シークレット管理サービスの活用を検討