Variables définies par l’utilisateur dans des 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 d’utiliser ces variables 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 abonnés.

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

• default-value: permet de configurer la valeur par défaut d’une variable définie par l’utilisateur dans un profil dynamique. Les valeurs utilisées par le système 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: configurez 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: spécifie 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: configurez un ID unique pour les filtres et les CoS paramétrés dans un profil dynamique créé pour les services.

• uid-reference: configurez 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.

Note:

L’ordre dans lequel vous définissez la façon dont 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 à partir de valeurs par défaut ou via des expressions de variables, vous devez d’abord définir les variables obligatoires.

Junos OS vous permet de créer des expressions (groupes d’opérateurs arithmétiques, d’opérateurs de chaîne et d’opérandes) à utiliser en tant que variables dans des profils dynamiques. Vous configurez des 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 sont prioritaires sur les valeurs par défaut.

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

• Les chaînes à l’intérieur des expressions doivent être entre guillemets simples (' ') et les guillemets simples ne peuvent contenir que des chaînes.

• Les espaces blancs sont traités comme un délimiteur pour tous les opérandes et opérateurs. Les chaînes contenant des espaces que vous créez dans des 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 soit tous les opérateurs arithmétiques, soit 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 type correct.

• Les expressions peuvent faire référence à d’autres variables prédéfinies par le 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 utilisateur BNG-CUPS, utilisez le format suivant :

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

• Toute variable obligatoire qui ne contient pas de valeur « default » ou d’expression « equals » 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 deux variables obligatoires ou moins 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’est associée à aucune valeur, que ce soit par le biais de l’évaluation de l’attribut « default » ou « equals ».

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

Tableau 1 : opérateurs et fonctions

Opération	Opérateur	Associativité	Préséance	Action
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 à gauche de l’opérateur.
Multiplication arithmétique	*	Gauche	2	Multiplie l’élément à gauche de l’opérateur par l’élément à droite de l’opérateur.
Division arithmétique	/	Gauche	2	Divise l’élément à gauche de l’opérateur par l’élément à droite de l’opérateur.
Arithmétique modulo	%	Gauche	2	Divise l’élément à gauche de l’opérateur par l’élément à 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 nouvelle 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 une valeur nulle.
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.
Si ce n’est pas zéro	ifNotZero(param1, param2)	Gauche	4	Renvoie le deuxième paramètre si le premier paramètre n’est pas nul. Renvoie la valeur 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écédence ; a effectivement la priorité la plus élevée.

Les expressions sont évaluées une fois que les variables sont renseignées 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 ne se produit pas et des messages sont consignés pour décrire les erreurs.

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

Tableau 2 : erreurs d’expression et actions

Erreur	Occurrence	Action	Valeur variable
Erreur d’analyse	Phase de vérification de la validation	Échec de la validation	sans objet
Erreur de dépendance de variable circulaire	Phase de vérification de la validation	Échec de la validation	sans objet
Les variables à l’intérieur des expressions ne sont pas définies	Phase de vérification de la validation	Échec de la validation	sans objet
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 de capacité	Instanciation de profil	Échec de l’instanciation du profil	Indéfini
Erreur de sous-débit	Instanciation de profil	Échec de l’instanciation du profil	Indé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 il s’agit d’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 d’une variable 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 lors de l’instanciation du profil de service. 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 conditionnelles 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 différente de zéro et param2 est évaluée.

• Si la valeur de param1 dans la fonction ifNotZero(param1, param2) est 0, la valeur NULL est renvoyée comme valeur de l’expression et param2 n’est pas évaluée. 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 est différente de param1 zéro, elle param2 est évaluée et sa valeur est renvoyée en tant que valeur de l’expression.

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

Exemple de configuration du service de filtrage

Dans l’exemple de filter-service configuration, input-filter-ref, output-filter-ref, policer1-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 conditionnelles. Dans cet exemple, si la valeur de input-filter-var est 0, la valeur de la variable input-filter-ref conditionnelle devient NULL. Ainsi, toute l’instruction de configuration, 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 d’un 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 conditionnelles. Comme pour l’évaluation dans l’exemple filter-service de 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.