Como permitir que a IU de borda acesse endereços IP locais

Edge para nuvem privada v. 4.16.05

Há vários lugares em que a IU do Edge tenta acessar um endereço IP local:

  • A ferramenta de trace na interface do Edge pode enviar e receber solicitações de API para qualquer URL especificado. Em determinados cenários de implantação em que os componentes do Edge são co-hospedados com outros serviços internos, um usuário mal-intencionado pode usar indevidamente o poder da ferramenta Trace fazendo solicitações para endereços IP privados.
  • Ao criar um proxy de API com base em uma especificação OpenAPI, ela descreve elementos da API, como caminho base, caminhos e verbos, cabeçalhos e muito mais. Como parte da especificação, é possível especificar um caminho base do proxy que se refere a um endereço IP privado.
  • Ao criar um proxy de API com base em um arquivo WSDL localizado no sistema de arquivos local.

Por padrão, a interface do Edge não pode referenciar endereços IP privados. A lista de endereços IP particulares inclui:

  • Endereço de loopback (127.0.0.1 ou localhost)
  • Endereços locais do site (para IPv4: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)
  • Qualquer endereço local (qualquer endereço que seja resolvido para localhost).

Se você quiser ativar a interface do Edge para acessar endereços IP particulares, defina os seguintes tokens:

  • Para a ferramenta Trace, a propriedade conf_apigee-base_apigee.feature.enabletraceforinternaladdresses está desativada por padrão. Defina como true para permitir que a ferramenta Trace acesse endereços IP privados.
  • Para especificações da OpenAPI, a propriedade conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses está desativada por padrão. Defina como verdadeiro para permitir que uma OpenAPI acesse endereços IP particulares. Requer o Edge 4.16.09.01. Consulte as notas da versão 4.16.05.05 do Edge para nuvem privada para saber mais.
  • Para arquivos WSDL, a propriedade conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses está desativada por padrão. Defina como verdadeiro para ativar o upload de um arquivo WSDL de endereços IP privados.

Para definir essas propriedades como verdadeiras:

  1. Abra o arquivo ui.properties em um editor. Se o arquivo não existir, crie-o.
    > vi /<inst_root>/apigee/customer/application/ui.properties
  2. Defina as seguintes propriedades como true:
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
  3. Salve as alterações em ui.properties.
  4. Reinicie a IU do Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restart

A IU do Edge agora pode acessar endereços IP locais.