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 por essas variáveis a partir 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 assinantes.

Você pode usar qualquer uma das seguintes declaraçõ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 autentica. Especificar um valor padrão fornece uma configuração independente para a declaração associada ou um backup para a configuração da declaração se o servidor externo estiver inacessível ou não conter um valor para a variável.

• equals— Configure uma expressão para uma variável definida pelo usuário que é avaliada no momento da execução e devolvida como o valor variável.

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

• uid— Configure uma ID única para filtros parametrizados e CoS em um perfil dinâmico criado para serviços.

• uid-reference— Configure uma variável que faz referência a uma ID única para filtros parametrizados ou CoS em um perfil dinâmico criado para serviços.

Nota:

A ordem em que 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 obtenha valores de padrões ou por meio de expressões variáveis, 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 cordas e operações — para uso como variáveis dentro de perfis dinâmicos. Você configura expressões variáveis no nível de [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 apenas dentro de uma estrofe variável de um perfil dinâmico.

• Perfis dinâmicos que contenham expressões para variáveis definidas pelo usuário devem ser usados apenas para ativação de serviços.

• Você geralmente atribui expressões apenas a variáveis definidas pelo usuário. Você não pode 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 ser contidas entre aspas (" ").

• As cordas dentro das expressões devem ser citadas dentro de cotações únicas (" ") e as marcas de cotação única podem conter apenas strings.

• O espaço branco é tratado como um dirigível para todas as operações e operadores. As cordas que contêm espaços que você cria dentro das expressões são tratadas como cordas individuais e incluem qualquer espaço branco líder ou em trilha. Por exemplo, para criar um perfil de serviço:

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

• As expressões podem se referem 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 referência a seguir é incorreta:

• Para criar uma interface dinâmica e um conjunto de interface 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 serviço RADIUS VSA como "vídeo de serviço(valor1, valor2)" que contém duas ou menos variáveis obrigatórias na definição dinâmica do perfil de serviço "vídeo de serviço" é bem-sucedida. A ativação do serviço falha se pelo menos uma variável obrigatória não tiver nenhum valor associado a ela, seja por meio de avaliação de atributo "padrão" ou "igual".

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

Tabela 1: Operadores e funções

Operação	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 Aritmética	/	Esquerda	2	Divide o elemento à esquerda do operador pelo elemento à direita do operador.
Modulo aritmético	%	Esquerda	2	Divide o elemento à esquerda do operador pelo elemento à direita do operador e devolve o restante inteiro. Se o elemento à esquerda do operador for menor do que o elemento à direita do operador, o resultado será o elemento à esquerda do operador.
Concatenação	##	Esquerda	3	Cria uma nova sequência juntando os valores de string à esquerda do operador e os valores à direita do operador juntos.
Máximo	max(param1,param2)	Esquerda	4	Leva o máximo dos dois valores aprovados como parâmetros.
Mínimo	min(param1,param2)	Esquerda	4	Leva o mínimo dos dois valores aprovados como parâmetros.
Redondo	rodada(param1)	-	4	Arredonda o valor para o inteiro mais próximo.
Truncar	trunc(param1)	-	4	Trunca um valor não inteiro para o valor deixado do ponto decimais.
Converta em String	toStr(param1)	-	4	Converte a variável dentro dos parênteses em uma corda terminada nula.
Converta-se em Integer	toInt(param1)	-	4	Converte o parâmetro em um inteiro. Uma única corda 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	Devolu o segundo parâmetro se o primeiro parâmetro não for zero. Devolu NULL se o primeiro parâmetro for zero.
Parênteses	( )	-	5	Grupos de operações e operadores para alcançar resultados diferentes da simples precedência; efetivamente tem a mais alta precedência.

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

A Tabela 2 lista os possíveis cenários de erro de expressão e as medidas tomadas pelo software do roteador.

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

Erro	Ocorrência	Ação	Valor variável
Erro de análise	Fase de verificação de confirmação	O Commit falha	não aplicável
Erro de dependência de variável circular	Fase de verificação de confirmação	O Commit falha	não aplicável
As variáveis dentro das expressões não são definidas	Fase de verificação de confirmação	O Commit falha	não aplicável
Divida por zero	Instanciação de perfil	A instanciação do perfil falha	Zero (0)
Adicionar string a um número	Instanciação de perfil	A instanciação do perfil falha	Zero (0)
Erro de transbordamento	Instanciação de perfil	A instanciação do perfil falha	Indefinido
Erro de subfluxo	Instanciação de perfil	A instanciação do perfil falha	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 declaração associada ou um backup para a configuração da declaração se o servidor RADIUS estiver inacessível ou o atributo VSA não conter um valor.

A configuração condicional envolve duas etapas principais:

1. Definir a variável condicional

2. Fazendo referência à variável condicional em uma declaraçã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 ID única (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 declarações de configuração em que as variáveis condicionais são mencionadas são chamadas conditional de declarações de configuração. Após a variável condicional ser definida, elas são referenciadas em dynamic-profiles declarações de configuração e são processadas quando o perfil do serviço é instanciado. As declarações de configuração do perfil de serviço a seguir 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 enquanto avalia as variáveis condicionais e as declarações de configuração condicionais durante a instanciação do perfil de serviço:

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

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

• Se o valor não param1 for zero, então param2 é avaliado e seu valor é devolvido como o valor da expressão.

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

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

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

Exemplo de configuração de serviço cos

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