メインコンテンツへスキップ
iOS および Android 向けの Guardian SDK を使用すると、ベンダー固有のプッシュ通知サービスに対応した独自開発アプリを利用できます。AWS Simple Notification Service (SNS) プラットフォーム用にプッシュ通知を設定することも、Direct to Vendor サービスを使用して Firebase Cloud Messaging (FCM) と Apple Push Notification (APN) の資格情報を Auth0 に直接追加することもできます。

AWS SNS の設定

プッシュ通知を設定する前に、以下の前提条件を満たしてください。
  1. AWS Management Console を使用して SNS Platform Application を作成 し、その ARN を控えておきます。
  2. Platform Application のエンドポイントを作成する権限を持つ AWS Access Key ID を作成します。Guardian は、登録が正常に完了すると、その一環として適切なデバイストークンを使用した Platform Application のエンドポイントを自動的に作成します。

AWS SNS を使用してプッシュ通知を設定する

Guardian からプッシュ通知を受け取るには、まず Guardian のデフォルトの SNS 設定を上書きする必要があります。その後、Android と iOS のプッシュ通知を設定できます。
  1. Auth0 Dashboard で Security > Multi-factor Auth に移動し、Push via Auth0 Guardian を選択します。この方法が無効になっている場合は、右上のトグルを選択して有効にします。
  2. Custom を選択して、追加の設定を表示します。
  3. Push Notification Service セクションで、Amazon SNS を選択します。
Auth0 Dashboard > Security > Multi-factor Auth > Guardian > Custom > Amazon SNS
  1. Amazon SNS Configuration セクションで、次の項目を入力します。
  2. Save を選択して変更を保存します。

FCM を使用して Android のプッシュ通知を設定する

Auth0 Dashboard で Android のプッシュ通知を設定するには、まず FCM サーバーの資格情報を取得します。詳細については、Google の Firebase ドキュメントを参照してください。
  1. Firebase Console に移動し、該当するプロジェクトを選択します。
  2. Settings メニューを開き、Service Accounts を選択します。
  3. Generate New Private Key を選択し、資格情報ファイルをダウンロードします。
資格情報を取得したら、Auth0 Dashboard でプッシュ通知を設定できます。

APNs を使用して iOS のプッシュ通知を設定する

Auth0 DashboardでiOSのプッシュ通知を構成するには、まずAPN証明書を取得し、最新の暗号化方式に変換します。キーチェーンアクセスは、旧式の暗号化方式 (RC2およびTriple DES) でP12ファイルをエクスポートします。Auth0は旧式の暗号化方式のP12ファイルを受け付けないため、アップロードする前にファイルを最新の暗号化方式 (AES-256-CBC) に変換する必要があります。ファイルの変換には、OpenSSL 3.0以降が必要です。macOSに付属のopensslコマンドは実際にはLibreSSLであり、以下の手順で使用するオプションに対応していません。macOSでは、HomebrewでOpenSSLをインストールできます。
  1. Apple Developer アカウントで新しい APN 証明書を生成します。タイプには Apple Push Notification service SSL (Sandbox & Production) を選択してください。開発およびテストのみを目的とする場合は、代わりに Apple Push Notification service SSL (Sandbox) を選択することもできます。
  2. 証明書をローカル環境にインストールします。
  3. キーチェーンアクセスで証明書を探します。証明書の名前は、その種類によって異なります。
    • Apple Push Notification service SSL (Sandbox & Production): Apple Push Services: {AppId}
    • Apple Push Notification service SSL (Sandbox): Apple Sandbox Push Services: {AppId}
  4. 証明書と関連付けられた秘密鍵をP12ファイル (デフォルト名:Certificates.p12) に書き出します。Keychain Accessで、書き出す項目を保護するためのパスワードの入力を求められた場合は、パスワードを空欄のままにしてください。
  5. Certificates.p12 を最新の暗号化方式に変換します。ターミナルでファイルが保存されているフォルダーに移動し、次のコマンドを実行します。
    1. 以降のコマンドでLibreSSLが使われないよう、OPENSSLシェル変数にHomebrewでインストールしたopensslコマンドを設定します。Homebrewを使わずにOpenSSL 3.0以降をインストールした場合は、代わりにそのopensslバイナリのフルパスを指定してください。
      $OPENSSL versionコマンドを実行すると、OpenSSLのバージョンが表示されます。LibreSSLではなく、OpenSSL 3.0以降と表示されていることを確認してください。
    2. 証明書と秘密鍵を中間ファイルapns.pemに抽出します。従来の暗号化方式を読み取るには、OpenSSLで-legacyオプションを指定する必要があります。
    3. 最新の暗号化方式を使用した、パスワードなしのapns.p12ファイルを作成します。新しいファイルでは、AES-256-CBCを用いたPassword-Based Encryption Scheme 2 (PBES2) と、SHA-256のメッセージ認証コード (MAC) が使用されます。
    4. apns.pemには暗号化されていない秘密鍵が含まれているため、削除します。
  6. apns.p12 をアップロードする前に、暗号化方式を確認してください。OPENSSL 変数が設定された状態を保つため、同じターミナルセッションで次のコマンドを実行します。
    出力に含まれる次の3行を確認してください:
    1. MAC 行に sha256 と表示されていること。
    2. 証明書の PKCS7 Encrypted data 行に PBES2, PBKDF2, AES-256-CBC と表示されていること。
    3. 秘密鍵の Shrouded Keybag 行に PBES2, PBKDF2, AES-256-CBC と表示されていること。
    出力は次のようになります。
  7. Certificates.p12を削除し、Auth0 Dashboardではapns.p12をAPN証明書として使用します。 Auth0 Management APIを使用して証明書をアップロードする場合は、apns.p12をbase64でエンコードします:
    Update APNS Configurationエンドポイントを呼び出す際に、この出力をp12の値として使用します。このエンドポイントはAPNsの設定全体を上書きするため、bundle_idとsandboxの値も併せて指定してください。現在の値は、Get APNS Push Notification Configurationエンドポイントを呼び出して取得できます。
認証情報を取得したら、Auth0 Dashboardでプッシュ通知を構成できます。

詳しくはこちら