Configurando um servidor de visualização da web

É possível configurar seu Web Preview Server e o arquivo proxy-config.xml.

Antes de Iniciar

Importante: Este tópico não se aplica ao WebSphere Application Server tradicional, Liberty ou Liberty Core. Ela se aplica somente ao Web Preview Server.

Procedimento

  1. Na visualização Servidores, dê um clique duplo no Web Preview Server para abrir o editor do servidor. É possível usar as páginas Visão Geral e Segurança para configurar seu Web Preview Server.
  2. Na seção Informações Gerais da página Visão Geral, edite o nome do servidor, o nome do host e o ambiente de tempo de execução.
  3. Na seção Configurações de Comunicação, especifique o número da porta padrão a ser usado para o Web Preview Server.
    Nota: Se o número da porta padrão já estiver em uso, o Web Preview Server designará automaticamente um outro número de porta disponível.
  4. Na seção Publicação, selecione uma das configurações a seguir:
    Opção Descrição
    Nunca publicar automaticamente O ambiente de trabalho nunca publica arquivos no servidor.
    Publicar automaticamente quando os recursos forem alterados O ambiente de trabalho publica quando mudanças em um arquivo que está associado ao servidor são salvas e o intervalo de tempo integral a partir da configuração do intervalo de publicação passou. Essa é a definição padrão.
    Publicar automaticamente após um evento de construção O ambiente de trabalho publica quando mudanças em um arquivo que requer uma construção e está associado ao servidor são salvas, e o intervalo de tempo integral a partir da configuração do intervalo de publicação passou.
    Intervalo de publicação (em segundos) O número de segundos antes que o ambiente de trabalho publique os arquivos no servidor. Entretanto, se você fizer uma mudança subsequente nos arquivos antes desse intervalo de tempo ser concluído, a publicação será atrasada porque o cronômetro é reconfigurado. O ambiente de trabalho publica no servidor somente após o intervalo de tempo integral passar. Se você configurou o intervalo de publicação como 0 segundos, um arquivo será publicado assim que as mudanças em um arquivo forem salvas.
  5. Na seção Tempos Limites, configure a quantidade de tempo para a conclusão das solicitações.
  6. A seção Proxy Ajax contém uma tabela que mostra as URLs de acesso com suas URLs de destino resolvidas correspondentes. A seção de proxy Ajax tem uma regra de proxy padrão para caracteres curingas que são listados na coluna URL de Acesso (proxy/http/*) que você pode usar para definir o proxy de qualquer URL. Por exemplo, você pode usar esta URL http://localhost:8080/proxy/http/google.com no navegador da web para carregar a página da web do Google. Essa solicitação que é mapeada por meio proxy tem o mesmo resultado que emitir uma solicitação direta para http://www.google.com.
    Dica: É possível clicar com o botão direito em uma linha da tabela de URL de proxy Ajax e copiar a URL de Acesso, por exemplo proxy/us/en para colar em seu código JavaScript.
  7. Clique no link Configurar URLs de Proxy para editar o proxy-config.xml.
  8. No editor de Configuração do Proxy Ajax, inclua regras de proxy para mapeamento para os domínios remotos. Selecione o nó Regras do Proxy e clique em Incluir.
  9. Na janela Incluir Item, selecione um dos itens a seguir e edite seus atributos no editor:
    Opção Descrição
    Mapeamento Mapeia solicitações recebidas para uma URL de destino, com base em seu caminho de contexto.

    Especifique um atributo Caminho de Contexto e um atributo URL opcional. Por exemplo, você pode configurar um caminho de contexto de /ibmproducts para a URL http://www.ibm.com/products.

    Se a URL do proxy recebida for http://mywebsite.com/ibmproducts/us/en, o proxy encaminhará a solicitação para http://www.ibm.com/products/us/en. O proxy resolve os mapeamentos do caminho de contexto antes que você aplique a política de acesso correspondente. Dois mapeamentos de proxy padrão, http/* e us/en, são fornecidos para suportar protótipos rápidos.

    Metadados Especifica as propriedades gerais de configuração do proxy, por exemplo, parâmetros relacionados ao HTTP. O editor de proxy fornece algumas opções de metadados comuns com os pares de nome e valor padrão:
    forward-http-errors
    Por padrão, o proxy Ajax redireciona somente os códigos de status HTTP maiores ou iguais a 200 e menores que 400. Os códigos de status que ficarem fora do intervalo serão alterados automaticamente para um erro 404 Arquivo não Localizado. É possível encaminhar códigos de HTTP maiores ou iguais a 400 com uma mensagem, configurando o parâmetro forward-http-errors como true.
    unsigned_ssl_certificate_support
    Certificados não assinados são geralmente usados em serviços REST protegidos. Quando unsigned_ssl_certificate_support é designado, o proxy Ajax aceita qualquer certificado SSL. Esta opção é útil para teste e depuração. Não use essa opção em um ambiente de produção.
    basic-auth-support
    Configure essa opção como true se o serviço de destino usar autenticação básica. Um código de status HTTP de 401 (desautorizado) resulta em 403: Código de HTTP Proibido, a menos que o atributo basic-auth-support esteja ativado para essa solicitação específica.
    maxconnectionsperhost
    O maxconnectionperhost é um valor global que especifica o número máximo de conexões mantidas ativas para qualquer combinação de host ou porta. Por padrão, o valor é configurado como 2. Aumente o valor se seu aplicativo acessar mais de dois sites remotos para obter conteúdo.
    maxtotalconnections
    O maxtotalconnections é o total máximo de conexões que são suportadas pelo proxy. O valor padrão é 5. O valor que você escolher deve ser alto o suficiente para suportar o número de conexões simultâneas que você pode receber. Na prática, considere a forma como o contêiner da web é configurado e quantas conexões simultâneas o contêiner suporta.
    socket-timeout
    O tempo limite de soquete define o tempo limite do soquete padrão em milissegundos para aguardar dados após uma conexão ser estabelecida. O padrão é um valor de tempo limite de 0, que é interpretado como um tempo limite infinito.
    retries
    O parâmetro retries define o número de novas tentativas de soquete que o proxy Ajax executa antes de desistir de estabelecer uma conexão. O valor padrão é 2.
    tempo limite de conexão
    O tempo limite de conexão define o tempo em milissegundos antes que uma conexão seja estabelecida. Se nenhum valor for especificado, será usado o valor padrão de 60000. Se 0 for usado, o valor será interpretado para indicar que nenhum tempo limite é usado.
    Política Define uma política de acesso para um determinado padrão de URL.
    1. No campo ACF, ative ou desative a filtragem de conteúdo ativo. A filtragem de conteúdo ativo remove conteúdo ativo possivelmente doloso do conteúdo do aplicativo que é exibido em um navegador.
    2. Especifique o padrão no campo de atributo URL. Para cada pedido que chega, o proxy aplica a política com a melhor correspondência de URL. Se nenhuma política correspondente for localizada, o proxy rejeitará o pedido. Se uma política for localizada, os subelementos do elemento policy serão aplicados para verificar se deve-se aceitar a solicitação.
    3. Ativar ou desativar suporte para desafios de autenticação básica.
    É possível editar os subelementos de política a seguir:
    Métodos de ação
    Especifique pelo menos um método HTTP suportado. O proxy do Ajax suporta pedidos GET, POST, PUT, HEAD ou DELETE.
    Cookies
    Defina uma lista de nomes de cookies que identifiquem os cookies que você deseja que o proxy encaminhe ao domínio de destino. Para encaminhar cookies, o proxy filtra o valor do cabeçalho de cookie de acordo com os nomes de cookies definidos.
    Cabeçalhos HTTP
    Defina a lista de nomes de cabeçalhos que você deseja que o proxy encaminhe para o domínio de destino. Os nomes de cabeçalho podem incluir caracteres curinga.
    Tipos Mime
    Especifique a lista de tipos MIME aceitos. Os tipos mime se referem à resposta que o proxy recebe do servidor de destino. Se pelo menos um tipo MIME for especificado, o proxy aceitará somente respostas com um cabeçalho de resposta Content-Type que corresponde a um dos tipos MIME especificados. Se nenhum tipo mime for especificado, o proxy aceitará todas as respostas.
    Usuários
    Especifique uma lista de usuários ou grupos de usuários. Por exemplo, se você especificar AllAuthenticatedUsers, o proxy verificará se a solicitação foi enviada por um usuário autenticado.
  10. A seção de keystore do Proxy Ajax mostra informações para o keystore que é usado pelo proxy Ajax, tal como o caminho e tipo de keystore. É possível incluir ou remover certificados SSL do keystore para usar o proxy Ajax para recuperar informações a partir de URLs para as quais o servidor de destino usa certificados SSL não confiáveis. Depois de importar o certificado SSL de uma URL que aponta para um servidor com um certificado não confiável, é possível usar o Proxy Ajax para acessar essa URL sem receber uma mensagem de erro.
    1. Opcional: Se a senha do keystore foi mudada usando o software que é adquirido de outro fornecedor, atualize a senha no campo Senha do Keystore.
    2. Inclua ou remova certificados de servidor SSL do keystore que é especificado no campo Caminho do Keystore.
      1. Clique em Gerenciar Entradas do Keystore. A janela Gerenciar Keystore é aberta e mostra uma lista das entradas de keystore atuais, cada uma identificada por seu alias.
      2. Para remover uma entrada de keystore, selecione a entrada na lista de entradas de keystore e, em seguida, clique em Remover Entrada.
      3. Para incluir uma entrada de keystore, clique em Incluir Entrada. A janela Importar Certificado é aberta.
      4. No campo Alias de Entrada, especifique um alias para a entrada do novo keystore.
      5. Especifique se você deseja importar certificados SSL a partir de um servidor ou do sistema local.
        Importar certificados de um servidor para o keystore
        Insira a URL do servidor a partir do qual você deseja importar os certificados SSL.
        Importar um certificado local para o keystore
        Clique em Procurar Certificado para localizar o certificado SSL em seu sistema local que você deseja importar.
      6. Clique em OK para salvar suas mudanças e fechar a janela Importar Certificado. Na janela Gerenciar Keystore, clique em OK para salvar todas as suas mudanças no keystore.
  11. Na página Segurança, defina as configurações a seguir.
    Seção Descrição
    Geral Ativar ou desativar a segurança para aplicativos da web; revise os projetos atuais que são implementados no Web Preview Server.
    Nota: Você deve ativar a segurança para aplicativos da web que são implementados no Web Preview Server. É possível configurar a segurança no arquivo WebContent/WEB-INF/web.xml que está contido no projeto da web que você deseja implementar no servidor.
    Usuários e Grupos Gerenciar os usuários e grupos que são registrados no Web Preview Server.
    • Registrar novos usuários no servidor.
    • Remover usuários do servidor.
    • Registrar novos grupos no servidor.
    • Incluir ou remover usuários de grupos registrados.
    • Remover grupos do servidor.
    Funções de Segurança Gerenciar as funções de segurança que estão registradas no Web Preview Server.
    • Registrar funções de segurança no servidor.
    • Remover funções de segurança do servidor.
    • Mapear funções de segurança para usuários.
    • Remover funções de segurança de usuários.
    • Mapear funções de segurança para grupos.
    • Remover funções de segurança de grupos.
  12. Salve as alterações.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tconfigajaxtestserver.html