如何對 Amazon Q Business 中，「此應用程式未正確設定。請聯絡您的管理員尋求協助。」錯誤進行疑難排解？

簡短描述

如果您的 AWS IAM Identity Center 設定檔中的電子郵件地址缺失或不正確，您將收到錯誤訊息。Amazon Q Business 會使用電子郵件屬性來識別使用者，並驗證使用者的訂閱狀態。如果您未設定電子郵件屬性，Amazon Q Business 會限制您對應用程式的存取權。

跨網域身分管理系統 (SCIM) 從外部身分提供者 (IdP) 同步的使用者設定檔可能會錯誤地對應電子郵件屬性。檢查電子郵件屬性是否已對應到 IAM Identity Center。

當您的訂閱不完整或非作用中時，您也可能會收到錯誤訊息。如果您將使用者指派給 Amazon Q Business，請確認該使用者收到了電子郵件邀請並驗證了訂閱。

如果您沒有為使用者指派 Amazon Q Business 精簡版或專業版訂閱，請為該使用者指派所需的訂閱。

解決方法

**注意：**若要查看和變更 Amazon Q Business 使用者設定檔，您必須擁有足夠的權限和對 IAM Identity Center 的存取權。如果您在會員帳戶中使用 Amazon Q Business，請聯絡您的管理員以驗證和變更使用者設定檔。

確認 IAM Identity Center 中的電子郵件屬性

請完成下列步驟：

1. 開啟 IAM Identity Center console (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 console (Amazon Q Business 主控台)。
2. 在導覽窗格中，選擇 Applications (應用程式)。
3. 選取您的應用程式。
4. 在 User access (使用者存取權) 下，選擇 Manage user access (管理使用者存取權)，然後選擇 Add groups and users (新增群組和使用者)。
5. 選取您的使用者。
6. 選擇 Assign (指派)，然後選取 Q Business Lite (Q Business 精簡版) 或 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 console (Amazon Q Business 主控台)。在導覽窗格中，選擇 Applications (應用程式)，然後選取您的應用程式。在 Application settings (應用程式設定) 下，找到您的應用程式 ID。
• 部署 Amazon Q Business 的 AWS 區域
• IAM Identity Center 群組和使用者
• IAM 角色 ARN
• 在組織層級設定的權限
• 您在查詢 Amazon Q Business 時所建立的 HAR 檔案。