認証情報の取得方法


認証情報の取得方法

Amazon Device Messaging(ADM)を使用するには、Amazonに対してアプリを一意に識別できることを示す必要があります。そのために必要な認証情報がAmazonから開発者に提供されます。

  • APIキー: ADMはAPIキーを使用してアプリの識別情報を検証します。
  • OAuth認証情報(「クライアントID」と「クライアントシークレット」): ADMはOAuth認証情報を使用して開発者サーバーの識別情報を検証します。開発者サーバーは認証情報を提示して、ADMを介したメッセージの送信に必要なアクセストークンを取得します。

OAuth認証情報とAPIキーの使用に関しては、Amazon Device Messaging(ADM)についてアプリの統合方法アクセストークンのリクエスト方法を参照してください。

OAuth認証情報とAPIキーの取得方法

認証情報を取得して、アプリによるADMの使用を有効にするには

  1. Amazon開発者ポータルでアカウントを作成して、アプリを追加します(まだの場合)。

  2. [アプリ&サービス] > [マイアプリ] で、ADMを使用するアプリを選択します。

  3. [デバイスメッセージング] をクリックします。

  4. アプリにセキュリティプロファイルを割り当て済みの場合は、手順7に進みます。

  5. アプリにセキュリティプロファイルを割り当てるには、[セキュリティプロファイルを選択] から既存のセキュリティプロファイルを選択するか、[セキュリティプロファイルを新規作成] をクリックします。セキュリティプロファイルには、ADM経由でメッセージを送信する際に使用するOAuth認証情報が含まれています。

  6. 既存のセキュリティプロファイルを使用する場合は、[確定] をクリックして変更を保存します。

  7. [セキュリティプロファイルを表示] をクリックしてから、[Android/Kindleの設定] をクリックします。

  8. APIキーを作成します。アプリには、APIキーが1つ以上必要です。

    • (必須)アプリがプレリリース(デバッグ)版の場合: デバッグ版アプリでは、ADMを使用したテストを行うためにAPIキーを作成する必要があります。

    • (任意)アプリがリリース(実稼働)版の場合: 独自の証明書を使用してリリース版アプリに署名する場合は、そのアプリ用に追加のAPIキーを作成する必要があります。アプリへの署名をAmazonに任せる場合、新たなAPIキーの作成は不要です。

    APIキーを作成するには、アプリのパッケージ名(com.mycompany.bestapplicationなど)と署名の両方を指定する必要があります。

    • プレリリース版アプリでは、アプリ署名をデバッグします。

      次のいずれかを行って、デバッグ版アプリの署名時に使用した証明書のMD5またはSHA-256署名を取得することもできます。

      • アプリの署名時に使用したキーストアファイルだけでなく、そのファイルにある証明書のエイリアスも特定します。たとえば、キーストアファイルの名前がmy_key_storeであり、署名に使用したキーストア内にある証明書の名前がmy_certificate_aliasである場合、実行するコマンドは次のようになります。{JAVA_HOME}/bin/keytool -list -v -alias my_certificate_alias -keystore my_keystore_file

        出力には、次のようにMD5またはSHA-256の値が含まれています。これがアプリ署名になります。

        MD5: 2E:0B:46:F8:D0:4A:06:AC:18:7A:2E:B0:42:95:58:FE

        SHA-256: 34:A3:65:30:3E:B2:9B:30:DD:10:E8:87:79:16:DF:4C:61:77:BC:1F:80:BD:3F:12:39:A3:31:E6:68:19:1C:6F

      • アプリが署名付きAPKの形式であり、Unix系システムで開発を行っている場合は、次のようなコマンドを実行できます。その際は、{your-app.apk}をAPKファイルの名前に置き換えてください。

        MD5:unzip -p {your-app.apk} META-INF/CERT.RSA | keytool -printcert | grep MD5

        SHA-256:unzip -p {your-app.apk} META-INF/CERT.RSA | keytool -printcert | grep SHA-256

        返されたMD5およびSHA-256の出力を使用します。

    • 実稼働版アプリでは、アプリ署名をリリースします。独自の証明書を使用してリリース版アプリに署名する場合は、その証明書のMD5およびSHA-256署名を指定して、追加のAPIキーを作成します。アプリへの署名をAmazonに任せる場合、リリース署名用APIキーの取得は不要です。

  9. [新しいキーを生成] をクリックします。