Configurer rôle IAM avec les autorisations de l’application Amazon Lex

Conditions préalables

Pour accéder aux bots Amazon Lex, Genesys Cloud doit avoir l’autorisation d’utiliser les ressources d’Amazon Web Services (AWS). Cette procédure explique comment configurer un IAM rôle dans AWS. Ce rôle est attribué à Amazon Lex ultérieurement, lorsque vous configurez et activez l’application dans Genesys Cloud.

Remarque :  IAM (AWS Identity and Access Management) est un service Web qui contrôle l’accès aux ressources AWS. Un IAM rôle est utilisateur similaire à un , parce qu’il définit une identité AWS avec autorisation des stratégies qui déterminent ce que l’identité peut et ne peut pas faire dans AWS. Un rôle IAM peut être assumé par des identités de confiance, y compris des applications telles que Genesys Cloud, des services AWS tels que EC2 ou un utilisateur final. Chaque IAM rôle définit les autorisations nécessaires pour faire des demandes de service AWS. Pour plus d’informations, voir Rôles IAM dans le guide utilisateur AWS Identity and Access Management d’Amazon.

Configurer rôle IAM avec les autorisations de l’application Amazon Lex

Pour configurer l’utilisation, suivez les étapes suivantes :

  1. Connectez-vous à AWS.
  2. Accédez au Services AWS page.
  3. Sélectionner JE SUIS.
  4. Sous Tableau de bord, sélectionnez Rôles.
  5. Sur le Rôles page, cliquez sur créerrôle.
  6. Sélectionner Un autre compte AWS comme type d’entité de confiance.
  7. Dans la zone ID du compte, entrez 765628985471 dans la zone ID du compte.765628985471 Il s’agit de l’ID de compte de production de Genesys Cloud. Si vous avez besoin de l'identifiant de compte de la région FedRAMP (US-East-2), veuillez contacter votre représentant Genesys.
  8. Pour renforcer la sécurité, Genesys vous recommande de cocher la case Require External ID et de saisir l'identifiant de votre organisation Genesys Cloud .
  9. Cliquez sur Autorisations suivantes.
  10. Ensuite, affectez les règles autorisation à rôle. Dans la zone rechercher, tapez Lex. Puis sélectionnez le AmazonLexReadOnly et AmazonLexRunBotsOnly politiques cases à cocher.
    • AmazonLexReadOnly fournit un accès en lecture seule à Amazon Lex, ce qui permet à rôle d’examiner les robots Lex.
    • La stratégie AmazonLexRunBotsOnly fournit un accès aux API de conversation Amazon Lex, de sorte que l’audio puisse être envoyé à exc récupérer.
      Remarque :  Ces autorisations font ne pas donnez à Genesys Cloud possibilité de modifier vos bots Lex.
  11. Cliquez sur Suivant Mots clés.
  12. (Facultatif) Ajoutez des métadonnées à rôle en attachant des balises sous forme de paires clé-valeur. Pour plus d’informations, voir Marquage des entités AIM dans le Guide de l’utilisateur AWS Identitiy and Access Management.
  13. Cliquez sur Suivant La revue…
  14. dans le Nom de rôle boîte, tapez un nom. Par exemple, DemoLexRole.
  15. dans le Description du rôle Dans la boîte, entrez un texte descriptif sur le rôle
  16. Vérifiez que le numéro de compte pour Entités de confiance correspond à l’ID de compte de production Genesys Cloud vous avez entré à l’étape 6.
  17. Cliquez sur Créer un rôle.
  18. Dans la page de liste, cliquez sur le nom de rôle. Ce lien est le nom que vous avez entré dans le Nom de rôle case à l'étape 12. Détails sommaires rôle sur la comparution.
  19. Noter la Rôle ARN. Vous avez besoin de cette information d’identification plus tard. Un Nom de ressource Amazon (ARN) est un identifiant unique qui identifie sans ambiguïté une ressource.
  20. Cliquez sur l'icône Copie (à la droite du rôle ARN) pour copier votre ARN dans le Presse-papiers. 

    Créez une stratégie Lex V2 et attribuez-la à votre rôle IAM

    Créez une stratégie Lex V2 au format JSON dans la console AWS, puis attribuez-la à votre rôle IAM. Cette politique garantit que Genesys Cloud Architect peut interagir avec un bot Amazon Lex V2.

    1. Connectez-vous à AWS Management Console et ouvrez le Console IAM.
    2. Dans le volet de navigation sur le côté gauche, cliquez sur Stratégies.
    3. Cliquez sur Créer une politique.
    4. Cliquez sur l'onglet SSO.
    6. Type or paste the following JSON content: 
      {
           "Version": "2012-10-17",
           "Statement": [
                {
                     "Sid": "VisualEditor0",
                     "Effect": "Allow",
                     "Action": [
                          "lex:List*",
                          "lex:Describe*",
                          "lex:StartConversation"
                     ],
                     "Resource": "*"
                }
           ]
      }
    7. Résolvez les avertissements de sécurité, les erreurs ou les avertissements généraux générés par la validation de la stratégie, puis cliquez sur Réviser la politique.
      Remarque :  Vous pouvez basculer entre l'éditeur visuel et les onglets JSON à tout moment. Cependant, si vous apportez des modifications ou choisissez Suivant : Balises dans l'onglet Éditeur visuel, IAM peut restructurer votre stratégie pour l'optimiser pour l'éditeur visuel.
        
    8. Cliquez sur Suivant Mots clés.
    9. (Facultatif) Ajoutez des métadonnées à rôle en attachant des balises sous forme de paires clé-valeur. 
    10. Sur le Réviser la politique page, tapez un Nom et un La description (facultatif) pour la police. Consultez le résumé de la stratégie pour voir les autorisations que votre stratégie accorde.
    11. Cliquez sur Créer une politique.
    12. Après avoir créé une stratégie, attachez-le à votre rôle IAM.

    Suivant : Configurer et activer l’intégration Lex dans Genesys Cloud