Gérer Kafka Data Streams

autorisations requises : Flux de données

Cette page vous aide à configurer et à vous abonner à un data stream Kafka. 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 des é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 dans les formats de schéma suivants :

  • PROTO
  • JSON
  • AVRO
  • JSON avec retour à la ligne
  • JSON AVRO avec retour à la ligne

Configurer un Kafka Data Stream

D’abord, planifiez comment vous utiliserez le flux Kafka. Vous devez disposer des ressources techniques pour créer une Destination pouvant s’abonner au flux. Cela vous oblige à respecter les exigences de sécurité suivantes :

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

  • Une méthode d’authentification pour utiliser les identifiants de nom d’utilisateur et de mot de passe de NiCE CXone.

Créer un Kafka Data Stream dans NiCE CXone

Les instructions suivantes vous aident à créer un data stream, à générer un ensemble d’identifiants et à ajouter les CIDR IP que vous utiliserez pour vous abonner au data stream.

  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, si vous le souhaitez, une Description.

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

  6. Pour Format des données, choisissez le format de schéma que vous souhaitez utiliser pour les données.

  7. Pour Type de Flux cible, sélectionnez Kafka Externe.

  8. Générez un ensemble d’identifiants. 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 Sécurité 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 trait d’union (-) ou un trait de soulignement (_).

      Vous ne pouvez avoir qu’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 nouveau.

    3. Cliquez sur Créer et Télécharger. Cela 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 entrez les CIDR IP que vous souhaitez utiliser pour le flux de données :

    1. Faites défiler vers le bas jusqu’à la Section des CIDR IP autorisés.

    2. Pour IP CIDR, entrez le CIDR complet des Adresses ip par lesquelles vous souhaitez vous abonner. Assurez-vous d’inclure à la fois l’Adresse ip et le masque de sous-réseau pour l’adresse CIDR complète. Vous pouvez entrer multiple CIDR à la fois, séparés par une virgule.

      • Vous ne pouvez avoir que 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 avoir créé le flux de données, les Détails du flux s'affichent au bas de la page. Cela comprend 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.

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

Configurer une Destination pour vous abonner au flux Kafka

Dans votre propre destination Kafka , vous devez insérer les détails du courtier de flux que vous avez générés à 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 vouloir ou devoir remplacer un ensemble d'identifiants. Dans NiCE CXone, vous avez l'option d'effectuer une suppression douce ou un effacement dur d'un ensemble d'identifiants. La suppression douce signifie que les identifiants deviennent inactifs pendant deux jours, après quoi ils sont complètement supprimés. Cela vous donne 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ù les alias de vos identifiants sont énuméré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 douce, 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 pour 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 éléments suivants :

  • Vous avez saisi les détails corrects du 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 d'avoir saisi les bons CIDR IPv4. Assurez-vous que ces adresses ip sont également affichées comme Actif dans l'interface NiCE CXone.

  • Que les identifiants sont corrects dans le système qui consomme le flux de données.