Configuration de WebCC avec des paramètres personnalisés sur Windows

WebCC peut fonctionner sans aucun paramètre, mais il fournit également quelques options de personnalisation. Entre autres, vous pouvez changer le numéro de port, ajuster ses paramètres de sécurité et le configurer pour qu'il fonctionne avec la sécurité SSL.

Si vous avez installé WebCC en tant que service Windows, vous pouvez personnaliser ses paramètres en modifiant sa ligne de commande dans le panneau de configuration Harmony. Si vous utilisez Service Launcher pour exécuter WebCC, vous pouvez facilement ajouter des paramètres dans le champ Autres paramètres de l'onglet WebCC de Service Launcher.
Vous pouvez également configurer WebCC pour qu'il exécute un script ou un exécutable personnalisé chaque fois qu'un utilisateur met à jour une scène, que ce soit en l'important ou en la mettant à jour à partir d'Harmony. Pour ce faire, sur le serveur WebCC, définissez la variable d'environnement WEBCC_POST_IMPORT_SCRIPT avec le chemin d'un script ou d'un exécutable que vous souhaitez voir lancé à chaque mise à jour d'une scène. Le script ou l'exécutable sera lancé avec l'environnement, le job et le nom de la scène comme paramètres de ligne de commande, dans cet ordre.
OpenComment arrêter le service de serveur WebCC à l'aide du panneau de configuration Harmony

Ouvrez le menu Démarrer et, dans le menu Programmes, sélectionnez Harmony 16.0 Premium > Outils > Panneau de configuration.
Lorsque vous y êtes invité, autorisez le panneau de configuration à apporter des modifications à votre dispositif.

Dans le menu déroulant Process Starter, sélectionnez HarmonyStarter0-webcc.bat.
REMARQUELe numéro qui suit HarmonyStarter peut être différent, en fonction du nombre de services Harmony installés avant celui-ci.
Cliquez sur Stop.
Cliquez sur le champ Ligne de commande et appuyez sur la touche Fin pour déplacer le curseur de texte après webcc.bat.

Après webcc.bat, ajoutez un espace, puis tapez chaque paramètre que vous souhaitez ajouter, en les séparant par des espaces. Par exemple, si vous souhaitez que WebCC utilise le numéro de port 8081, vous devez modifier la ligne comme suit :
C:\NProgram Files (x86)\NToon Boom Animation\NToon Boom Harmony 16.0 Premium\Nwin64\Nwebcc.bat -port 8081
NOTEPour une liste des paramètres et de leur utilisation, voir le tableau des paramètres WebCC.
Cliquez sur Update parameters pour enregistrer les paramètres de la ligne de commande.
Cliquez sur Start pour redémarrer WebCC.

OpenComment ajouter des paramètres pour WebCC dans le Service Launcher

Assurez-vous d'être connecté en tant qu'utilisateur exécutant le service.

Dans la barre de notification, cliquez sur l'icône Service Launcher.

L'application Service Launcher s'ouvre.

Sélectionnez l'onglet WebCC.
Si vous voulez laisser n'importe quel utilisateur se connecter à WebCC sans identifiants et avec des privilèges administratifs, décochez l'option Authentification. Sinon, assurez-vous qu'elle est bien cochée.
Si vous souhaitez modifier le port utilisé par le serveur WebCC, saisissez le numéro de port souhaité dans le champ Port.

Si vous souhaitez spécifier d'autres options, saisissez-les dans le champ Autres paramètres, en les séparant par des espaces.
REMARQUEPour une liste des paramètres et de leur utilisation, voir Tableau des paramètres WebCC.

Dans le menu supérieur, sélectionnez Serveur > Enregistrer tous les paramètres.
Cliquez sur le bouton Arrêter.
Cliquez sur le bouton Lancer.

Tableau des paramètres de WebCC

Voici un tableau des paramètres qui peuvent être spécifiés pour personnaliser le comportement de votre serveur WebCC. Ils peuvent être utilisés à la fois dans le script shell WebCC et dans le Service Launcher.
Paramètre Description

-numWorkers <nombre>

Le nombre de nœuds de serveur à lancer pour traiter les demandes des clients. Chaque nœud nécessite un cœur de processeur et un nœud ne peut traiter qu'une seule demande de client à la fois. Par conséquent, plus le nombre de nœuds lancés est élevé, moins le serveur risque de se bloquer en cas de forte charge.

Si ce paramètre n'est pas spécifié, WebCC utilisera autant de nœuds qu'il y a de cœurs de processeur sur le serveur.

-noAuth
Désactive l'authentification. Si cette option est activée, tout utilisateur accédant à l'interface WebCC sera connecté en tant que usabatch et disposera de privilèges administratifs sur l'ensemble de la base de données.

-port <numéro de port>

Le port sur lequel HarmonyWebCC est déployé.

Le port par défaut pour accéder à WebCC est 8080. Pour que les navigateurs puissent accéder à WebCC sans spécifier le numéro de port, vous pouvez utiliser le port 80.
NOTESi le paramètre -http ou -https est spécifié, le paramètre -port est ignoré.

-exchange <répertoire>

Emplacement du répertoire exchange sur le système de fichiers local. C'est dans ce répertoire que sont stockés tous les paquets lors de l'exportation ou de l'importation de scènes.

Par défaut, ce répertoire est /USA_DB/exchange.

-cacheDuration <seconds>
Nombre de secondes pendant lesquelles les données sont conservées dans le cache. Cette valeur peut être comprise entre 1 et 999999. Par défaut, la valeur est de 3600.

-allowAllOrigin

Active le partage des ressources entre les différentes origines sur le serveur WebCC.

Par défaut, en tant que mesure de sécurité standard, seuls les fichiers se trouvant sur le même serveur que le serveur WebCC sont autorisés à utiliser les ressources WebCC. Si cette option est activée, il est possible de créer des interfaces web sur d'autres serveurs qui utilisent des ressources stockées sur le serveur WebCC, ou de stocker différents modules de WebCC sur différents serveurs et de les laisser communiquer ensemble.

Dans la plupart des cas, cette option doit être désactivée pour empêcher d'autres machines d'exploiter les ressources du serveur WebCC.

-disableAnalytics
Désactive le suivi de Google Analytics pour tous les clients. Cette option est activée par défaut.

-permission <type d'utilisateur> <action> <on|off>

Remplace une permission par défaut pour le type d'utilisateur donné.

Pour l'instant, ce paramètre ne peut être utilisé que pour le type d'utilisateur animator et pour la permission import_export_any_scene. Ainsi, lorsqu'il est utilisé avec la syntaxe suivante, les utilisateurs de type animateur peuvent exporter et importer n'importe quelle scène de la base de données, sans qu'il soit nécessaire que la scène leur soit d'abord attribuée.

-permission animateur import_export_toutes_les_scènes on

Tableau des paramètres HTTPS/SSL

Les paramètres suivants peuvent être utilisés pour activer et configurer SSL pour votre serveur WebCC.
REMARQUEPour plus d'informations sur la configuration de WebCC avec SSL, voir À propos de SSL, HTTPS et WebCC sur Windows.
Paramètre Description

-https <numéro de port>

Active la connexion au serveur via le protocole https en utilisant le numéro de port spécifié.

Un port couramment utilisé pour accéder à WebCC via le protocole https est le port 8443. Pour que les navigateurs Web puissent accéder à WebCC via https sans spécifier de numéro de port - à condition que l'adresse du serveur soit précédée de https://-you - il est possible d'utiliser le port 443.

Pour que https fonctionne, vous devez spécifier une paire de clés et de certificats au format PEM avec les options -key et -cert, ou un certificat au format PFX avec l'option -pfx.

-http <numéro de port>

Si l'accès par le protocole https est activé, ce paramètre vous permet d'autoriser également l'accès par le protocole http via le port spécifié.

L'utilisation de ce paramètre est facultative. Si le paramètre -https est spécifié, mais pas le paramètre -http, WebCC n'acceptera que les connexions via https.

Le port par défaut pour accéder à WebCC via le protocole http est 8080. Pour que les navigateurs puissent accéder à WebCC via http sans spécifier le numéro de port, vous pouvez utiliser le port 80.

-key <fichier de clés>

Emplacement du fichier de clé privée pour la session SSL. Il doit être spécifié avec le paramètre -cert.

La clé privée doit être au format PEM (Privacy Enhanced Mail), qui est un format ASCII dans lequel la clé est codée en Base64 et située entre les balises -----BEGIN PRVATE KEY----- et -----END PRIVATE KEY-----. En général, les clés privées dans ce format ont une extension .key.

-cert <fichier de certificat>

Emplacement du fichier de certificat de sécurité pour la session SSL. Il doit être spécifié en même temps que le paramètre -key.

Le certificat doit être au format PEM (Privacy Enhanced Mail), qui est un format ASCII dans lequel le certificat est codé en Base64 et situé entre les balises -----BEGIN CERTIFICATE----- et -----END CERTIFICATE-----. Ces certificats ont généralement une extension .crt, .cer ou .pem.

-pfx <fichier de certificat pfx>

Si vous disposez d'un certificat PFX (Personal Information Exchange), vous pouvez utiliser ce paramètre pour spécifier son emplacement, au lieu d'utiliser un certificat et une clé PEM. En règle générale, ces certificats portent l'extension .pfx ou .p12. Comme ces certificats incluent leur propre clé privée, il n'est pas nécessaire de spécifier une clé avec ce type de certificat.

-ca <fichier de certificat ca racine>

Si vous disposez d'un certificat de domaine signé par une autorité de certification (CA), ce paramètre vous permet de spécifier le certificat de la CA racine et/ou ses certificats intermédiaires.

Si vous souhaitez spécifier plusieurs certificats afin de composer la chaîne allant du certificat de votre domaine au certificat de l'autorité de certification racine, vous pouvez répéter le paramètre, comme suit :

-ca <certificat intermédiaire 1> -ca <certificat intermédiaire 2> -ca <certificat de l'autorité de certification racine>.

En règle générale, vous pourrez vous connecter à WebCC à l'aide de SSL à partir d'un navigateur Web même si WebCC n'est configuré qu'avec votre certificat de domaine, à condition qu'il soit signé par une autorité de certification réputée. Toutefois, si vous souhaitez que les collaborateurs du projet puissent utiliser les fonctionnalités Télécharger les modifications de la base de données et Mettre à jour la scène de la base de données dans Harmony via SSL, il peut être nécessaire de spécifier les certificats de l'autorité de certification racine et/ou ses intermédiaires, car Harmony peut ne pas être en mesure de reconnaître l'autorité de l'autorité de certification qui a signé votre certificat.

En général, vous pouvez obtenir les certificats de l'autorité de certification racine ou les certificats intermédiaires auprès de l'autorité de certification racine de l'autorité de certification qui a signé le certificat de votre domaine.
REMARQUE : Si nécessaire, vous pouvez autoriser Harmony à faire confiance au serveur WebCC même s'il dispose d'un certificat auto-signé (voir Désactivation de la validation du certificat SSL pour WebCC dans Harmony).