- 将第三方应用用户的账户与亚马逊账户关联。
- 为第三方应用的用户获取现有链接。
- 对第三方应用用户显示带有选项的选择界面以进行登录。
- 记录业务指标。
开始使用
设置
- 将以下库依赖项添加到package.json文件的
dependencies部分。
-
在您的manifest.toml中,添加以下权限。
这些权限提供对以下事项的访问权限:
- 简单登录系统服务的访问权限。
- 允许显示征求用户同意的屏幕。
- 允许向用户显示登录选项的屏幕。
用法
以下部分介绍如何使用简单登录执行账户关联以及让用户登录。GetUserAndLinks
以下示例发起请求,要求在您的应用所在的设备上,为当前活跃的亚马逊用户提取与简单登录相关的数据。LinkUserAccount
以下示例中,为用户的应用账户启动了账户关联。该示例允许在亚马逊和应用账户之间进行N:N映射。可以有多个应用账户同时与一个亚马逊账户关联,一个应用账户可以关联多个亚马逊账户。ShowLoginSelection
以下示例中,打开了一个对话框,向用户显示登录选项。在调用此方法之前,获得每个关联账户的易于用户识别的标识符,并将该标识符添加到请求中。要检索标识符,请调用getUserAndLinks() 方法。用户可识别的标识符包括登录名、电子邮件地址或个人资料名称。该代码在屏幕上显示这些标识符,以帮助客户轻松识别关联的应用账户。
RecordMetricEvent
以下示例触发一个为发布指标而记录的事件。可以在开发者控制台的报告选项卡中下载简单登录业务指标报表。利用这些指标,可以深入了解与简单登录集成的业务价值和影响。实现登录流程
在实现登录流程之前,您需要身份提供者名称 (IDP_NAME),该名称是在应用的引入过程中在开发者控制台中提供的。这个唯一标识符将您的应用连接到简单登录服务。
开始使用登录
登录过程通常在以下情况下开始:- 应用启动时
- 用户单击登录按钮
- 会话需要身份验证
GetUserAndLinks() 方法实现基本登录流程。
账户关联流程
成功进行标准登录后,您应该关联用户的账户,以便为将来的会话启用无缝登录。此过程在用户的亚马逊账户和您的应用的账户之间建立安全连接。 以下示例使用应用的标准登录方法将用户账户关联到您的应用。 用户每次使用应用的标准登录流程登录时,都会调用LinkUserAccount() 方法。
故障排除
-
未显示同意屏幕或登录选择屏幕。\
确保您的清单已更新。
-
API调用在请求状态中返回
FEATURE_TURNED_OFF。 用户已在账户级别、设备级别或针对您的应用禁用了简单登录功能。 -
API调用在请求状态中返回
NOT_AVAILABLE。 简单登录功能在设备运行时所在的区域不可用。
API参考
类
- SimpleSignService—提供与亚马逊简单登录框架进行交互的主要API。
枚举
- FailureReason—表示发出指标失败的原因。
- LinkAccountSuccessCode—表示关联用户账户操作的成功代码。
- RequestStatus—表示向SSI API发出的请求状态。
- SSIEvent—表示可以发布指标的SSI事件。
- UserSelection—表示用户在登录选择屏幕所选的选项类型。
类型别名
- GetUserAndLinksResponse—版权所有2026 Amazon.com, Inc.或其关联公司。保留所有权利。
- Link—第三方应用生成的关联的信息。
- LinkUserAccountRequest—表示调用SimpleSignInService.LinkUserAccount 的请求。
- LinkUserAccountResponse—表示SimpleSignInService.LinkUserAccount的调用结果。
- LoginNameValue—表示用户登录名和关联ID的映射。
- RecordMetricsEventResponse—表示SimpleSignInService.RecordMetricEvent调用的响应。
- ShowLoginSelectionResponse—表示SimpleSignInService.ShowLoginSelection调用的响应。
- SSIEventRequest—表示调用SimpleSignInService.RecordMetricevent的请求。
- Token—表示使用的令牌和架构。

