Wie behebe ich das Problem „This application is not set up correctly. Please contact your admin for help.“ in Amazon Q Business?

Kurzbeschreibung

Wenn deine E-Mail-Adresse im AWS IAM Identity Center-Profil fehlt oder falsch ist, erhältst du eine Fehlermeldung. Amazon Q Business verwendet das E-Mail-Attribut, um Benutzer zu identifizieren und den Abonnementstatus des Benutzers zu überprüfen. Wenn du das E-Mail-Attribut nicht konfigurierst, schränkt Amazon Q Business den Zugriff auf die Anwendung ein.

Benutzerprofile, die System for Cross Domain Identity Management (SCIM) von einem externen Identitätsanbieter (IdP) synchronisiert, ordnen das E-Mail-Attribut möglicherweise falsch zu. Stelle sicher, dass das E-Mail-Attribut dem IAM Identity Center zugeordnet ist.

Möglicherweise erhältst du die Fehlermeldung auch, wenn du ein unvollständiges oder inaktives Abonnement hast. Wenn du Amazon Q Business einen Benutzer zugewiesen hast, vergewissere dich, dass der Benutzer die E-Mail-Einladung erhalten und das Abonnement bestätigt hat.

Wenn du einem Amazon Q Business Lite- oder Pro-Abonnement keinen Benutzer zugewiesen hast, weise dem Benutzer das erforderliche Abonnement zu.

Lösung

Hinweis: Um Amazon Q Business-Benutzerprofile anzeigen und ändern zu können, benötigst du ausreichende Berechtigungen und Zugriff auf das IAM Identity Center. Wenn du Amazon Q Business in einem Mitgliedskonto verwendest, wende dich an deinen Administrator, um das Benutzerprofil zu überprüfen und zu ändern.

Überprüfen des E-Mail-Attributs in IAM Identity Center

Führe die folgenden Schritte aus:

1. Öffne die IAM Identity Center-Konsole.
2. Wähle im Navigationsbereich Benutzer aus und wähle dann den Benutzer aus.
3. Prüfe im E-Mail-Attribut Folgendes:
   Wenn die E-Mail fehlt, füge eine gültige E-Mail-Adresse hinzu.
   Wenn die E-Mail falsch ist, aktualisiere die E-Mail-Adresse.
4. Wähle Speichern aus.
5. Melde dich bei Amazon Q Business an, um zu testen, ob das E-Mail-Attribut erfolgreich aktualisiert wurde.

Hinweis: Wenn du SCIM verwendest, um die Benutzer zu synchronisieren, überprüfe die IdP-Einstellungen, um sicherzustellen, dass das E-Mail-Attribut dem IAM Identity Center entspricht.

Abonnementstatus überprüfen

Wenn der Benutzer einen 404 ResourceNotFoundException-Fehler erhält, überprüfe, ob der Benutzer Amazon Q Business abonniert hat. Vergewissere dich, dass der Benutzer die Einladungs-E-Mail erhalten und bestätigt hat.

Wenn du IAM Identity Center verwendet hast, um den Benutzer hinzuzufügen, gehe wie folgt vor:

1. Öffne die Amazon Q Business-Konsole.
2. Wähle im Navigationsbereich Anwendungen.
3. Wähle deine Anwendung aus.
4. Wähle unter User access (Benutzerzugriff) die Option Manage user access (Benutzerzugriff verwalten) aus, und wähle dann Add groups and users (Gruppen und Benutzer hinzufügen) aus.
5. Wähle den Benutzer aus.
6. Wähle Zuweisen und dann entweder Q Business Lite oder Pro aus.

Hinweis: Es kann bis zu 24 Stunden dauern, bis Abonnementzuweisungen wirksam werden.

Überprüfen der IAM-Rollenberechtigungen für Amazon Q Business

Um Konversationen zu starten und zu verwalten, benötigst du bestimmte AWS Identity and Access Management (IAM, Identitäts- und Zugriffsmanagement)-Rollenberechtigungen.

Stelle sicher, dass die IAM-Rolle, die Amazon Q Business zugewiesen ist, die folgende Rollenrichtlinie enthält:

{
  "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}}"
    }
  ]
}

Stelle sicher, dass die IAM-Rolle die folgende Vertrauensrichtlinie enthält:

{
  "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}}"
        }
      }
    }
  ]
}

Wenn das Problem weiterhin auftritt, wende dich an den AWS-Support.

Gib in deiner Anforderung die folgenden Informationen an:

• Anwendungs-ID
  Hinweis: Um die Anwendungs-ID zu finden, öffne die Amazon Q Business-Konsole. Wähle im Navigationsbereich Applications (Anwendungen) und dann deine Anwendung aus. Suche unter Application settings (Anwendungseinstellungen) nach der Anwendungs-ID.
• AWS-Region, in der du Amazon Q Business bereitstellst
• IAM Identity Center-Gruppe und -Benutzer
• IAM-Rollen-ARN
• Auf Organisationsebene eingerichtete Berechtigungen
• HAR-Datei, die du erstellst, wenn du Amazon Q Business abfragst.