Variáveis definidas pelo usuário em perfis dinâmicos

Em perfis de serviço dinâmicos, o Junos OS permite configurar variáveis personalizadas no nível de [edit dynamic-profiles profile-name variables] hierarquia e usar essas variáveis na [edit dynamic-profiles] hierarquia. O perfil dinâmico obtém e substitui dados para essas variáveis de um servidor externo (por exemplo, RADIUS) durante o processo de autenticação do assinante. Em tempo de execução, as variáveis são substituídas por valores reais e usadas para configurar interfaces de assinante.

Você pode usar qualquer uma das seguintes instruções para configurar variáveis definidas pelo usuário:

• default-value— Configure um valor padrão para uma variável definida pelo usuário em um perfil dinâmico. Os valores que o sistema usa para essas variáveis são aplicados quando o assinante é autenticado. A especificação de um valor padrão fornece uma configuração independente para a instrução associada ou um backup para a configuração da instrução se o servidor externo estiver inacessível ou não contiver um valor para a variável.

• equals— Configure uma expressão para uma variável definida pelo usuário que é avaliada em tempo de execução e retornada como o valor da variável.

• mandatory— Especifique que um servidor externo (por exemplo, RADIUS) deve retornar um valor para a variável definida pelo usuário. Se o servidor externo não retornar um valor para a variável, o perfil dinâmico falhará.

• uid— Configure um ID exclusivo para filtros com parâmetros e CoS em um perfil dinâmico criado para serviços.

• uid-reference— Configure uma variável que faça referência a um ID exclusivo para filtros com parâmetros ou CoS em um perfil dinâmico criado para serviços.

Observação:

A ordem na qual você define como as variáveis são obtidas é importante. Para garantir que você obtenha quaisquer variáveis obrigatórias de um servidor externo e não derive valores de padrões ou por meio de expressões de variável, você deve definir quaisquer variáveis obrigatórias primeiro.

O Junos OS permite que você crie expressões — grupos de operadores aritméticos, operadores de string e operandos — para uso como variáveis dentro de perfis dinâmicos. Você configura expressões variáveis no nível da [dynamic-profiles profile-name variables] hierarquia. Em tempo de execução, as expressões variáveis são calculadas e usadas como valores variáveis para configurar interfaces dinâmicas de assinantes.

Ao configurar expressões em perfis dinâmicos, você deve seguir as seguintes regras:

• Você pode configurar expressões somente dentro de uma estrofe variável de um perfil dinâmico.

• Os perfis dinâmicos que contêm expressões para variáveis definidas pelo usuário devem ser usados apenas para ativação de serviço.

• Geralmente, você atribui expressões apenas a variáveis definidas pelo usuário. Não é possível atribuir expressões a variáveis internas ou variáveis predefinidas.

• Os valores de expressão têm precedência sobre os valores padrão.

• Expressões inteiras devem estar contidas entre aspas (" ").

• As cadeias de caracteres dentro das expressões devem ser colocadas entre aspas simples (' ') e as aspas simples podem conter apenas cadeias de caracteres.

• O espaço em branco é tratado como um delimitador para todos os operandos e operadores. As cadeias de caracteres que contêm espaços que você cria dentro de expressões são tratadas como cadeias de caracteres únicas e incluem qualquer espaço em branco à esquerda ou à direita. Por exemplo, para criar um perfil de serviço:

• A expressão deve ser todos os operadores aritméticos ou todos os operadores de cadeia de caracteres; A mistura de operadores aritméticos e operadores de cadeia de caracteres não é permitida, a menos que seja convertida corretamente para o tipo correto.

• As expressões podem se referir a outras variáveis predefinidas do sistema ou outras variáveis definidas pelo usuário. No entanto, nenhuma referência circular entre variáveis é permitida. Por exemplo, a seguinte referência está incorreta:

• Para criar uma interface dinâmica e um conjunto de interfaces para o plano de usuário BNG-CUPS, use o seguinte formato:

  Você pode configurar a precedência do filtro de serviço para o plano de usuário BNG-CUPS para controlar a ordem de avaliação de serviço para os pacotes. Você pode adicionar a configuração de precedência ao perfil dinâmico.

• Qualquer variável obrigatória que não contenha um valor "padrão" ou uma expressão "igual" deve conter um valor como parte da ativação do serviço. Por exemplo, um VSA de serviço RADIUS como "service-video( value1, value2)" que contém duas ou menos variáveis obrigatórias na definição de perfil de serviço dinâmico "service-video" é bem-sucedido. A ativação do serviço falhará se pelo menos uma variável obrigatória não tiver nenhum valor associado a ela, seja por meio da avaliação do atributo "default" ou "equals".

A Tabela 1 lista os operadores e funções com suporte que você pode usar para criar expressões. A precedência 5 é o nível mais alto.

Tabela 1: Operadores e funções

Divisão de	Operador	Associatividade	Precedência	Ação
Adição aritmética	+	Esquerda	1	Adiciona os elementos à direita e à esquerda do operador juntos.
Subtração aritmética	-	Esquerda	1	Subtrai o elemento à direita do operador do elemento à esquerda do operador.
Multiplicação aritmética	*	Esquerda	2	Multiplica o elemento à esquerda do operador pelo elemento à direita do operador.
Divisão de Aritmética	/	Esquerda	2	Divide o elemento à esquerda do operador pelo elemento à direita do operador.
Módulo aritmético	%	Esquerda	2	Divide o elemento à esquerda do operador pelo elemento à direita do operador e retorna o inteiro restante. Se o elemento à esquerda do operador for menor que o elemento à direita do operador, o resultado será o elemento à esquerda do operador.
Concatenação	##	Esquerda	3	Cria uma nova cadeia de caracteres unindo os valores de cadeia de caracteres à esquerda do operador e os valores à direita do operador.
Máximo	max(param1,param2)	Esquerda	4	Usa o máximo dos dois valores passados como parâmetros.
Mínimos	min (param1, param2)	Esquerda	4	Usa o mínimo dos dois valores passados como parâmetros.
Redondo	rodada(param1)	-	4	Arredonda o valor para o número inteiro mais próximo.
Truncar	trunc(param1)	-	4	Trunca um valor não inteiro para o valor à esquerda da vírgula decimal.
Converter em cadeia de caracteres	toStr(param1)	-	4	Converte a variável dentro dos parênteses em uma cadeia de caracteres terminada nula.
Converter em inteiro	toInt(param1)	-	4	Converte o parâmetro em um número inteiro. Uma única string ou variável é permitida como parâmetro.
Aleatório	rand()	-	4	Gera um valor numérico aleatório.
Se não for zero	ifNotZero(param1, param2)	Esquerda	4	Retorna o segundo parâmetro se o primeiro parâmetro não for zero. Retorna NULL se o primeiro parâmetro for zero.
Parênteses	( )	-	5	Agrupa operandos e operadores para obter resultados diferentes da precedência simples; efetivamente tem a mais alta precedência.

As expressões são avaliadas depois que as variáveis são preenchidas com valores. A avaliação é realizada imediatamente antes da instanciação do perfil e inclui a verificação de valor. Se os valores calculados não forem aceitáveis ou as regras que regem a sintaxe da expressão forem quebradas, a avaliação da expressão falhará, a instanciação do perfil não ocorrerá e as mensagens serão registradas para descrever os erros.

A Tabela 2 lista os possíveis cenários de erro de expressão e a ação tomada pelo software do roteador.

Tabela 2: Erros e ações de expressão

Erro	Ocorrência	Ação	Valor da variável
Erro de análise	Fase de verificação de commit	Falha no commit	Não aplicável
Erro de dependência de variável circular	Fase de verificação de commit	Falha no commit	Não aplicável
As variáveis dentro das expressões não são definidas	Fase de verificação de commit	Falha no commit	Não aplicável
Dividir por zero	Instanciação de perfil	Falha na instanciação de perfil	Zero (0)
Adicionar string a um número	Instanciação de perfil	Falha na instanciação de perfil	Zero (0)
Erro de estouro	Instanciação de perfil	Falha na instanciação de perfil	Indefinido
Erro de estouro negativo	Instanciação de perfil	Falha na instanciação de perfil	Indefinido

Você também pode configurar as variáveis definidas pelo usuário com um valor padrão. O valor padrão fornece uma configuração independente para a instrução associada ou um backup para a configuração da instrução se o servidor RADIUS estiver inacessível ou o atributo VSA não contiver um valor.

A configuração condicional envolve duas etapas principais:

1. Definindo a variável condicional

2. Referenciando a variável condicional em uma instrução de configuração

Uma variável condicional é definida como uma expressão ifNotZero (param1, param2). Nesta expressão, param1 é uma variável definida pelo usuário cujo valor é derivado de um servidor externo, como RADIUS, e param2 pode ser uma variável definida pelo usuário, uma função, operação, número ou string. Uma variável condicional pode ser definida pelo usuário ou variável de ID exclusivo (UID). reference Não pode ser uma variável predefinida ou UID. No Junos OS, as variáveis condicionais são suportadas apenas para os perfis dinâmicos de serviço.

As instruções de configuração nas quais as variáveis condicionais são referenciadas são chamadas de conditional instruções de configuração. Depois que a variável condicional é definida, ela é referenciada em dynamic-profiles instruções de configuração e processada quando o perfil de serviço é instanciado. As seguintes instruções de configuração de perfil de serviço oferecem suporte a variáveis condicionais:

• 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

O sistema segue o seguinte conjunto de regras ao avaliar as variáveis condicionais e as instruções de configuração condicionais durante a instanciação do perfil de serviço:

• Na função ifNotZero(param1, param2), se o valor de a param1 não for recebido de um servidor externo e se o valor padrão não estiver configurado, o valor da variável será tratado como diferente de zero e param2 será avaliado.

• Se o valor de param1 na função ifNotZero(param1, param2) for 0, NULL será retornado como o valor da expressão e param2 não será avaliado. Nesse caso, o valor da variável condicional se torna NULL e a instrução de configuração na qual a variável condicional é referenciada é ignorada.

• Se o valor de for diferente de param1 zero, então param2 é avaliado e seu valor é retornado como o valor da expressão.

Os exemplos de configuração a seguir filter-service cos-service mostram como as regras são aplicadas:

Exemplo de configuração do serviço de filtro

No exemplo de filter-service configuração, , output-filter-ref, policer1-ref, e term1 são variáveis condicionais, input-filter-refenquanto input "$input-filter-ref" precedence 50, output "$output-filter-ref" precedence 50, term $term1, e policer "$policer1-ref" são instruções de configuração condicionais. Neste exemplo, se o valor de input-filter-var for 0, o valor da variável input-filter-ref condicional se tornará NULL. Assim, toda a instrução de configuração, input “$input-filter-ref” precedence 50, na qual a variável condicional é referenciada, é ignorada. Se, no entanto, o valor da variável for diferente de zero, a instrução de configuração será processada durante a instanciação do perfil de serviço.

Exemplo de configuração de serviço de CoS

No exemplo de cos-service configuração, sch1_ref and sch2_ref são variáveis condicionais while forwarding-class best-effort scheduler "$sch1_ref" e forwarding-class assured-forwarding scheduler "$sch2_ref" são instruções de configuração condicionais. Semelhante à avaliação no exemplo de configuração, se o valor de qualquer variável referenciada filter-service em uma variável condicional for 0, a instrução de configuração na qual a variável condicional é referenciada será ignorada e não processada durante a instanciação do perfil de serviço CoS.