注册Login with Amazon
您必须先为应用注册Login with Amazon,才能在此Android应用中使用Login with Amazon。Login with Amazon应用注册包含您的基本业务信息,以及由您创建并支持Login with Amazon的网站或移动应用信息。每当用户在您的网站或移动应用使用Login with Amazon登录,都将向其显示业务信息。用户将看到应用名称、标志和隐私政策链接。
- 创建新的安全配置文件
- 为Login with Amazon启用现有的安全配置文件
- 为您的安全配置文件添加已注册的亚马逊应用商店应用或开发者控制台应用
- 为您的安全配置文件添加Android设置
- Android应用签名和API密钥
- 删除安全配置文件
创建新的安全配置文件
如果您已在亚马逊开发者控制台创建安全配置文件,可以跳过本节。
-
访问https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html。您需要登录到处理Login with Amazon应用注册的开发者控制台。如果这是您首次使用开发者控制台,系统会要求您创建一个账户。
-
单击创建新的安全配置文件。之后您将转到“安全配置文件管理”页面。
-
输入安全配置文件名称,并为您的安全性配置文件添加安全配置文件描述。安全配置文件将关联一个或多个相关应用的用户数据和安全凭证。Name是用户同意与您的应用分享信息后,将在同意界面显示的名称。此名称适用于Android、iOS和网站版本的应用。
-
您必须输入为应用输入同意隐私声明URL。隐私声明URL为您的公司或应用隐私政策的位置(例如,http://www.example.com/privacy.html)。用户将在同意界面中看到此链接。此链接适用于Android、iOS和网站版本的应用。
-
如果您想要为应用添加同意徽标图像,请单击上传图片。登录和同意界面将显示此徽标来表示您的业务或网站。此链接适用于Android、iOS和网站版本的应用。徽标高度不得超过50像素,高于50像素将缩减为50;徽标宽度则没有限制。
-
-
单击保存。您的安全配置文件应与下图类似:
为Login with Amazon启用现有的安全配置文件
如果您已按照上文“创建新的安全配置文件”进行操作,可跳过本节。按照上述说明创建的安全配置文件已启用Login with Amazon。
-
访问https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html。您需要登录到开发者控制台。
-
单击Select a security profile(选择安全配置文件),然后从下拉菜单中选择您的安全配置文件。
-
单击右侧的确认按钮。
-
您必须在随即出现的表格中输入同意界面信息。
-
您必须输入为应用输入同意隐私声明URL。隐私声明URL为您的公司或应用隐私政策的位置(例如,http://www.example.com/privacy.html)。用户将在同意界面中看到此链接。此链接适用于Android、iOS和网站版本的应用。
-
如果您想要为应用添加同意徽标图像,请单击上传图片。登录和同意界面将显示此徽标来表示您的业务或网站。此链接适用于Android、iOS和网站版本的应用。徽标高度不得超过50像素,高于50像素将缩减为50;徽标宽度则没有限制。
-
单击保存。屏幕刷新后,将在确认按钮下方显示一条消息,如下所述: “已经为安全配置文件成功启用用亚马逊帐户登录。”
为您的安全配置文件添加已注册的亚马逊应用商店应用或开发者控制台应用
如果您的应用已在 https://developer.amazon.com/myapps.html进行注册,您可以将其添加到安全配置文件,以启用Login with Amazon。
否则,您可以跳过此步骤并继续为您的安全配置文件添加Android设置。
- 访问 https://developer.amazon.com/myapps.html。
- 从列表中选择您的应用。之会您将转到应用的基本信息选项卡。
- 单击选项卡顶部列表中的Login with Amazon。
-
在下拉菜单中选择安全配置文件,并关联您的应用。单击确认。
为您的安全配置文件添加Android设置
在开发者控制台创建安全配置文件后,您可以为此配置文件添加要使用Login with Amazon的网站和移动应用设置。要启用适用于Android的Login with Amazon,必须为应用项目指定程序包名称和签名。Login with Amazon将使用这些值生成API密钥API密钥。API密钥将授权您的应用访问Login with Amazon授权服务授权服务。按照以下步骤为您安全配置文件添加Android设置:
- 访问 https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html。
- 转到要用于应用的安全配置文件。
- 在表中找到要修改的安全配置文件。
- 将鼠标指针悬停在管理一栏中显示的
按钮上。
- 选择Kindle/Android设置菜单项。
注意: 如果表中没有显示您所需的安全配置文件,说明该文件尚未启用Login with Amazon。这种情况下,通过表格上方的下拉菜单,前往Select a Security Profile,然后单击确认。您需要输入同意隐私声明URL,并根据需要选择同意徽标图像,二者都将在登录和同意界面中显示。如果您的应用还没有安全配置文件,请参阅注册您的安全配置文件。
- 输入您的应用用来进行Login with Amazon身份验证的API密钥名称。不一定要使用官方应用名。此名称只用来标识特定的Android应用,以便与安全配置文件中注册的其他应用和网站进行区分。
- 输入您的软件包名称。必须与Android项目的程序包名称匹配。要确定Android项目的程序包名称,可以在Android Studio中打开项目。双击Project View(项目视图)中的
AndroidManifest.XML
打开文件,然后选择Manifest(清单)选项卡。软件包名称位于顶部。 - 输入应用签名。签名包括用于验证应用的MD5和SHA-256哈希值。MD5签名必须为16个十六进制对,并以冒号分隔(例如:
01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef
);SHA-256签名必须为32个十六进制,并以冒号分隔(例如:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef
).有关更多信息,请参阅Android应用签名和API密钥,了解从项目中提取签名的具体步骤。 - 单击生成新密钥。
Android应用签名和API密钥
应用签名是每个Android应用在构建阶段所应用的哈希值。亚马逊构建API密钥将同时使用MD5和SHA-256应用签名。API密钥让亚马逊服务能够识别您的应用。请参阅创建Login with Amazon项目,了解如何为项目添加API密钥。
应用签名存储于密钥库。对于Android应用来说,通常存在一个调试密钥库和一个发布密钥库。要在Android Studio中查找调试密钥库的位置,请打开Build(构建)菜单,选择Edit Build Types(编辑构建类型),然后转至Signing(签署)选项卡,找到Store File(存储文件)字段中的调试密钥库。
通常情况下,导出Android应用以创建已签名的APK文件时,将同时创建发布密钥库。导出过程中,如果正在创建新的发布密钥库,则要为其选择位置。默认情况下,发布密钥库所在位置与调试密钥库的默认放置相同。
如果在开发过程中使用调试签名来注册应用,则必须在应用发布就绪时,为您的应用添加新的Android设置。新的应用设置必须使用发布密钥库中的签名。
请在developer.android.com中参阅签署您的应用,了解更多信息。
确定Android应用签名
- 如果已有签名的APK文件:
- 解压缩此APK文件并提取
CERT.RSA
。(如有必要,可以在压缩时重命名APK扩展名)。 -
在命令行中,运行:
keytool -printcert -file CERT.RSA
Keytool
位于Java安装下的bin
目录。
- 解压缩此APK文件并提取
- 如果已有密钥库文件:
-
在命令行中,运行:
keytool -list -v -alias <alias> -keystore <keystore.filename>
Keytool
位于Java安装下的bin
目录。密钥别名是用于签署应用的密钥名称。 -
输入密码,然后按下回车键。
-
- 复制Certificate Fingerprint下的MD5和SHA-256哈希值。
检索Android API密钥
Android设置注册完成并提供应用签名后,您可以在注册页面检索Login with Amazon应用的API密钥。您需要将此API密钥导入Android项目文件夹。只有完成此项操作后,应用才有权与Login with Amazon授权服务通信。
- 访问 https://developer.amazon.com/loginwithamazon/console/site/lwa/overview.html。
- 转到要用于应用的安全配置文件。
- 在表中找到要修改的安全配置文件。
- 将鼠标指针悬停在管理一栏中显示的
按钮上。
- 选择Kindle/Android设置菜单项。
-
在密钥列表中找到API密钥名称,然后在相关密钥栏中单击显示。复制弹出窗口显示API密钥。
注意: API密钥在部分程度上以生成时间为基础。因此,后续生成的API密钥可能与初始密钥不同。您可以在应用中使用任何一个有效的API密钥。要删除或编辑密钥,您可以将鼠标指针悬停
图标,然后选择Edit(编辑)或Delete(删除)。要还原误删的密钥,可以单击显示已删除的API密钥,然后在想要还原的密钥名称旁边单击还原。
- 请参阅为您的项目添加API密钥,了解如何为Android应用添加API密钥。
删除安全配置文件
如有需要,可以删除任何与亚马逊应用商店分发无关的应用的安全配置文件。导航到安全配置文件管理页面,选择一项配置文件,然后单击删除安全配置文件。显示确认表格。在文本字段中键入delete,然后单击删除确认操作。
如果误删安全配置文件,可以在安全配置文件管理页面中进行恢复。单击显示最近删除的安全配置文件按钮,再单击您想要恢复的配置文件名称,然后单击还原安全配置文件。显示确认表格。单击还原按钮来还原安全配置文件,包括其Web、Android/Kindle和iOS设置。