Resumo

  • A RFC 10009 fornece material YANG 1.1 reutilizável para clientes e servidores HTTP: URI, versões permitidas, parâmetros opcionais de TLS e proxy, configuração HTTP de servidor e uma composição conveniente de pilha de escuta.
  • Os módulos definem um typedef e agrupamentos; sozinhos, não criam nós acessíveis por protocolo. Um modelo preenchido registra intenção de configuração, não uma escuta, autenticação, admissão de requisição ou efeito observado.

RFC 10009 é valiosa justamente por ser anterior à execução. O agrupamento ietf-http-client permite declarar uma URI, as versões HTTP que a política local aceita, material TLS do cliente e uma escolha de conexão por proxy. O ietf-http-server descreve a parcela HTTP de uma pilha de servidor. Um agrupamento adicional pode compor HTTP com TCP, TLS ou QUIC/UDP. Isso dá a um modelo consumidor uma linguagem coerente para expressar intenção sem fingir que todas as camadas passaram a ser o mesmo fato operacional.

O lado cliente mostra a disciplina da RFC. Seu único elemento obrigatório é uri, com esquema e host obrigatórios. O esquema e a autoridade da URI carregam informação sobre o transporte inferior; não registram uma resposta DNS, não observam uma rota e não comprovam a aceitação de um certificado. protocol-versions mostra o que a configuração permite. supported-versions, somente leitura, mostra o que a implementação sabe suportar independentemente da escolha configurada. Material TLS opcional pode nomear identidade do cliente e elementos de autenticação do servidor; campos de proxy podem nomear um caminho intermediário. Nenhum deles garante que o par específico será alcançado, reconhecido ou aceito. Sem parâmetros TLS, conexões TLS não são possíveis sob aquela configuração; com eles, apenas se abre uma possibilidade que ainda precisa de evidência de execução.

No servidor, a fronteira é a mesma. O agrupamento HTTP cobre a parte HTTP da pilha, e não as configurações de TCP ou TLS. A conveniência do listen stack junta os agrupamentos, mas não apaga suas responsabilidades. server-name, versões permitidas e um armazenamento local Basic opcional e condicionado a recurso são escolhas de configuração. Não demonstram que um processo ligou uma porta, que 80 ou 443 está de fato associado, que uma credencial foi aceita, que a identidade do par correspondeu à política ou que a aplicação permitiu uma operação. Uma árvore elegante pode coexistir com um listener ausente, uma rota quebrada ou uma recusa da aplicação.

O limite mais importante está na própria forma do documento: os três módulos da RFC 10009 definem tipos e agrupamentos reutilizáveis, mas não definem, por conta própria, nenhum nó de dados acessível por protocolo. Um módulo consumidor precisa instanciá-los. Antes de qualquer tráfego, já há dois registros diferentes: o material reutilizável e o desenho concreto de nós adotado pelo consumidor. Depois vêm a mudança de gestão autorizada, a revisão realmente implantada, a escuta vinculada, o transporte, a validação do par, a troca HTTP, a decisão da aplicação e o efeito observado.

Chamar toda a sequência de “endpoint configurado” converte uma declaração inicial numa conclusão que não foi demonstrada.

A autoridade da configuração termina antes da autoridade do serviço

A seção de segurança preserva essa separação. As implicações dos módulos de agrupamento dependem dos módulos que os consomem. NETCONF e RESTCONF exigem transporte seguro e autenticação mútua para a gestão; NACM pode limitar operações e conteúdo de gestão acessíveis a um usuário. Isso responde quem pode ler ou alterar uma superfície de controle. Não autoriza automaticamente um cliente HTTP a executar qualquer operação de negócio nem prova que a entrega ocorreu.

O typedef de versões HTTP mantido pela IANA exige o mesmo cuidado. Um registro oferece vocabulário comum; uma implementação pode anunciar uma capacidade local. Nem o registro nem a capacidade afirmam que determinada versão foi habilitada, negociada com um par, aceita por um intermediário ou útil para uma aplicação. Referência, configuração, troca e efeito são evidências de naturezas diferentes.

Esta é uma leitura editorial, não uma obrigação do IETF. A especificação inicial mínima de Heng Lu explica a utilidade de uma camada comum e deliberadamente pequena: ela torna componentes componíveis e deixa decisões futuras no contexto local. A primazia do código em execução propõe a prova prática: a afirmação de que o serviço funcionou pertence ao registro de execução reconciliado, não apenas ao modelo que o antecedeu.