如何解决 Amazon Q Business 中的错误“This application is not set up correctly.Please contact your admin for help.”（此应用程序设置不正确。请联系您的管理员寻求帮助。）？

简短描述

如果您的电子邮件地址在 AWS IAM Identity Center 配置文件中缺失或不正确，则您会收到一条错误消息。Amazon Q Business 使用电子邮件属性来识别用户并验证用户的订阅状态。当您未配置电子邮件属性时，Amazon Q Business 会限制对应用程序的访问权限。

跨域身份管理系统 (SCIM) 从外部身份提供者 (IdP) 同步的用户配置文件可能会错误地映射电子邮件属性。检查电子邮件属性是否映射到 IAM Identity Center。

当您的订阅不完整或无效时，您也可能会收到错误消息。如果您向 Amazon Q Business 分配了用户，请确认该用户已收到电子邮件邀请并验证订阅。

如果您没有为用户分配 Amazon Q Business Lite 或 Pro 订阅，请为该用户分配所需的订阅。

解决方法

**注意：**要查看和更改 Amazon Q Business 用户配置文件，您必须拥有对 IAM Identity Center 的足够权限和访问权限。如果您在成员账户中使用 Amazon Q Business，请联系您的管理员以验证和更改用户配置文件。

验证 IAM Identity Center 中的电子邮件属性

完成以下步骤：

1. 打开 IAM Identity Center 控制台。
2. 在导航窗格中，选择 Users（用户），然后选择该用户。
3. 在电子邮件属性中检查以下内容：
   如果电子邮件缺失，请添加有效的电子邮件地址。
   如果电子邮件不正确，请更新电子邮件地址。
4. 选择 Save（保存）。
5. 登录 Amazon Q Business 以测试电子邮件属性是否成功更新。

**注意：**如果您使用 SCIM 同步用户，请检查 IdP 设置以确保电子邮件属性映射到 IAM Identity Center。

检查订阅状态

如果用户收到 404 ResourceNotFoundException 错误，请检查用户是否订阅了 Amazon Q Business。确认用户已收到并验证邀请电子邮件。

如果您使用 IAM Identity Center 添加用户，请完成以下步骤：

1. 打开 Amazon Q Business 控制台。
2. 在导航窗格中，选择 Applications（应用程序）。
3. 选择您的应用程序。
4. 在 User access（用户访问权限）下，选择 Manage user access（管理用户访问权限），然后选择 Add groups and users（添加组和用户）。
5. 选择您的用户。
6. 选择 Assign（分配），然后选择 Q Business Lite 或 Pro。

**注意：**订阅任务最多需要 24 小时才能生效。

验证 Amazon Q Business 的 IAM 角色权限

要开始和管理对话，您必须拥有特定的 AWS Identity and Access Management (IAM) 角色权限。

检查分配给 Amazon Q Business 的 IAM 角色是否包含以下角色策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "QBusinessConversationPermission",
      "Effect": "Allow",
      "Action": [
        "qbusiness:Chat",
        "qbusiness:ChatSync",
        "qbusiness:ListMessages",
        "qbusiness:ListConversations",
        "qbusiness:GetWebExperience",
        "qbusiness:GetApplication",
        "qbusiness:PutFeedback",
        "qbusiness:DeleteConversation"
      ],
      "Resource": "arn:aws:qbusiness:{{region}}:{{source_account}}:application/{{application_id}}"
    }
  ]
}

检查 IAM 角色是否包含以下信任策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "QBusinessTrustPolicy",
      "Effect": "Allow",
      "Principal": {
        "Service": "application.qbusiness.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{source_account}}"
        },
        "ArnEquals": {
          "aws:SourceArn": "arn:aws:qbusiness:{{region}}:{{source_account}}:application/{{application_id}}"
        }
      }
    }
  ]
}

如果仍然遇到问题，请联系 AWS Support。

在您的请求中包括以下信息：

• 应用程序 ID
  **注意：**要找到您的应用程序 ID，请打开 Amazon Q Business 控制台。在导航窗格中，选择 Applications（应用程序），然后选择您的应用程序。在 Application settings（应用程序设置）下，找到您的应用程序 ID。
• 您部署 Amazon Q Business 的 AWS 区域
• IAM Identity Center 组和用户
• IAM 角色 ARN
• 在组织级别设置的权限
• 您在查询 Amazon Q Business 时创建的 HAR 文件。