Apple App Store の設定

次のものが必要で、約 5 分かかります。

• App Store Connect への Admin または Account Holder のアクセス。
• App Store Connect の API キー。これで 3 つの値が得られます。Issuer ID、Key ID、そして .p8 秘密鍵ファイルです。

Apple にファイルはアップロードされず、アプリのバイナリにも変更は加えられません。

Issuer ID、Key ID、.p8 ファイルはすべて App Store Connect の同じ場所から得られます。

1. App Store Connect にサインインし、Users and Access を開き、Integrations タブを選んで左の Keys セクションから In-App Purchase を選びます。
2. ページ上部に表示される Issuer ID をコピーします。これはアカウント全体で共通の値で、生成するすべての鍵で共有されます。
3. Active の横の + ボタンをクリックして新しい鍵を生成します。名前を Refund Sensor にし、Access を Admin に設定して Generate をクリックします。
4. 新しい鍵から Key ID をコピーし、鍵の行をクリックして .p8 ファイルを Download します。Apple はダウンロードを 1 回だけ 許可するので、安全な場所に保管してください。

Refund Sensor で Add app を開き、Apple App Store を選びます。Issuer ID と Key ID を貼り付け、.p8 ファイルをアップロードして Continue をクリックします。私たちは Apple で鍵を検証し、保存前に AES-256-GCM で保管時暗号化します。以後、二度と表示されず、ログにも出ません。

鍵が検証されると、Refund Sensor はあなたの App Store Connect アカウントで見えるすべてのアプリを取得します。名前またはバンドル ID で検索し、防御したいアプリを選んで Connect をクリックします。接続された各アプリに専用の Webhook URL が付与されます。

これが最後のステップで、接続後にアプリごとに 1 回行います。Apple はサーバー通知を 1 つの URL に送ります。

1. Refund Sensor からアプリの Webhook URL をコピーします(接続済みアプリのカードに表示されます)。
2. App Store Connect でそのアプリの App Information ページを開き、App Store Server Notifications までスクロールします。
3. Production Server URL の Set Up URL をクリックし、URL を貼り付けて保存します。次に Sandbox Server URL でも同じことを行い、テストと本番の両方が Refund Sensor に届くようにします。

接続された各アプリには専用の一意な URL があり、私たちが生成して Refund Sensor のカードに表示します。手入力せず、そこからコピーしてください。

Apple はサーバー通知 URL を 1 つしか許可しません。サブスクリプションプラットフォームがすでに使っている場合は、置き換えないでください。代わりに、そのプラットフォームに各 Apple の生の通知のコピーを Refund Sensor の Webhook URL へ転送するよう設定すれば、両方が動き続けます。RevenueCat、Adapty、Apphud の具体的な手順は 通知転送 を参照してください。

Refund Sensor は、実際のイベントへの対応を始める前に、Apple の通知を受け取れることを確認します。接続が検証されるまで、ライブイベントは記録されますが対応はされないので、設定が途中でも誤って応答を送ることはありません。