获取凭证


获取凭证

要使用 Amazon Device Messaging (ADM),您必须能够向 Amazon 唯一标识您的应用。Amazon 为您提供了凭证来实现此目的:

  • API 键。 ADM 使用 API 键验证您应用的身份。
  • OAuth 凭证(“客户端 ID”和“客户端密钥”)。 ADM 使用 OAuth 凭证来验证您服务器的身份。您的服务器将提供这些凭证获取使用 ADM 发送消息的访问令牌。

有关使用 OAuth 凭证和 API 键的更多信息,请参阅概览集成您的应用请求访问令牌

获取您的 OAuth 凭证和 API 键

获取凭证并允许您的应用使用 ADM

  1. 在亚马逊应用和游戏开发者门户上创建一个账户,然后添加您的应用(如果尚未添加)。

  2. Apps & Services(应用和服务)> My Apps(我的应用)中,选择要对其使用 ADM 的应用。

  3. 单击 Device Messaging

  4. 如果您已向应用分配安全配置文件,请继续执行步骤 7。

  5. 要向您的应用分配安全配置文件,请从 Select a Security Profile(选择安全配置文件)中选择一个现有的安全配置文件,或者单击 Create a New Security Profile(创建新的安全配置文件)。安全配置文件提供通过 ADM 发送消息时您所使用的 OAuth 凭证。

  6. 如果您使用了现有的安全配置文件,请务必选择 Confirm(确认)以保存所做更改。

  7. 单击 View Security Profile(查看安全配置文件)。然后,单击 Kindle/Android Settings(Kindle/Android 设置)。

  8. 创建 API 键。您的应用需要一个或多个 API 键。

    • (必需)适用于预发布或“调试”版本的应用。 在所有情况下,您必须为调试版本的应用创建一个 API 键,以便测试应用使用 ADM 的情况。

    • (可选)适用于正式发布或“生产”版本的应用。 如果您使用自己的证书对发布版本的应用进行签名,您必须为该应用创建一个额外的 API 键。如果您允许亚马逊代表您对应用进行签名,则无需创建额外的 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 键。如果您允许亚马逊代表您对应用进行签名,则无需为发行签名获取 API 键。

  9. 单击 Generate New Key(生成新键)。