Noções básicas sobre o suporte do Edge para módulos Node.js

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Com qual versão do Node.js há suporte Apigee Edge?

Atualmente, o Edge oferece suporte ao Node.js 0.10.32.

Quais módulos Node.js padrão são com suporte no Edge?

Outros módulos compatíveis

Esta seção lista outros módulos que não são compatíveis com o Node.js padrão, mas compatível com o Trireme e o Trireme em execução no Apigee Edge. O Trireme é o contêiner Node.js de código aberto executado no Apigee Edge. Ele foi projetado para executar scripts Node.js em uma máquina virtual Java (JVM). Todas as esses módulos estão disponíveis no NPM.

Suporte para os módulos Node.js usados com frequência

Restrições em scripts Node.js

Observe, entretanto, que o Edge impõe certas restrições aos scripts Node.js, como seguinte:

• Os aplicativos Node.js no ambiente Apigee Edge não podem acessar serviços na Internet via UDP devido à arquitetura de rede de borda.

• O acesso ao sistema de arquivos é restrito ao diretório em que o script Node.js foi iniciado: o /resources/node. Os scripts Node.js podem ler e gravar arquivos nesse diretório, para como uma área de rascunho temporária, mas não há garantias de quanto tempo os arquivos persistem.

• As tentativas de detectar conexões TCP de entrada geram uma exceção.

• A funcionalidade para manipular o ID do usuário, as associações a grupos e o diretório de trabalho não está suporte.

• Para entrada padrão, você está limitado a transmitir argumentos usando a classe ScriptTarget de TargetEndpoint. Consulte Avançado ScriptTarget para mais informações.
  
• Para saída padrão, você só pode usar o botão "Registros" do Node.js no Edge de gerenciamento de identidade e acesso do proxy. Também é possível usar "apigeetool getlogs" kubectl. Para mais consulte Como implantar um app Node.js independente.
  
• Os módulos que dependem de código nativo não são compatíveis.
  
• Módulos que dependem dos recursos do EcmaScript 6, como promessas e geradores, não são suporte.
  
• As sinalizações de ambiente de execução do Node.js, como "harmony-proxies" não têm suporte.

Como definir restrições de conexão IP on Edge para nuvem privada

O Edge para nuvem privada pode impedir que o código Node.js acesse endereços IP desde com "10.", "192.168" e localhost. Se você tentar acessar esses endereços IP, verá um erro no formulário:

{ [Error: connect EINVAL] message: 'connect EINVAL', code: 'EINVAL', errno: 'EINVAL', syscall: 'connect' }

Você pode modificar essas restrições definindo a propriedade conf_nodejs_connect.ranges.denied no message-processors.properties. de cada processador de mensagens. Por padrão, essa propriedade tem o valor:

• Edge 4.17.05 e versões anteriores: conf_nodejs_connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
• Edge 4.17.09 e mais recentes: conf_nodejs_connect.ranges.denied=, que significa sem restrições)

Para definir essa propriedade:

1. Abra o arquivo message-processor.properties em um editor. Se o arquivo não existir, crie-o:
   > vi /<inst_root>/apigee/customer/application/message-processor.properties
2. Defina a propriedade como desejado. Por exemplo, para negar acesso apenas ao localhost:
   conf_nodejs_connect.ranges.denied=127.0.0.1/32
3. Salve as alterações.
4. Verifique se o arquivo de propriedades é de propriedade da Apigee usuário:
   &gt; chown apigee:apigee /<inst_root>/apigee/customer/application/message-processor.properties
5. Reinicie o processador de mensagens:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-message-processor reiniciar

Como entender o suporte para os módulos http e https

Todos os aplicativos Node.js em execução no Apigee Edge precisam usar o http ou https para detectar as solicitações recebidas. Se você implantasse um script que não detecta solicitações de entrada, ele simplesmente seria executado e sairia.

O método listen dos módulos http e https na O Node.js usa um número de porta como parâmetro. Exemplo:

svr.listen(process.env.PORT || 9000, function() {
   console.log('The server is running.');
});

Essa "porta" é obrigatório em Node.js, mas o Apigee Edge ignora esse parâmetro. Em vez disso, o proxy de API em que o script Node.js é executado especifica o "host virtual" que ele ouve, e o aplicativo Node.js usa os mesmos hosts virtuais, assim como qualquer outro Apigee Edge proxy.

Cada ambiente na Apigee tem pelo menos um host virtual. O host virtual define o HTTP para conexão com a organização da Apigee. Todos os proxies de API em um ambiente compartilham o nos mesmos hosts virtuais. Por padrão, dois hosts virtuais estão disponíveis para cada ambiente: default e secure. Para obter mais informações, consulte Get Virtual Host e API de desenvolvimento do app.

O comando apigeetool deploynodeapp gera um wrapper de proxy do Apigee Edge em torno do aplicativo Node.js. Quando implantado, o aplicativo Node.js detecta no host virtual definido para o ambiente. O URL de um aplicativo Node.js será sempre http://{org_name}-{env_name}.apigee.net:

Como processar as mensagens recebidas solicitações

Como outros aplicativos da Apigee Edge, se o aplicativo de proxy estiver configurado para detectar no secure host virtual, ele aceitará solicitações de entrada usando HTTPS.

Como processar mensagens enviadas solicitações

Além de receber o tráfego de entrada, os aplicativos Node.js na Apigee Edge podem usar a Módulos http e https para fazer solicitações de saída como qualquer outro Node.js. para o aplicativo. Esses módulos funcionam como sempre no Node.js.

Noções básicas sobre o suporte para o módulo TLS

A Apigee Edge oferece suporte ao módulo tls do Node.js. Este módulo usa o OpenSSL para oferecer Transport Layer Security (TLS) e/ou Secure Socket Layer comunicação de stream criptografado (SSL). É possível usar o módulo tls para criar objetos conexões a serviços de back-end de aplicativos Node.js em execução no Edge.

Para entender como o módulo tls funciona no Apigee Edge, é importante entender como virtual hosts são usados no Apigee Edge. Todos os ambientes da Apigee tem, no mínimo, um host virtual. O host virtual define as configurações HTTP para conexão com o organização da Apigee. Todos os proxies de API em um ambiente compartilham os mesmos hosts virtuais. Por padrão, Dois hosts virtuais estão disponíveis para cada ambiente: default e secure. Para mais informações sobre hosts virtuais, consulte Get Virtual Host e API de desenvolvimento do app.

Agora, vamos conferir como o Apigee Edge lida com a comunicação TLS (SSL) para mensagens de entrada e saída. solicitações em aplicativos Node.js:

Como processar as mensagens recebidas solicitações

Dependendo da configuração dos hosts virtuais na sua organização, o Edge oferece esses opções:

• Se o proxy de API estiver configurado para detectar no host virtual default, ele aceita solicitações por HTTP.
• Se o proxy de API estiver configurado para detectar no host virtual secure, ele aceita solicitações por HTTPS. O URL estará no domínio apigee.net, e um certificado SSL curinga para *.apigee.net. Contanto que os apps para o domínio apigee.net, o certificado SSL será validado normalmente.

Como processar mensagens enviadas solicitações

É possível fazer solicitações com o módulo tls da mesma forma que você faria normalmente em Node.js. Basicamente, é preciso adicionar chaves e certificados do lado do cliente (arquivos .pem) para o diretório resources/node e carregue-os no script. Para mais informações sobre como usar o módulo tls e os métodos dele, consulte a Documentação do módulo TLS do Node.js.

Configuração avançada do ScriptTarget

<TargetEndpoint name="default">
  <ScriptTarget>
     <ResourceURL>node://hello.js</ResourceURL>
     <EnvironmentVariables>
         <EnvironmentVariable name="NAME">VALUE</EnvironmentVariable> 
     </EnvironmentVariables>
     <Arguments>
         <Argument>ARG</Argument>
     </Arguments>
  </ScriptTarget>
</TargetEndpoint>