从自有应用创建 Alexa 账号关联（可选）

[English Version]

介绍

Alexa 账号关联 (Account Linking) 功能允许用户从自有应用中关联 Alexa 账号。启用该服务后，用户可以享受以下功能：

在自有应用中发现 Alexa Skill。
在自有应用中启用 Skill 和账号关联。
在已登录 Alexa 应用的情况下，无需输入账号密码即可链接到 Alexa 账号。在关联账号时，用户必须登录一次自有应用。
在未安装 Alexa 应用的情况下，使用 Login with Amazon (LWA) 即可从自有应用关联账号。

注意：如果您想要阅读开发文档，请参考从移动应用创建 App to App 账号关联。

前提条件

已完成 Alexa 与 ESP RainMaker 的集成。详细步骤请参考语音助手集成。

如果尚未完成，请按照语音助手集成中的步骤完成 Alexa 集成。完成后，请回到此处启用 App to App 账号关联。
已部署 ESP-RainMaker-3P-Integration-AddOns 仓库。

如果尚未部署，请参考部署 ESP_RainMaker-3P-Integrations-Addons SAR 仓库。

以下为配置 Alexa App to App 账号关联的具体步骤：

为移动应用创建重定向 URL

用户同意 Alexa 应用或 LWA 中的关联请求后，就能重定向至您的自有应用。为了实现重定向，需要为 iOS 应用创建通用链接 (Universal Link)，为安卓应用创建应用链接 (App Link)。

下文介绍了在 AWS S3 中托管通用链接和应用链接文件的步骤（注意：在进行以下操作前，请首先确保您的用户有管理权限）：

创建 S3 存储桶

前往 AWS 控制台，点击 Services > S3。
点击 Create bucket。
输入存储桶的名字。
选择需要创建存储桶的区域。
向下滚动界面，找到 Object Ownership，启用 ACLs enabled 选项。

Change Object Ownership settings

向下滚动界面，找到 Block Public Access settings for this bucket。
取消勾选 Block all public access，并勾选下面所有的选项。此步骤为必须步骤。

Disable Block Public Access setting

滚动至页面底部，点击 Create Bucket。
在存储桶列表中，点击新创建的存储桶。
点击 Create Folder 并创建 ".well-known" 文件夹。
勾选 .well-known 文件夹前面的复选框，并点击 Copy URL。
从 URL 中移除在第十步中记下的 .well-known/ 后缀。 请记下移除后的参数值，我们将其定义为 redirectURL，在后续步骤中需要用到。
创建安卓应用链接或 iOS 通用链接，请参考以下步骤：

上传文件至 S3 并设置公开读取权限

前往 AWS 控制台，点击 Services > S3。
在存储桶列表中，点击新创建的存储桶。
打开 .well-known 文件夹。
将文件上传至 S3 存储桶中的 .well-known 文件夹。

创建安卓应用链接时，上传前面小节中创建的 assetslinks.json 文件。
创建 iOS 通用链接时，上传前面小节中创建的 apple-app-site-association 文件。

注意，如果您希望同时为安卓和 iOS 上传文件，您需要按照第 5-10 步为两个文件分别完成设置。

向下滚动并点击 Permissions。

Object Permissions

选择 Grant public-read access 选项。

S3 ACLs

勾选下方知悉复选框。

S3 object public Acknowledgement

点击 Permissions 标签页。这一步骤中需要更改存储桶名称，请添加以下存储桶策略并保存更改。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::my-bucket-name/*"
        }
    ]
}

S3 bucket permissions

在页面底部点击 Upload。

为 RainMaker 配置回调 URL

用管理员账号登录 RainMaker 管理面板。
打开 Deployment Settings 标签页。
点击 Cognito Configurations。
找到名为 "esp-rainmaker-alexa-skill" 的 Cognito 应用客户端。
更新 esp-rainmaker-alexa-skill 客户端的回调 URL。将您在创建 S3 存储桶小节第 12 步中复制的 redirectURL 值添加到现有回调 URL 中。