Comment résoudre le problème « This application is not set up correctly. Please contact your admin for help. « (Cette application n'est pas configurée correctement. Contactez votre administrateur pour obtenir de l'aide.) dans Amazon Q Business ?

Brève description

Si votre adresse e-mail est manquante ou incorrecte dans votre profil AWS IAM Identity Center, vous recevez un message d'erreur. Amazon Q Business utilise l'attribut e-mail pour identifier les utilisateurs et vérifier leur statut d'abonnement. Lorsque vous ne configurez pas l'attribut d’e-mail, Amazon Q Business restreint l'accès à l'application.

Les profils utilisateur que le système SCIM (System for Cross-Domain Identity Management) synchronise à partir d'un fournisseur d'identité externe (IdP) peuvent ne pas correspondre correctement à l'attribut d’e-mail. Vérifiez que l'attribut d’e-mail correspond à IAM Identity Center.

Vous pouvez également recevoir le message d'erreur lorsque votre abonnement est incomplet ou inactif. Si vous avez attribué un utilisateur à Amazon Q Business, confirmez que l'utilisateur a reçu l'invitation par e-mail et a vérifié son abonnement.

Si vous n'avez pas attribué d'abonnement Amazon Q Business Lite ou Pro à un utilisateur, attribuez-lui l'abonnement requis.

Résolution

Remarque : Pour consulter et modifier les profils utilisateur Amazon Q Business, vous devez disposer d'autorisations et d'un accès suffisants à IAM Identity Center. Si vous utilisez Amazon Q Business dans un compte membre, contactez votre administrateur pour vérifier et modifier le profil utilisateur.

Vérifier l'attribut d’e-mail dans IAM Identity Center

Procédez comme suit :

1. Ouvrez la console IAM Identity Center.
2. Dans le volet de navigation, sélectionnez Utilisateurs, puis sélectionnez l’utilisateur.
3. Vérifiez les éléments suivants dans l'attribut d’e-mail :
   Si l'adresse e-mail est manquante, ajoutez une adresse e-mail valide.
   Si l'adresse e-mail est incorrecte, mettez-la à jour.
4. Sélectionnez Enregistrer.
5. Connectez-vous à Amazon Q Business pour vérifier si l'attribut d'e-mail a été correctement mis à jour.

Remarque : Si vous utilisez SCIM pour synchroniser vos utilisateurs, vérifiez les paramètres de l'IdP pour vous assurer que l'attribut d’e-mail correspond à IAM Identity Center.

Vérifier le statut de l'abonnement

Si l'utilisateur reçoit une erreur 404 ResourceNotFoundException, vérifiez qu'il est abonné à Amazon Q Business. Vérifiez que l'utilisateur a reçu et vérifié l'e-mail d'invitation.

Si vous avez utilisé IAM Identity Center pour ajouter l'utilisateur, procédez comme suit :

1. Ouvrez la console Amazon Q Business.
2. Dans le volet de navigation, sélectionnez Applications.
3. Sélectionnez votre application.
4. Sous Accès utilisateur, choisissez Gérer l'accès utilisateur, puis choisissez Ajouter des groupes et des utilisateurs.
5. Sélectionnez votre utilisateur.
6. Choisissez Attribuer, puis sélectionnez Q Business Lite ou Pro.

Remarque : Les attributions d'abonnement peuvent prendre jusqu'à 24 heures pour prendre effet.

Vérifier les autorisations de rôle IAM pour Amazon Q Business

Pour démarrer et gérer des conversations, vous devez disposer d'autorisations de rôle AWS Identity and Access Management (IAM) spécifiques.

Vérifiez que le rôle IAM attribué à Amazon Q Business inclut la politique de rôle suivante :

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

Vérifiez que le rôle IAM inclut la politique d’approbation suivante :

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

Si le problème persiste, contactez AWS Support.

Dans votre requête, incluez les informations suivantes :

• ID d’application
  Remarque : Pour localiser votre ID d’application, ouvrez la console Amazon Q Business. Dans le volet de navigation, choisissez Applications, puis sélectionnez votre application. Dans Paramètres de l'application, recherchez l'ID de votre application.
• Région AWS dans laquelle vous déployez Amazon Q Business
• Groupe et utilisateur IAM Identity Center
• ARN du rôle IAM
• Autorisation définie au niveau de l'organisation
• Fichier HAR que vous créez lorsque vous interrogez Amazon Q Business.