Variables définies par l’utilisateur dans les profils dynamiques

Dans les profils de service dynamiques, Junos OS vous permet de configurer des variables personnalisées au niveau de la [edit dynamic-profiles profile-name variables] hiérarchie et de les utiliser dans la [edit dynamic-profiles] hiérarchie. Le profil dynamique obtient et remplace les données de ces variables à partir d’un serveur externe (par exemple, RADIUS) pendant le processus d’authentification de l’abonné. Au moment de l’exécution, les variables sont remplacées par des valeurs réelles et utilisées pour configurer les interfaces des abonnés.

Vous pouvez utiliser l’une des instructions suivantes pour configurer des variables définies par l’utilisateur :

• default-value: permet de configurer une valeur par défaut pour une variable définie par l’utilisateur dans un profil dynamique. Les valeurs que le système utilise pour ces variables sont appliquées lorsque l’abonné s’authentifie. La spécification d’une valeur par défaut fournit une configuration autonome pour l’instruction associée ou une sauvegarde pour la configuration de l’instruction si le serveur externe est inaccessible ou ne contient pas de valeur pour la variable.

• equals: permet de configurer une expression pour une variable définie par l’utilisateur qui est évaluée au moment de l’exécution et renvoyée en tant que valeur de variable.

• mandatory: indique qu’un serveur externe (par exemple, RADIUS) doit renvoyer une valeur pour la variable définie par l’utilisateur. Si le serveur externe ne renvoie pas de valeur pour la variable, le profil dynamique échoue.

• uid: permet de configurer un ID unique pour les filtres paramétrés et les CoS dans un profil dynamique créé pour les services.

• uid-reference: configure une variable qui fait référence à un ID unique pour les filtres paramétrés ou CoS dans un profil dynamique créé pour les services.

Remarque :

L’ordre dans lequel vous définissez comment les variables sont obtenues est important. Pour vous assurer que vous obtenez des variables obligatoires à partir d’un serveur externe et que vous ne dérivez pas de valeurs par défaut ou par le biais d’expressions de variable, vous devez d’abord définir les variables obligatoires.

Junos OS vous permet de créer des expressions (groupes d’opérateurs arithmétiques, opérateurs de chaîne et opérandes) à utiliser comme variables dans des profils dynamiques. Vous configurez les expressions de variable au niveau de la [dynamic-profiles profile-name variables] hiérarchie. Au moment de l’exécution, les expressions de variable sont calculées et utilisées comme valeurs de variable pour configurer des interfaces d’abonné dynamiques.

Lorsque vous configurez des expressions dans des profils dynamiques, vous devez respecter les règles suivantes :

• Vous ne pouvez configurer des expressions qu’à l’intérieur d’une strophe variable d’un profil dynamique.

• Les profils dynamiques qui contiennent des expressions pour des variables définies par l’utilisateur doivent être utilisés uniquement pour l’activation du service.

• En règle générale, vous n’affectez des expressions qu’aux variables définies par l’utilisateur. Vous ne pouvez pas affecter d’expressions à des variables internes ou à des variables prédéfinies.

• Les valeurs d’expression ont la priorité sur les valeurs par défaut.

• Les expressions entières doivent être comprises entre guillemets (« »).

• Les chaînes des expressions doivent être entre guillemets simples (' ') et les guillemets simples ne peuvent contenir que des chaînes.

• L’espace blanc est traité comme un délimiteur pour tous les opérandes et opérateurs. Les chaînes contenant des espaces que vous créez dans les expressions sont traitées comme des chaînes simples et incluent tout espace blanc de début ou de fin. Par exemple, pour créer un profil de service :

• L’expression doit être composée soit d’opérateurs arithmétiques, soit de tous les opérateurs de chaîne ; Le mélange d’opérateurs arithmétiques et d’opérateurs de chaîne n’est pas autorisé à moins d’être correctement converti au bon type.

• Les expressions peuvent faire référence à d’autres variables prédéfinies système ou à d’autres variables définies par l’utilisateur. Cependant, aucun référencement circulaire entre les variables n’est autorisé. Par exemple, la référence suivante est incorrecte :

• Pour créer une interface dynamique et un ensemble d’interfaces pour le plan d’utilisateur BNG-CUPS, utilisez le format suivant :

  Vous pouvez configurer la priorité des filtres de service pour le plan utilisateur BNG-CUPS, afin de contrôler l’ordre d’évaluation des services pour les paquets. Vous pouvez ajouter la configuration de précédence au profil dynamique.

• Toute variable obligatoire qui ne contient pas de valeur « par défaut » ou d’expression « égale » doit contenir une valeur dans le cadre de l’activation du service. Par exemple, un VSA de service RADIUS tel que « service-video( value1, value2) » qui contient au moins deux variables obligatoires dans la définition de profil de service dynamique « service-video » réussit. L’activation du service échoue si au moins une variable obligatoire n’a aucune valeur associée, que ce soit par l’évaluation d’attribut « par défaut » ou « égal à ».

Le Tableau 1 répertorie les opérateurs et les fonctions pris en charge que vous pouvez utiliser pour créer des expressions. La préséance 5 est le niveau le plus élevé.

Tableau 1 : Opérateurs et fonctions

Fonctionnement	Opérateur	Associativité	Préséance	Mesures à prendre
Addition arithmétique	+	Gauche	1	Ajoute les éléments à droite et à gauche de l’opérateur.
Soustraction arithmétique	-	Gauche	1	Soustrait l’élément à droite de l’opérateur de l’élément situé à gauche de l’opérateur.
Multiplication arithmétique	*	Gauche	2	Multiplie l’élément à gauche de l’opérateur par l’élément situé à droite de l’opérateur.
Division arithmétique	/	Gauche	2	Divise l’élément à gauche de l’opérateur par l’élément situé à droite de l’opérateur.
Arithmétique Modulo	%	Gauche	2	Divise l’élément à gauche de l’opérateur par l’élément situé à droite de l’opérateur et renvoie le reste entier. Si l’élément à gauche de l’opérateur est inférieur à l’élément à droite de l’opérateur, le résultat est l’élément à gauche de l’opérateur.
Concaténation	##	Gauche	3	Crée une chaîne en joignant les valeurs de chaîne à gauche de l’opérateur et les valeurs à droite de l’opérateur.
Maximum	max(param1,param2)	Gauche	4	Prend le maximum des deux valeurs passées en paramètres.
Minimum	min(param1,param2)	Gauche	4	Prend le minimum des deux valeurs passées en paramètres.
Rond	rond(param1)	-	4	Arrondit la valeur à l’entier le plus proche.
Tronquer	trunc(param1)	-	4	Tronque une valeur non entière à la valeur à gauche de la virgule.
Convertir en chaîne	toStr(param1)	-	4	Convertit la variable entre parenthèses en une chaîne terminée par un caractère NULL.
Convertir en entier	toInt(param1)	-	4	Convertit le paramètre en entier. Une seule chaîne ou variable est autorisée en tant que paramètre.
Aléatoire	rand()	-	4	Génère une valeur numérique aléatoire.
voire zéro	ifNotZero(param1, param2)	Gauche	4	Renvoie le deuxième paramètre si le premier paramètre n’est pas nul. Renvoie NULL si le premier paramètre est égal à zéro.
Parenthèses	( )	-	5	Regroupe les opérandes et les opérateurs pour obtenir des résultats différents de la simple préséance ; a effectivement la plus haute préséance.

Les expressions sont évaluées une fois que les variables sont remplies avec des valeurs. L’évaluation est effectuée immédiatement avant l’instanciation du profil et comprend une vérification de la valeur. Si les valeurs calculées ne sont pas acceptables ou si les règles régissant la syntaxe des expressions ne sont pas respectées, l’évaluation de l’expression échoue, l’instanciation du profil n’a pas lieu et les messages sont consignés pour décrire les erreurs.

Le Tableau 2 répertorie les scénarios d’erreur d’expression possibles et l’action entreprise par le logiciel du routeur.

Tableau 2 : erreurs d’expression et actions

Erreur	Occurrence	Mesures à prendre	Valeur variable
Erreur d’analyse	Phase de vérification de la validation	Échec de la validation	Non applicable
Erreur de dépendance de variable circulaire	Phase de vérification de la validation	Échec de la validation	Non applicable
Les variables à l’intérieur des expressions ne sont pas définies	Phase de vérification de la validation	Échec de la validation	Non applicable
Diviser par zéro	Instanciation de profil	Échec de l’instanciation du profil	Zéro (0)
Ajout d’une chaîne à un nombre	Instanciation de profil	Échec de l’instanciation du profil	Zéro (0)
Erreur de dépassement	Instanciation de profil	Échec de l’instanciation du profil	Non défini
Erreur de dépassement de débit	Instanciation de profil	Échec de l’instanciation du profil	Non défini

Vous pouvez également configurer les variables définies par l’utilisateur avec une valeur par défaut. La valeur par défaut fournit une configuration autonome pour l’instruction associée ou une sauvegarde pour la configuration de l’instruction si le serveur RADIUS est inaccessible ou si l’attribut VSA ne contient pas de valeur.

La configuration conditionnelle implique deux étapes principales :

1. Définition de la variable conditionnelle

2. Référencement de la variable conditionnelle dans une instruction de configuration

Une variable conditionnelle est définie comme une expression ifNotZero (param1, param2). Dans cette expression, param1 est une variable définie par l’utilisateur dont la valeur est dérivée d’un serveur externe tel que RADIUS et param2 peut être une variable définie par l’utilisateur, une fonction, une opération, un nombre ou une chaîne. Une variable conditionnelle peut être définie par l’utilisateur ou une variable d’ID unique (UID). reference Il ne peut pas s’agir d’une variable prédéfinie ou UID. Dans Junos OS, les variables conditionnelles sont prises en charge uniquement pour les profils dynamiques de service.

Les instructions de configuration dans lesquelles les variables conditionnelles sont référencées sont appelées conditional instructions de configuration. Une fois les variables conditionnelles définies, elles sont référencées dans dynamic-profiles les instructions de configuration et sont traitées lorsque le profil de service est instancié. Les instructions de configuration de profil de service suivantes prennent en charge les variables conditionnelles :

• dynamic-profiles profile-name interfaces interface-name unit unit-no family type filter input filter-name

• dynamic-profiles profile-name interfaces interface-name unit unit-no family type filter output filter-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name then policer policer-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name then hierarchical-policer policer-name

• dynamic-profiles profile-name class-of-service scheduler-maps map-name forwarding-class class-name scheduler scheduler-name

Le système suit l’ensemble de règles suivant lors de l’évaluation des variables conditionnelles et des instructions de configuration conditionnelle lors de l’instanciation du profil de service :

• Dans la fonction ifNotZero(param1, param2), si la valeur de a param1 n’est pas reçue d’un serveur externe et si la valeur par défaut n’est pas configurée, la valeur de la variable est traitée comme non nulle et param2 est évaluée.

• Si la valeur de param1 dans la fonction ifNotZero(param1, param2) est 0, NULL est renvoyé comme valeur de l’expression et param2 n’est pas évalué. Dans ce cas, la valeur de la variable conditionnelle devient NULL et l’instruction de configuration dans laquelle la variable conditionnelle est référencée est ignorée.

• Si la valeur de param1 est différente de zéro, alors param2 est évalué et sa valeur est renvoyée comme valeur de l’expression.

Les exemples de configuration suivants filter-service cos-service montrent comment les règles sont appliquées :

Exemple de configuration d’un service de filtrage

Dans l’exemple de filter-service configuration, input-filter-ref, , policer1-refoutput-filter-refet term1 sont des variables conditionnelles tandis que input "$input-filter-ref" precedence 50, output "$output-filter-ref" precedence 50, term $term1et policer "$policer1-ref" sont des instructions de configuration conditionnelle. Dans cet exemple, si la valeur de input-filter-var est 0, la valeur de la variable input-filter-ref conditionnelle devient NULL. Ainsi, l’instruction de configuration entière, input “$input-filter-ref” precedence 50, dans laquelle la variable conditionnelle est référencée, est ignorée. Toutefois, si la valeur de la variable est différente de zéro, l’instruction de configuration est traitée lors de l’instanciation du profil de service.

Exemple de configuration de service CoS

Dans l’exemple de cos-service configuration, sch1_ref et sch2_ref sont des variables conditionnelles tandis que forwarding-class best-effort scheduler "$sch1_ref" et forwarding-class assured-forwarding scheduler "$sch2_ref" sont des instructions de configuration conditionnelle. Comme pour l’évaluation de l’exemple de filter-service configuration, si la valeur d’une variable référencée dans une variable conditionnelle est 0, l’instruction de configuration dans laquelle la variable conditionnelle est référencée est ignorée et n’est pas traitée lors de l’instanciation du profil de service CoS.