开发人员控制台

获取凭证


获取凭证

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

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

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

获取您的OAuth凭证和API密钥

若想获取凭证并在您的应用上使用ADM,

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

  2. 应用与服务 > 我的应用程序中,选择要对其使用ADM的应用。

  3. 单击Device Messaging

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

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

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

  7. 单击查看安全配置文件。然后在安全配置文件管理下,单击安卓/Kindle设置

  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

      • 或者,如果您使用的是Android Studio,请单击右侧的Gradle侧窗格并展开。然后点击android(这可能嵌套在应用程序 > 任务内),然后双击signingReport

        提供返回的MD5和SHA-256输出。

    • 发布应用签名适用于生产版本的应用。如果您使用自己的证书对发布版本的应用进行签名,请提供该证书的MD5和SHA-256签名以创建额外的API密钥。如果您允许亚马逊代表您对应用进行签名,则无需为发布签名获取API密钥。

  9. 单击生成新密钥

  10. 获取客户端凭证。这些是调用ADM服务器所必需的。

    • 安全配置文件管理下,单击Web设置。您在该页面可找到客户端ID客户端密钥