CI用MacのXcodeからApple IDが勝手に消える件

GitHub Actions の self-hosted runner にしている Mac mini で、Xcode に登録した Apple ID がしばらくすると消える、という現象にずっと悩まされていました。追加し直しても、いつの間にか一覧からきれいに消えています。原因を追ってみたら、画面ロックと xcodebuild の組み合わせでした。
環境
- Mac mini (M1)、macOS 27.2、Xcode 27.1
- GitHub Actions の self-hosted runner を LaunchAgent で常駐
- ジョブ開始時の hook で
security unlock-keychainして login キーチェーンを解錠 - 普段は画面共有でつないで操作して、終わったら切断
- 署名は Xcode に登録した Apple ID まかせ(
xcodebuild -exportArchive -allowProvisioningUpdates)
症状
Xcode > Settings > Apple Accounts に追加した Apple ID が、しばらくすると一覧から消えます。「再サインインが必要」になるのではなく、エントリごと無くなります。消えたあとのジョブは export で失敗します。
error: exportArchive No Accounts
Add a new account in Accounts settings.
ただ、古くから登録してあるアカウントだけは消えません。これがよくわからなくて混乱しました。
ジョブのログ
失敗したジョブのログを見ると、xcodebuild がアカウントの資格情報を読めなかった記録が残っていました。
DVTDeveloperAccountManager: Failed to load credentials for XXXXXXXX-…:
Invalid credentials in keychain for XXXXXXXX-…, missing Xcode-Username
DVTDeveloperAccountManager: Failed to load credentials for user@example.com:
Invalid credentials in keychain for user@example.com, missing Xcode-Token
xcodebuild は資格情報を読めなかったアカウントを壊れたものとみなして、Xcode の設定から削除してしまうようです。アカウントが消えていたのはこれでした。
ちなみに Xcode の資格情報は security find-generic-password -s Xcode-Token では見つかりません。login キーチェーンではなく、データ保護キーチェーンの方に入っているからです。最初これで探して見つからず、しばらく悩みました…。
原因は keybag のロック
同じ時刻の unified log を見ると、secd がはっきり理由を返していました。
$ log show --start "… 12:20:04" --end "… 12:20:08" --style compact \
--predicate 'process == "secd" AND eventMessage CONTAINS "com.apple.dt.Xco"'
secd com.apple.dt.Xco[95453] copy_matching Error … Code=-25308
"ks_crypt: e00002e2 failed to 'od' item (class 6, bag: -3) Access to item attempted while k…
-25308 は errSecInteractionNotAllowed で、keybag がロックされているので読めない、という意味です。class 6 は「ロック解除中のみアクセス可」の保護クラスっぽいです。
画面ロックと keybag の状態は loginwindow と kernel のログで追えます。
$ log show --start … --style compact --predicate \
'(process == "loginwindow" AND eventMessage CONTAINS "KeybagForScreenLock") OR
(process == "kernel" AND eventMessage CONTAINS "lock state change")'
時系列に並べるとこうなりました。
- 12:16:22 ジョブ開始。hook が
security unlock-keychainを実行(keybag: 解錠) - 12:16:41 画面共有を切断して、画面がロックされる(keybag: ロックへ移行中)
- 12:16:51 10 秒後に keybag がロックされる(keybag: ロック)
- 12:20:04 archive の codesign は成功。login キーチェーンは開いたまま(keybag: ロック)
- 12:20:06 export で資格情報が読めず、アカウントが削除される(keybag: ロック)

ポイントは以下の 3 つです。
- 画面がロックされると、10 秒後に user keybag もロックされる。
security unlock-keychainで login キーチェーンを解錠すると、keybag も一緒に解錠される。ただしその 1 回きりなので、あとで画面がロックされれば keybag はまたロックされる。- login キーチェーンの方は開いたままなので、証明書を使う codesign は通る。Xcode アカウントの資格情報だけが読めなくなる。
つまり「ジョブの実行中に画面共有を切断した」ときだけ起きていました。runner がジョブ開始時に解錠しているので大丈夫だと思っていたんですが、途中でロックされていたわけです。画面がロックされた状態でジョブが始まる場合は、開始時の解錠で keybag も開くので問題ありません。「しばらくすると消える」ように見えていたのはこのためでした。
古いアカウントだけ消えない理由
~/Library/Preferences/com.apple.dt.Xcode.plist の DVTDeveloperAccountManagerAppleIDLists を見ると、アカウントの登録形式が 2 種類あります。
"IDE.Identifiers.Prod" = ( { identifier = "XXXXXXXX-…"; } ); // 新しい形式 (UUID)
"IDE.Prod" = ( { username = "user@example.com"; } ); // 古い形式 (メールアドレス)
今の Xcode で追加すると UUID 形式になります。xcodebuild が削除するのは UUID 形式のエントリだけで、古い形式は資格情報を読めなくても残ります。昔から登録していたアカウントが無事に見えていたのはこのためで、実は同じアカウントの UUID 形式のエントリはしっかり消されていました。
再現
keybag がロックされた状態で、runner と同じ条件(LaunchAgent、SessionCreate)から xcodebuild -exportArchive -allowProvisioningUpdates を実行すると、毎回 -25308 で失敗して、UUID 形式のアカウントが消えました。
一方で、画面がロックされていても直前に security unlock-keychain すれば keybag が開いて成功します。最初の再現テストはこれでうっかり成功してしまい、だいぶ遠回りしました…。
対策
1. App Store Connect API キーで署名する
Xcode のアカウントを使わなければ、keybag の状態は関係ありません。
xcodebuild … -allowProvisioningUpdates \
-authenticationKeyPath ~/private_keys/AuthKey_XXXXXXXXXX.p8 \
-authenticationKeyID XXXXXXXXXX \
-authenticationKeyIssuerID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
archive と -exportArchive の両方に付けます。cloud signing には Admin ロールのキーが必要という報告もあります。
2. 画面共有の切断時に画面をロックしない
ロックされた Mac に画面共有で入って解錠すると、切断時に元の状態(ロック)に戻されます。これを止める設定があります。
sudo defaults write /Library/Preferences/com.apple.RemoteManagement RestoreMachineState -bool NO
macOS 27.2 で、切断しても画面がロックされないことを確認しました。その代わり Mac のコンソールは解錠されたままになります。あと、手で画面をロックすれば当然同じ問題は起きます。
3. xcodebuild の直前に解錠する
xcodebuild の直前に security unlock-keychain すれば keybag も開きます。解錠してから資格情報を読むまでの数秒にロックされなければ大丈夫です。
私は 2 にしました。CI 専用機なら 1 がいちばん確実だと思います。
参考
Apple Developer Forums に同じエラーの報告がいくつかありますが、画面ロックとの関係を指摘しているものは見つかりませんでした。