iCloud からのパーク

iCloud発のパーキングワークフローは、ユーザーが次の2つの方法のいずれかで起動できます：

1. iCloud.comを通じて自分のiCloudアカウントにサインインする。
2. を使用する 「探す」 同じApple IDでログインしている別のデバイス上のアプリケーション。

このワークフローを開始すると、指定されたデバイスからWallet内のすべてのカードが削除されます。

このセクションでは、詳細な手順、シーケンス図、および考えられるエラーシナリオを含むワークフローの概要を提供します。

ワークフロー

以下はiCloud発のパーキングワークフローの大まかな手順です：

1. カード削除：ユーザーが自分のデバイスからカードの削除を開始します。
2. カードのリンク解除：Appleはユーザーがトランジットカードをデバイスから削除したことをD1 Transitプラットフォームに通知します。
3. 削除確認：D1 TransitはAppleに getStatus リクエストを送信して、デジタルカードが削除されたかどうかを確認します。

シーケンス図

カード削除

ユーザーが自分のiCloudアカウントにアクセスし、デバイスを選択して「デバイスを消去」を押します。WalletはAppleサーバーに対してそのデバイスからすべてのカードを削除するよう指示します。

カードのリンク解除

Walletからデバイス上のカードを削除するリクエストを受け取ると、Appleサーバーはそのデバイスに関連付けられたすべてのトランジットカードに対してmanagePass(unlink) API呼び出しをD1 Transitプラットフォームに対して開始します。

削除確認

このワークフローではAppleはeventNotificationをD1 Transitプラットフォームに送信しません。したがって、D1 TransitはgetStatus(provisioningBundleIdentifier)をAppleに呼び出してデジタルカードの状態を能動的に照会する責任があります。D1 Transitは削除が成功したかどうかを確認できます。

デバイスがオンラインの場合、応答にはHTTP 404ステータスコードが含まれます。これはカードが正常に削除され、もはやAppleのサーバー上に存在しないことを確認します。

デバイスがオフラインの場合、応答にはアクティブな状態が含まれます。これはパーキングプロセスが完了しておらず、カードを拒否リストに残す必要があることを確認します。

エラーシナリオ

デバイスがオフライン

このリクエストはデバイス発ではないため、デバイスがオンラインである保証はありません。そのような場合、カード削除のリクエストがデバイスに到達しないことがあります。例えば、デバイスが機内モードになっている可能性があります。したがって、トランジット用途での使用を防ぐために、プロビジョニング済みのデジタルカードを拒否リストに入れることが強く推奨されます。

トランジットのイシュアは、カードを別のデバイスにプロビジョニングできるようにする前に、拒否リストが関連するすべてのリーダーに完全に伝播されていることを確認する必要があります。この手順は、同じトランジットカードが複数のデバイスで同時に使用されるのを防ぎ、潜在的な不正使用を回避するために重要です。