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
- 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.
- 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.
- 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.
- 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. - Na seção Tempos Limites, configure a quantidade de tempo para a conclusão das solicitações.
- 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.
- Clique no link Configurar URLs de Proxy para editar o proxy-config.xml.
- 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.
- 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. - 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.
- 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.
- 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.
- 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.
- Opcional: Se a senha do keystore foi mudada usando o software que é adquirido de outro fornecedor, atualize a senha no campo Senha do Keystore.
- Inclua ou remova certificados de servidor SSL do keystore
que é especificado no campo Caminho do Keystore.
- 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.
- Para remover uma entrada de keystore, selecione a entrada na lista de entradas de keystore e, em seguida, clique em Remover Entrada.
- Para incluir uma entrada de keystore, clique em Incluir Entrada. A janela Importar Certificado é aberta.
- No campo Alias de Entrada, especifique um alias para a entrada do novo keystore.
- 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.
- 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.
- 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.
- Salve as alterações.
Tópico pai: Testando em um Web Preview Server
Tópico pai: Configurando servidores para testar e publicar