Resumo

  • A RFC 9907 é a BCP 216, publicada em março de 2026; ela obsoleta a RFC 8407 e atualiza a RFC 8126, oferecendo orientação para autores e revisores de especificações que contêm modelos de dados YANG, inclusive módulos mantidos pela IANA.
  • O controle não termina quando um parser aceita o texto. Limites de código, nomes, rastreabilidade de revisões, semântica de datastore, exemplos, segurança e autoridade do registro precisam ser explícitos.
  • Um modelo de dados YANG é uma abstração para dados, estado e operações de gerenciamento. Um módulo é um componente de código individual que implementa esse modelo; não são sinônimos.

A diferença entre sintaxe válida e comportamento interpretável aparece quando a especificação não explica como configuração, estado operacional e operações se relacionam aos datastores da arquitetura NMDA. Dois leitores podem aceitar o mesmo módulo e, ainda assim, formar expectativas diferentes sobre onde observar um valor, quando uma mudança passa a valer ou quem pode alterá-la. A RFC 9907 amplia a revisão para incluir linguagem, documentação e semântica operacional, em vez de tratar a análise sintática como aprovação suficiente.

Módulos e submódulos normativos são componentes de código e devem ser delimitados por CODE BEGINS e CODE ENDS. Os nomes publicados precisam ser únicos; módulos normativos do IETF devem começar com ietf-, enquanto módulos de exemplo devem usar example-. Um exemplo serve para esclarecer estrutura ou uso, mas não se torna uma exigência normativa por estar incluído no documento.

O cabeçalho do módulo também é uma forma de controle. A descrição deve incluir a declaração de copyright vigente do IETF Trust e identificar o registro YANG Parameters. Referências externas que não aparecem nos módulos importados devem estar em declarações reference. Cada revisão publicada precisa de uma declaração revision cuja referência identifique o documento que contém aquele módulo. Essa ligação transforma o código extraído de um RFC em um artefato rastreável, não em um fragmento órfão.

Para módulos YANG mantidos pela IANA, a política do registro é a autoridade. Não se deve substituir o procedimento de registro, atualização e revisão por edições ad hoc do texto de módulo gerado. O texto gerado é uma representação; a política define quem pode propor mudanças, como elas são registradas e qual processo mantém a coerência. A RFC 9907 acrescenta essa orientação específica à base geral da RFC 8126. Isso não é uma mudança de protocolo de rede.

A análise de segurança deve tratar dos dados, estados e operações expostos pelo modelo, incluindo efeitos sobre controle de acesso, integridade, confidencialidade e consumo de recursos. O revisor deve perguntar se a semântica está clara nos termos da NMDA, se os exemplos continuam não normativos, se cada revisão aponta para o RFC correto e se as Considerações sobre a IANA descrevem um procedimento aplicável. Nenhuma dessas respostas pode ser substituída por “o módulo foi analisado com sucesso”.

Fontes