ScreenAgent pour Mac

Le terme ScreenAgentClosed NiCE ScreenAgent is a service that runs on agent desktops that require screen recording. est disponible si vous possédez les licences suivantes :

  • CXone ACD (voice) ou Third Party Telephony Providers

  • Enregistrement d'écran Basic ou Advanced

Installez ScreenAgentClosed NiCE ScreenAgent is a service that runs on agent desktops that require screen recording. sur les ordinateurs pour enregistrer ou surveiller l’activité sur l’écran d’un agent pendant une interaction. ScreenAgent s’exécute en arrière-plan et enregistre automatiquement selon les politiques d’enregistrement. Les Superviseurs et les évaluateurs peuvent également surveiller l’activité d’un agent pendant une interaction.

Vous pouvez installer ScreenAgent sur les ordinateurs des agents avec le système d'exploitation Mac. Si vous utilisez l'authentification de base ScreenAgent pour Mac, utilisez la version 3.0.1 et ultérieure. Les versions Mac OS prises en charge sont 10.15 macOS Catalina, 11 macOS Big Sur et versions ultérieures.

Pour Advanced ScreenAgent pour Mac, utilisez la version 5.0.39 et au-dessus.

Vous pouvez trouver la dernière version de ScreenAgent sur la page Soutien et téléchargements.

Conserver à l'esprit :

  • ScreenAgent sur Mac Système d’exploitation (de base et avancé) prend en charge jusqu'à trois enregistrements d'écran.

  • ScreenAgent sur Système d’exploitation Mac (de base et avancé) prend en charge l’observation d’écran de manière différente selon qu’il s’agisse d’ordinateurs de bureau ou portables.

    • Ordinateurs de bureau Mac : prend en charge jusqu'à trois écrans.

    • Ordinateurs portables Mac : prend en charge jusqu'à trois écrans si l'écran de l'ordinateur portable est fermé. Lorsque l'écran de l'ordinateur portable est ouvert et qu'il ne s'agit pas de l'écran principal, le ScreenAgent capture tous les écrans externes (jusqu'à trois). L'écran de l'ordinateur portable ne sera pas capturé.

  • Après une installation réussie, vous devez accorder manuellement l'autorisation d'enregistrer l'écran.

Pour les locataires configurés avec un enregistrement d'écran à 100 %, l'enregistrement d'écran démarre jusqu'à 25 secondes après la connexion de l'agent. L’enregistrement d’écran peut ne pas fonctionner correctement pendant ces 25 secondes.

Pour obtenir la liste des fonctionnalités ajoutées aux versions ScreenAgent précédentes, consultez ScreenAgent : Notes de version cumulatives.

Vous pouvez utiliser l'ScreenAgent Outil de vérification de la connectivité avant ou après l'installation.

Conditions préalables

Avant de commencer l'installation de Advanced ScreenAgent, assurez-vous de :

  1. Vérifiez les exigences de connectivité pour votre région à l'aide de l'Assistant Exigences de connectivité.

  2. Vérifiez la configuration informatique de l'agent.

  3. Assurez-vous que l'utilisateur qui installe Advanced ScreenAgent (par exemple, l'administrateur) dispose des privilèges Admin sur l'ordinateur de l'agent.

  4. Assurez-vous que l'utilisateur qui installe Advanced ScreenAgent (par exemple, l'administrateur) dispose de ces NiCE CXone autorisations :

    • Peut accéder aux téléchargements de soutien : Activé—Cette option vous permet d'accéder à la page Supports & Downloads.

    • Clé d'accès:Créer: il s'agit de gérer les clés d'accès pour votre organisation.

  5. Suivez les étapes ci-dessous dans l'ordre indiqué pour générer une clé d'accès pour Advanced ScreenAgent. Vous pouvez utiliser la même clé d'accès pour installer Advanced ScreenAgent sur les ordinateurs de tous les agents de votre locataire.

    La clé d'accès reçoit toutes les autorisations du NiCE CXone utilisateur qui le génère. Si cet utilisateur est un administrateur, toute personne disposant de la clé d'accès aurait des privilèges d'administrateur. Ainsi, pour des raisons de sécurité, créez d'abord un utilisateur et un rôle NiCE CXone pour Advanced ScreenAgent, puis générez la clé avec l'utilisateur ScreenAgent.

    1. Créez un rôle pour le service Advanced ScreenAgent :

      1. Cliquez sur le sélecteur d'application icon of app selector et sélectionnez Admin.
      2. Accédez à Sécurité > Rôles et Autorisations.

      3. Cliquez sur Nouveau rôle.

      4. Donnez un nom au rôle, par exemple ScreenAgent clé d'accès.

      5. Supprimez toutes les autorisations pour le rôle, à l'exception de Access Key et de My Access Key.

      6. Enregistrer & Activer le profil.

    2. Créez un employé pour le service ScreenAgent :

      1. Cliquez sur le sélecteur d'application icon of app selector et sélectionnez Admin.
      2. Cliquez sur Employés.

      3. Cliquez sur Nouvel employé.

      4. Attribuez un nom à l'employé, par exemple ScreenAgent.

      5. Dans la liste déroulante Rôle principal, sélectionnez le Rôle ScreenAgent clé d'accès que vous venez de créer.

      6. Dans l'Onglet général, effacez tous les attributs.

      7. Créez l'employé ScreenAgent. Vous pouvez générer des clés d’accès uniquement après avoir créé le compte.

    3. Ouvrez à nouveau l’employé ScreenAgent et accédez à l’onglet Sécurité. Cliquez sur ajouter une clé d’accès pour générer une clé d’accès.

    4. Copiez à la fois l’Id DE LA clé D’ACCÈS et la Clé d’accès secrète et enregistrez-les dans un endroit sûr. Si vous ne copiez pas le Clé d'accès secrète ou si vous le perdez, vous devrez en créer un nouveau. Utilisez cet ID de Clé d’accès et cette Clé d’accès secrète lors de l’installation de ScreenAgent sur les ordinateurs de tous les agents.

    5. Activez le compte employé ScreenAgent en cliquant sur le bouton Activer le compte dans l'e-mail d'activation.

  6. Télécharger le ScreenAgent :

    1. Allez à NiCE CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Soutien et téléchargements.

    3. Télécharger le DMG Advanced ScreenAgent. Notez où vous téléchargez le DMG, vous aurez besoin de l'emplacement du fichier plus tard.

Installer Advanced ScreenAgent pour Mac

Advanced ScreenAgent pour Mac peut être utilisé avec Screen Recording Basic license ou Screen Recording Advanced license. Cependant, certaines fonctionnalités sont prises en charge uniquement pour les clients disposant d'une licence Screen Recording Advanced. Consultez Cumulative Updates for ScreenAgent pour plus de détails.

Lorsque vous installez l'application Advanced ScreenAgent pour Mac :

  • Vous bénéficiez de mises à niveau automatiques et de mises à jour pour toutes les instances Advanced ScreenAgent.

  • Il n'est pas nécessaire d'utiliser une infrastructure tierce (FFmpeg) pour réduire le temps de résolution des problèmes.

  • Moins de ressources (Unité centrale, ram) sont nécessaires pour maximiser les ressources des VDI et des ordinateurs de bureau physiques.

  • Si vous utilisez Advanced ScreenAgent avec une licence Screen Recording Advanced et l'observation d'écran en temps réel, vous pouvez activer Screen Assist afin que les superviseurs puissent placer des notes contextuelles sur les écrans des agents pendant une session d'observation.

Pour installer Advanced ScreenAgent :

Si vous disposez déjà de ScreenAgent, vous pouvez installer Advanced ScreenAgent par-dessus la version basic sans devoir d'abord désinstaller la version basic. Pour conserver vos configurations existantes pendant la mise à niveau, consultez Conserver votre configuration lors de l'installation de Advanced ScreenAgent.

  1. Assurez-vous que toutes les Conditions préalables sont en place.

  2. Extrayez le fichier AdvancedScreenAgent-darwin-universal-x.x.x.dmg via le terminal ou manuellement :

    Pour extraire le fichier via le terminal :

    1. Dans l'application terminal sur votre Mac, entrez le nom de chemin complet où vous avez téléchargé le fichier DMG.

    2. Pour extraire le fichier, saisissez sudo hdiutil attach AdvancedScreenAgent-darwin-universal-<enter DMG version, such as 5.0.39>.dmg et appuyez sur entrée.

    3. Pour déplacer le fichier vers le dossier Applications, type sudo cp -R /Volumes/AdvancedScreenAgent/AdvancedScreenAgent.app /Applications et appuyez sur Entrée.

    4. Tapez sudo hdiutil unmount /Volumes/AdvancedScreenAgent/ et appuyez sur Entrée.

    Pour extraire le fichier DMG manuellement :

    1. Accédez à l'emplacement où vous avez téléchargé le fichier DMG, puis double-cliquez sur le fichier AdvancedScreenAgent-darwin-universal-x.x.x.dmg.

    2. Copiez le dossier Advanced ScreenAgent et collez-le dans le répertoire Applications.

  3. Étape par étape, instructions pour l'installation :

    1. Accédez à l'application terminal sur votre Mac.

    2. Copiez et collez la commande dans le terminal, puis modifiez les paramètres conformément au tableau Paramètres de la commande d'installation.

      var(--codeSnippetCopyLabel)
      sh /Applications/AdvancedScreenAgent.app/Contents/Resources/install-advanced-screen-agent.sh 'INSTALL_PARAMS=[ACCESS_KEY_ID=<paste the access key ID>,ACCESS_KEY_SECRET=<paste the secret access key>,BASE_URL=https://na1.nice-incontact.com,SHOW_NOTIFICATIONS=<optional: true|false>]'
      • Assurez-vous d'avoir le mot DE passe Admin sudo. Cette commande peut vous demander de saisir le mot DE passe.

      • Remarque : les configurations LOAD_CERTIFICATES et PROXY WEB ne sont pas requises pour l'Advanced ScreenAgent. Cela s'explique par le fait qu'Advanced ScreenAgent n'effectue pas d'appels sortants directs et que toutes les communications sont gérées par les applications web, qui ne nécessitent pas cette configuration.

    3. Le paramètre SHOW_NOTIFICATIONS s'applique à l'ordinateur sur lequel vous installez Advanced ScreenAgent. Les agents ne peuvent pas activer ou désactiver les notifications. Pour modifier le paramètre après l'installation, remplacez la valeur true par false.
    4. Pour conserver vos configurations existantes lors d'une mise à niveau, consultez Conserver votre configuration lors de l'installation de Advanced ScreenAgent.

  4. Le journal de la progression d’installation est affiché dans le terminal et enregistré dans le fichier journal d’installation, InstallationLog.txt. Le chemin complet est /Applications/AdvancedScreenAgent.app/Contents/Resources/InstallationLog.txt.

  5. Lorsque l'installation est terminée et que vous êtes invité à ouvrir Advanced ScreenAgent, cliquez sur Ouvrir.

  6. Lorsque vous êtes invité à accorder l'autorisation d'enregistrement de l'écran dans l'application Advanced ScreenAgent, cliquez sur Paramètres.

  7. Sur la page Paramètres , sélectionnez la case à cocher Advanced ScreenAgent. Une Prompt s'affiche, indiquant de quitter l'Advanced ScreenAgent afin de lui permettre d'enregistrer l'écran. Cliquez sur Quitter maintenant.

  8. Redémarrez l'ordinateur ou accédez à l'application terminal sur votre Mac et exécutez la commande :

    ouvrez /Applications/AdvancedScreenAgent.app

  9. Assurez-vous que l'agent dispose de l'attribut Peut être enregistré (Écran) (dans NiCE CXone, accédez à Admin > Employés, puis cliquez sur l'agent). Cet attribut est nécessaire pour activer l'enregistrement d'écran, l'observation d'écran, ou les deux.

  10. Enregistrez un appel et vérifiez le fichier journal Advanced ScreenAgent. Le chemin complet du fichier AdvancedScreenAgent.log est ~/Library/Application Support/AdvancedScreenAgent/logs/AdvancedScreenAgent.log. En cas d'erreurs, consultez Dépannage des enregistrements et FAQ.

Modifier la configuration ScreenAgent Advanced

Après l'installation, vous pouvez modifier certaines configurations avancées de ScreenAgent.

Si vous utilisez Advanced ScreenAgent avec une Screen Recording Advanced license, il est recommandé de mettre à jour votre configuration à l'aide de ScreenAgent Manager.

  1. Ouvrez le fichier config.json dans le dossier d'installation Advanced ScreenAgent, généralement sous ~/Library/Application Support/AdvancedScreenAgent.

  2. Modifiez les valeurs des paramètres :

    • Modifiez la valeur de la propriété FRAME_PER_SECOND. Par défaut, cette valeur est de 5.

      Les valeurs autorisées sont 1, 2, 3, 4 ou5.

      Réduire le nombre d'images par seconde diminue la taille du fichier, l'utilisation de l'Unité centrale et de la ram.

      Images par seconde Réduction des images Impact sur la taille du fichier/la bande passante, l'Unité centrale et la RAM (estimé)

      5

      Par défaut (maximum)

      Aucun

      4

      20 % de moins

      ~15 % de réduction

      3.

      40% de moins

      ~30% de réduction

      2

      60% de moins

      ~45% de réduction

      1

      80 % de moins

      ~60% de réduction

    • Modifiez ou ajoutez la valeur de la propriété RESOLUTION_LEVEL. Par défaut, cette valeur est null, la Résolution d'écran actuelle.

      Les valeurs autorisées sont null, low, medium ou high (tout en minuscules).

      La réduction de la résolution réduit la taille du fichier, l'Unité centrale et la RAM.

      Niveau de résolution Réduction de la Résolution Impact sur Taille du fichier/bande passante, Unité centrale et RAM (estimé)

      Null

      Par défaut (résolution d'écran actuelle)

      Aucun

      Élevé

      Résolution d'écran / 1,5

      ~20% de réduction

      Moyen

      Résolution d'écran / 2

      ~40% de réduction

      Faible

      Résolution d'écran / 4

      ~60 % de réduction (recommandé uniquement pour les écrans 4K et 5K)

      Pour réinitialiser la résolution de l'écran, remplacez la valeur de RESOLUTION_LEVEL par null.

  3. Enregistrez le fichier config.json.

  4. Pour appliquer les modifications, redémarrez l'application Advanced ScreenAgent.

Mise à niveau de votre ScreenAgent avancé pour la version Mac

Si vous effectuez une mise à niveau d'une version d'Advanced ScreenAgent pour Mac vers une version plus récente d'Advanced ScreenAgent pour Mac, vous devez configurer votre machine pour autoriser les mises à jour.

Avant d'effectuer la mise à niveau :

  1. Dans le menu principal, accédez à Confidentialité & Sécurité>Gestion des applications.

  2. Activez le bouton bascule terminal sur ON (autoriser les applications en dessous à mettre à jour ou supprimer d'autres applications).

  3. Vous pouvez désormais mettre à niveau votre version d'Advanced ScreenAgent pour Mac.

Conserver votre configuration lors de l'installation de Advanced ScreenAgent

Lorsque vous effectuez une mise à niveau vers la nouvelle version Advanced ScreenAgent ou une mise à niveau de Basic vers Advanced ScreenAgent, le programme d'installation conserve par défaut votre configuration existante. Ce comportement est contrôlé par le paramètre KEEP_CURRENT_CONFIG dans les Paramètres de la commande d'installation.

La valeur par défaut est true. Lorsque KEEP_CURRENT_CONFIG=true , le programme d'installation utilise votre configuration existante.

Si KEEP_CURRENT_CONFIG=false, le programme d'installation ignore toute configuration existante, y compris les données ScreenAgent de base. Il écrit une nouvelle configuration en utilisant uniquement les valeurs que vous fournissez dans INSTALL_PARAMS.

Pour conserver vos configurations existantes lors de la mise à niveau :

  1. Suivez les étapes décrites dans Installer Advanced ScreenAgent pour Mac

  2. Ajoutez le paramètre KEEP_CURRENT_CONFIG=true à la Commande Prompt.

  3. Terminez les étapes d'installation restantes.

ScreenAgent Outil de vérification de la connectivité

Utilisez l'outil de vérification de la connectivité ScreenAgent pour exécuter une séquence de tests afin de vérifier l'accès réseau et de vous assurer que AdvancedScreenAgent fonctionnera correctement pour Mac.

  • Vous pouvez utiliser l'outil avant ou après l'installation du AdvancedScreenAgent.

  • Vous pouvez télécharger la dernière version de l’outil de vérification de la connectivité sur la page de téléchargement.

  • Il est recommandé d’utiliser cet outil lorsque la configuration réseau d’un agent a changé ou qu’elle diffère de la configuration normale. Il n'est pas nécessaire d'exécuter l'outil pour chaque Agent.

  • Vous pouvez exécuter l'outil de vérification de la connectivité plusieurs fois en utilisant la même commande.

  • Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. À la fin de l'exécution, un résumé affiche le statut de chaque test.

  • Une fois les tests réalisés, l’outil de vérification de la connectivité crée un fichier journal.

  1. Télécharger le fichier DMG de l'outil Connectivité Check :

    1. Allez à NiCE CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Soutien et téléchargements.

    3. Téléchargez le fichier DMG requis ScreenAgentConnectivityTool-<version>-mac.dmg. Notez l'endroit où vous téléchargez le fichier DMG, vous aurez besoin de l'emplacement du fichier plus tard.

  2. Mount the DMG file. 
    1. Double-cliquez sur le fichier DMG dans Finder pour le monter.

      Vous pouvez également exécuter la commande suivante dans terminal :

      hdiutil attach /path/to/ScreenAgentConnectivityTool-<version>-mac.dmg
    2. L'outil sera disponible à :

      /Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-<version>-mac-universal

  3. Run the Connectivity Check Tool
    1. Ouvrez terminal et exécutez la commande suivante en tant qu'Administrateur. Vous aurez besoin du sudo mot DE passe.

      sudo "/Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-<version>-mac-universal" ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE=<region>

      Exemple de commande :

      sudo "/Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-1.27.0-mac-universal" ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1

  4. L'outil de vérification de la connectivité commence à exécuter les tests. Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. Si un test échoue, la raison de l'échec est affichée. À la fin de l'exécution, un résumé indique si chaque test a réussi, a échoué ou n'a pas eu besoin d'être exécuté (N/A).

    Une fois les tests terminés, l'outil de vérification de la connectivité crée un fichier journal (SA_Connectivity_tool_log_<runUniqueUUID>) dans le même dossier que le fichier d'installation de l'outil de vérification de la connectivité. Le fichier journal comprend toutes les informations qui étaient affichées dans le terminal.

Tests de connectivité

  • Les tests Close/Launch ScreenAgent afficheront N/A si Advanced ScreenAgent n'était pas en cours d'exécution lorsque l'outil a démarré.

  • Le test de handshake TLS peut afficher N/A si la région ne contient pas de terminal turns:443 configuré.

Utilisation d'une liste « Refuser » avec Advanced ScreenAgent pour Mac

Pour pouvoir utiliser la liste de refus avec Advanced ScreenAgent, vous devez activer les autorisations suivantes :

Paramètres>Confidentialité & Sécurité>Accessibilité> Advanced ScreenAgent

Paramètres>Confidentialité & Sécurité>Capture d'écran & Enregistrement audio du Système> Advanced ScreenAgent

Dans les deux cas, activez Advanced ScreenAgent pour activer ces autorisations.

Pour plus d'informations sur l'utilisation d'une liste de refus, consultez gestion d’une liste de refus d’enregistrement d’écran.