Gérer Kafka Data Streams

Autorisations requises : Data Streams

Cette Page vous aide à configurer un flux de données Kafka et à vous y abonner. NiCE CXone fournit les journaux IVRClosed Réponse vocale interactive. Menu téléphonique automatisé que les contacts utilisent par la Voix ou par des touches pour obtenir des informations, acheminer un appel vocal entrant, ou les deux. sous forme de flux, vous devez donc configurer une méthode de consommation des données à une Destination que vous contrôlez. Une configuration complète comprend les étapes de configuration dans NiCE CXone, ainsi que la configuration du service ou du système qui s'abonnera au flux et le consommera.

Lors de la configuration du flux dans NiCE CXone, vous pouvez choisir de consommer les données selon les formats de schéma suivants :

  • PROTO
  • JSON
  • AVRO
  • JSON avec saut de ligne
  • JSON AVRO avec saut de ligne

Configurer un Flux de données Kafka

Tout d'abord, planifiez la manière dont vous utiliserez le flux Kafka. Vous devez disposer des ressources techniques nécessaires pour créer une destination capable de s'abonner au flux. Cela nécessite de respecter les exigences de sécurité :

  • Fourniture des CIDR IPv4 que vous souhaitez utiliser pour accéder aux sujets Kafka. Cela garantit à NiCE CXone que vos adresses IP sont légitimes et autorisées. Vous pouvez ajouter deux CIDR IP à la fois.

  • Une méthode d'authentification permettant d'utiliser les informations d'identification nom d’utilisateur et mot DE passe de NiCE CXone.

Créer un Flux de données Kafka dans NiCE CXone

Les instructions suivantes vous aident à créer un flux de données, à générer un ensemble d'informations d'identification et à ajouter les CIDR IP que vous utiliserez pour vous abonner au flux de données.

  1. Cliquez sur le sélecteur d'applications icon of app selector et sélectionnez Admin.
  2. Accédez à Paramètres du compte > Event Data Stream.

  3. Cliquez sur Créer un nouveau Flux de données.

  4. Entrez le nom du flux de données et, le cas échéant, une Description.

  5. Sélectionnez IVR Log comme Type d’événement.

  6. Pour Format des données, sélectionnez le format de schéma dans lequel vous souhaitez que les données soient.

  7. Pour type DE flux Cible, sélectionnez Kafka Externe.

  8. Générez un ensemble d'informations d'identification. Il s'agit du nom d'utilisateur et du mot DE passe que vous pouvez utiliser pour vous abonner au flux Kafka.

    1. Cliquez sur Gérer dans la section Security de la page New Data Stream ; une fenêtre du gestionnaire de Sécurité s'ouvre.

    2. Pour Alias, entrez un nom unique pour l'ensemble d'identifiants. Vous devez entrer au moins six caractères alphanumériques. Les seuls caractères spéciaux autorisés sont un tiret (-) ou un trait de soulignement (_).

      Vous ne pouvez disposer que d'un seul ensemble d'identifiants pour un flux de données à la fois. Si nécessaire, supprimez les identifiants existants avant d'en créer un nouvel ensemble.

    3. Cliquez sur Create and Download. Cette action télécharge le nom d’utilisateur et le mot DE passe sous forme de Fichier csv.

  9. Dans la même fenêtre du gestionnaire de sécurité, faites défiler vers le bas et saisissez les CIDR IP que vous souhaitez utiliser pour le flux de données :

    1. Faites défiler jusqu'à la Section Allowed IP CIDRs.

    2. Pour IP CIDR, entrez le CIDR complet des Adresses IP par le biais desquelles vous souhaitez vous abonner. Veillez à inclure à la fois l'Adresse IP et le masque de sous-réseau pour l'adresse CIDR complète. Vous pouvez entrer plusieurs CIDR à la fois, séparés par une virgule.

      • Vous ne pouvez disposer que de deux ensembles de CIDR IP pour un flux de données à la fois. Vous pouvez supprimer un CIDR IP si nécessaire.
      • Data Streams prend actuellement en charge IPv4.
      • La plage maximum autorisée est comprise entre /24 et /32.

    3. Cliquez sur OK.

  10. Cliquez sur Créer.

Après la création du flux de données, les Détails du flux s'affichent en bas de la page. Cela inclut les Détails du courtier, l'id de groupe consommateur et le nom de la rubrique. Vous pouvez les utiliser pour configurer votre service ou système qui consommera les données.

Par ailleurs, le flux de données devient généralement actif immédiatement après sa création. Au maximum, cela peut prendre 15-30 minutes.

Configurer une Destination pour s'abonner au flux Kafka

Dans votre propre Kafka destination , vous devez insérer les détails du courtier de flux que vous avez générés dans la section précédente. Votre équipe technique doit faire appel à son expertise pour ce faire.

Supprimer les Identifiants Kafka

Pour des raisons de {sécurité}, vous pouvez souhaiter ou devoir remplacer un ensemble d'identifiants. Dans NiCE CXone, vous avez la possibilité d'effectuer un effacement doux ou un effacement dur d'un ensemble d'identifiants. L'effacement doux signifie que les identifiants deviennent inactifs pendant deux jours, après quoi ils sont complètement supprimés. Cela vous laisse le temps de générer un nouvel ensemble d'identifiants et de les mettre en œuvre pour votre abonnement Kafka. Un effacement dur est une suppression immédiate.

  1. Cliquez sur le sélecteur d'applications icon of app selector et sélectionnez Admin.
  2. Accédez à Paramètres du compte > Flux de données d'Événement.
  3. Sélectionnez le flux de données souhaité.
  4. Dans la Section Sécurité où vos alias d'identifiant sont répertoriés, cliquez sur Gérer.
  5. Cliquez sur l'icône supprimer dans la colonne Action pour les identifiants que vous souhaitez supprimer. Une Notification de confirmation s'affiche.
  6. Choose whether you want to soft delete or hard delete the credentials:
    • Pour effectuer une suppression réversible, confirmez la suppression. L'icône État passe au jaune. Après deux jours, les identifiants seront supprimés de façon permanente.
    • Pour effectuer un effacement dur, activez la case à cocher afin de supprimer les identifiants immédiatement, puis confirmez la suppression.

Résolution des problèmes liés à Kafka Data Streams

Si votre abonnement au flux de données ne fonctionne pas correctement, vérifiez les points suivants :

  • Vous avez saisi les informations correctes relatives au courtier dans le système abonné au flux. Vous pouvez les trouver dans NiCE CXone, dans la section Détails du flux des détails du flux de données.

  • Les détails du flux de données pour vous assurer que vous avez saisi les CIDR IPv4 corrects. Assurez-vous que ces adresses IP sont également affichées comme Active dans l'interface NiCE CXone.

  • Que les informations d'identification sont correctes dans le système qui consomme le flux de données.