Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
Quando cria um portal do programador, é-lhe fornecido, por predefinição, um nome de domínio de exemplo do Apigee para aceder ao seu portal em direto no seguinte formato:
https://orgname-portalname.apigee.io
Em que orgname é o nome da organização e portalname é definido através do nome do portal convertido para todas as letras minúsculas e com espaços e travessões removidos.
Antes de lançar um portal do programador, recomendamos que forneça o seu próprio nome de domínio personalizado. Por exemplo, uma alternativa popular é:
https://developers.example.com
Para ver considerações sobre a utilização de um domínio personalizado com um fornecedor de identidade SAML, consulte o artigo Utilizar um domínio personalizado com o fornecedor de identidade SAML.
Passos para personalizar o seu domínio
Para personalizar o nome do domínio, siga estes passos:
- Registe o seu nome de domínio.
- Crie um certificado TLS para o seu domínio personalizado. Precisa do certificado quando criar o balanceador de carga.
- Determine o nome do anfitrião predefinido para o seu portal.
- Crie um grupo de pontos finais de rede (NEG) da Internet para definir o ponto final do back-end para o seu portal integrado para o balanceador de carga.
- Crie um balanceador de carga que aponte para o NEG da Internet e reserve o IP para os pedidos de clientes recebidos.
- Configure o domínio personalizado no seu portal.
- Atualize o DNS para criar um novo registo para o anfitrião de domínio personalizado.
Passo 1: registe o nome do domínio
Se precisar de registar um novo domínio, existem muitos sites de registo de domínios populares disponíveis, como o Google Domains. A escolha do site de registo de domínio é da sua responsabilidade.
Ao decidir o nome do domínio, tenha em atenção que os URLs fáceis de usar e legíveis para humanos são um componente essencial para melhorar a otimização do motor de pesquisa, conforme descrito em Implemente a otimização do motor de pesquisa (SEO).
Passo 2: crie um certificado TLS para o seu domínio personalizado
Crie um certificado TLS para o seu domínio personalizado através da sua ferramenta preferida, como o Let's Encrypt. Para mais informações, consulte:
Passo 3: determine o nome do anfitrião predefinido do seu portal
Para determinar o nome do anfitrião predefinido do seu portal:
Apresentar a lista de portais:
IU da Cloud Console
Na consola do Apigee in Cloud, aceda à página Distribuição > Portais.
IU clássica
Na IU do Apigee, selecione Publicar > Portais na barra de navegação lateral. É apresentada a lista de portais.
Copie o conteúdo no campo Localização para o portal para o qual quer criar um domínio personalizado. Por exemplo,
apigee-gcp-prod1-helloworld.apigee.io.Vai precisar deste valor no passo seguinte.
Passo 4: crie um NEG da Internet
Neste passo, cria um grupo de pontos finais de rede (NEG) da Internet para definir o ponto final do back-end para o balanceador de carga do seu portal integrado. Para mais informações, consulte o artigo Vista geral dos grupos de pontos finais de rede da Internet.
Na Google Cloud consola, aceda à página Painel de controlo e selecione ou crie um Google Cloud projeto.
Selecione Compute Engine > Grupos de pontos finais da rede no navegador.
Clique em Criar grupo de pontos finais de rede.
Configure os seguintes campos:
Campo Valor Nome Introduza um nome para o NEG da Internet. Tipo de grupo de pontos finais da rede Selecione Grupo de pontos finais da rede (Internet). Novo ponto final de rede - Adicionar através de: selecione Nome do domínio totalmente qualificado e porta.
- Nome do domínio totalmente qualificado: introduza o nome do domínio predefinido que copiou no passo 3: determine o nome do anfitrião predefinido para o seu portal.
Pode deixar os campos restantes definidos como predefinições.
Clique em Criar.
O NEG da Internet é criado.
Passo 5: crie um balanceador de carga
Crie um balanceador de carga que aponte para o NEG da Internet e reserve o IP para os seus pedidos de clientes recebidos.
Selecione o tipo de balanceador de carga
Na Google Cloud consola, aceda à página Equilíbrio de carga.
- Clique em Criar equilibrador de carga.
- Em Tipo de balanceador de carga, selecione Balanceador de carga de aplicações (HTTP/HTTPS) e clique em Seguinte.
- Para Público ou interno, selecione Público (externo) e clique em Seguinte.
- Para a Implementação global ou de região única, selecione Melhor para cargas de trabalho globais e clique em Seguinte.
- Para Geração do balanceador de carga, selecione Balanceador de carga de aplicações externo global e clique em Seguinte.
- Clique em Configurar.
Configure o balanceador de carga
Clique em cada categoria e configure o equilibrador de carga conforme descrito na tabela seguinte.
Categoria Passos Configuração da interface Reserve o endereço IP para os seus pedidos de cliente recebidos e carregue o certificado TLS criado no Passo 2: crie um certificado TLS:
- Na secção Criar Application Load Balancer externo global, posicione o cursor sobre Configuração do front-end e clique na seta.
- Introduza um nome para o frontend no campo Nome.
- Selecione HTTPS no menu pendente Protocolo.
- No menu pendente Endereço IP, selecione Criar endereço IP
É apresentado o diálogo Reservar um novo endereço IP estático. - Introduza um nome para o endereço IP estático no campo Nome.
- Opcionalmente, introduza uma descrição.
- Clique em Reservar.
- Armazenar o endereço IP que foi reservado para utilização na configuração do registo DNS.
- Selecione Criar um novo certificado no menu pendente Certificado.
A janela Criar um novo certificado desliza para abrir. - Introduza um nome para o novo certificado no campo Nome.
- Selecione Carregar o meu certificado em Modo de criação.
- Carregue os detalhes do certificado TLS, incluindo a chave pública, a cadeia de certificados e a chave privada.
- Clique em Criar.
- Clique em Concluído para criar o novo endereço IP e porta de front-end.
Configuração do back-end Configure a configuração de back-end para direcionar o tráfego de entrada para o NEG da Internet criado no Passo 4: crie um grupo de pontos finais de rede (NEG) da Internet:
- Na secção Crie um equilibrador de carga de aplicações externo global, posicione o cursor sobre Configuração do back-end e clique na seta.
- Na secção Serviços de back-end e contentores de back-end, selecione Serviços de back-end > Criar um serviço de back-end no menu pendente.
A janela Criar serviço de back-end desliza para abrir. - Introduza um nome no campo Nome.
- Selecione Grupo de pontos finais da rede da Internet no menu pendente Tipo de back-end.
- Selecione HTTPS como o protocolo.
- Na secção Novo back-end, selecione o NEG da Internet que criou no Passo 4: crie um grupo de pontos finais de rede (NEG) da Internet no menu pendente Grupo de pontos finais de rede da Internet e clique em Concluído.
- Desmarque a caixa de verificação Ativar Cloud CDN.
- Pode deixar todos os outros valores definidos como predefinições.
- Clique em Criar.
Regras de anfitriões e caminhos Configure as regras de anfitriões e caminhos para determinar como o seu tráfego vai ser direcionado:
- Na secção Crie um Application Load Balancer externo global, posicione o cursor sobre Regras de anfitrião e caminho e clique na seta.
- Clique em Regra avançada de anfitrião e caminho (redirecionamento de URL, reescrita de URL) em Modo.
- Na secção Nova regra de anfitrião e caminho:
- Selecione Encaminhar tráfego para um único back-end no menu pendente Ação.
- Expanda Ação do suplemento (reescrita do URL).
- Introduza o nome do domínio predefinido que copiou no Passo 3: determine o nome do anfitrião predefinido para o seu portal no campo Reescrita do anfitrião.
- Selecione o serviço de back-end que configurou no menu pendente Back-end.
- Clique em Concluído.
Clique em Criar na página Criar Application Load Balancer externo global.
Passo 6: configure o domínio personalizado no seu portal
Para configurar o domínio personalizado no seu portal:
Apresentar a lista de portais:
IU da Cloud Console
Na consola do Apigee in Cloud, aceda à página Distribuição > Portais.
IU clássica
Na IU do Apigee, selecione Publicar > Portais na barra de navegação lateral. É apresentada a lista de portais.
Selecione o seu portal na lista.
Selecione Definições.
Clique no separador Domínios.
Introduza o nome do domínio personalizado no campo Domínio.
Clique em Ativar.
Teste se, quando acede ao domínio personalizado num navegador, é direcionado para o portal integrado.
Consulte também os artigos Editar um domínio personalizado e Desativar um domínio personalizado.
Passo 7: atualize o DNS
No seu sistema de DNS, crie um novo registo para o anfitrião de domínio personalizado.
Para criar uma zona do Cloud DNS, siga os passos descritos no artigo Gerir zonas. Certifique-se de que configura os seguintes campos:
| Campo | Descrição |
|---|---|
| Tipo de zona | Selecione Público. |
| Nome da zona | Introduza um nome significativo para a zona. Por exemplo: mycompany-zone
|
| Nome de DNS | Introduza o sufixo da zona com um nome de domínio que lhe pertence. Por exemplo: mycompany.com
|
Depois de criar uma zona, na página Detalhes da zona, clique em Adicionar conjunto de registos e siga os passos descritos no artigo Gerir registos. Certifique-se de que configura os seguintes campos:
| Campo | Descrição |
|---|---|
| Nome de DNS | Especifique o prefixo do seu nome DNS. O sufixo que definiu para a zona do Cloud DNS também é apresentado, mas não é editável. Por exemplo: developers.mycompany.com
|
| Tipo de registo de recurso | Selecione A (a predefinição). |
| TTL | Defina o valor pretendido ou deixe-o definido como 5 (predefinição). |
| Unidade de TTL | Defina o valor pretendido ou deixe a definição como minutos (predefinição). |
| Endereço IPv4 | Introduza o endereço IP externo que reservou quando criou o balanceador de carga. |
Editar um domínio personalizado no seu portal
Para editar um domínio personalizado no seu portal:
Apresentar a lista de portais:
IU da Cloud Console
Na consola do Apigee in Cloud, aceda à página Distribuição > Portais.
IU clássica
Na IU do Apigee, selecione Publicar > Portais na barra de navegação lateral. É apresentada a lista de portais.
Selecione o seu portal na lista.
Selecione Definições.
Clique no separador Domínios.
Edite as informações do domínio personalizado.
Clique em Guardar.
Desativar um domínio personalizado no seu portal
Para desativar um nome do domínio personalizado no seu portal:
Apresentar a lista de portais:
IU da Cloud Console
Na consola do Apigee in Cloud, aceda à página Distribuição > Portais.
IU clássica
Na IU do Apigee, selecione Publicar > Portais na barra de navegação lateral. É apresentada a lista de portais.
Selecione o seu portal na lista.
Selecione Definições.
Clique no separador Domínios.
Clique em Desativar.
Clique em Desativar no comando para confirmar a operação.
O domínio personalizado está desativado e os campos são limpos.