Nesta etapa, é possível optar por expor a nova instância da Apigee a solicitações externas ou mantê-la
privada (e permitir apenas solicitações de dentro do firewall).
A maneira como você acessa o proxy de API depende se você permite solicitações externas ou restringe o acesso apenas a solicitações internas.
Tipo de acesso
Descrição do processo de configuração e implantação
Sem acesso à Internet
Permita apenas o acesso interno ao proxy da API.
É possível fazer o download do proxy Hello World do GitHub e implantá-lo na instância da Apigee. Você precisa criar uma nova VM dentro da rede e conectar-se a ela. Na
nova VM, é possível enviar uma solicitação ao proxy de API.
Ativar o acesso à Internet
Permita o acesso externo ao proxy de API.
A Apigee implanta um proxy Hello World na sua instância da Apigee. Depois,
é possível enviar uma solicitação ao proxy de API de sua máquina administrativa ou de qualquer
máquina ativada para rede, esteja ela dentro ou fora do firewall.
Cada uma destas abordagens é apresentada em uma guia nas instruções abaixo.
Realizar a etapa
Selecione Acesso externo ou Acesso interno:
Acesso externo
Veja nesta seção como configurar o roteamento a partir do Console do Cloud quando quiser permitir
o acesso externo ao proxy de API.
Permissões exigidas para a tarefa
É possível conceder ao provisionador da Apigee um papel predefinido que inclui as permissões necessárias para concluir essa tarefa
ou conceder permissões mais refinadas para fornecer o privilégio mínimo necessário. Consulte Papéis predefinidos e Permissões de roteamento de acesso.
Para configurar o roteamento para acesso externo no console do Cloud:
Clique em createEditar para abrir o painel
Configurar acesso.
Selecione Ativar acesso à Internet.
Escolha uma das seguintes opções na seção Tipo de domínio:
Certificados de domínio, sub-rede e SSL gerados automaticamente: escolha essa opção
para usar o serviço de DNS curinga nip.io e um certificado gerenciado pelo Google para proteger seu domínio.
A Apigee cria automaticamente um balanceador de carga L7 externo global para encaminhar o tráfego para o ambiente de execução.
Personalizar: escolha essa opção se quiser personalizar o nome do domínio, o certificado SSL ou a sub-rede. A Apigee cria automaticamente um balanceador de carga L7 externo global para encaminhar o tráfego para o ambiente de execução.
Você pode marcar ou desmarcar qualquer uma das seguintes opções para inserir detalhes personalizados:
Domínio: opcional. Digite o nome de domínio personalizado.
Rede: opcional. Selecione um nome de rede disponível no menu suspenso.
Sub-rede: opcional. Selecione um nome de sub-rede disponível no menu suspenso. A sub-rede
selecionada precisa estar na mesma região que a instância de ambiente de execução.
Certificado SSL: opcional. Selecione um certificado autogerenciado atual ou forneça um novo.
Para selecionar um certificado, faça o seguinte:
Navegue pelo sistema de arquivos e selecione o certificado que você quer usar.
Clique em Salvar SSL.
Para fornecer um novo certificado, faça o seguinte:
clique em Add new;
Nos respectivos campos, procure no sistema de arquivos e anexe os arquivos que contêm o certificado e a chave privada.
Ambos devem estar no formato PEM.
Clique em Salvar SSL.
Clique em Configurar acesso.
A Apigee prepara a instância para
acesso externo. Isso inclui a criação de regras de
firewall, o upload de certificados e o desenvolvimento de um balanceador de carga.
Esse processo pode levar vários minutos.
Acesso interno
Nesta seção, descrevemos como configurar o roteamento quando você está usando o Console do Cloud e não quer permitir acesso externo ao proxy de API.
Em vez disso, você quer limitar o acesso a solicitações internas apenas originadas
na VPC.
Para configurar o roteamento para acesso interno no Console do Cloud:
Clique em createEditar para abrir o painel
Configurar acesso.
Selecione Sem acesso à Internet.
Clique em Configurar acesso.
Clique em Próxima.
Clique em Enviar para iniciar o processo de provisionamento.
O processo de provisionamento pode levar até 40 minutos para ser concluído. Se você
quiser sair da página enquanto o provisionamento estiver em andamento, uma notificação
será exibida em
Notificações no console do Cloud quando a operação for concluída.
Após a conclusão do provisionamento, a página Visão geral da Apigee
será exibida e você poderá começar a explorar a Apigee.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis documentation is specifically for Apigee and does not apply to Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eUsers can choose to configure their new Apigee instance for either external or internal access to API proxies.\u003c/p\u003e\n"],["\u003cp\u003eSelecting "Enable internet access" allows external requests to the API proxy and is the recommended approach by Apigee, which deploys a "Hello World" proxy for this method.\u003c/p\u003e\n"],["\u003cp\u003eChoosing "No internet access" restricts access to internal requests only, requiring a VM inside the network to interact with the API proxy.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring external access in the Cloud console involves selecting options for domain type, which can either be an automatically generated domain or a customized domain with custom subnetwork and SSL certificates.\u003c/p\u003e\n"]]],[],null,["# Step 4: Customize access routing\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nWhat you're doing in this step\n------------------------------\n\nIn this step, you can choose to expose your new Apigee instance to external requests or keep\nit private (and only allow requests from within the firewall).\n| **Tip:** There are fewer steps required to deploy and test a proxy if you choose **external**. If you are following these steps for testing purposes, choose that path.\n\nHow you access the API proxy depends on whether you allow external\nrequests or restrict access to internal requests only.\n\nEach of these approaches is presented on a tab in the instructions below.\n\nPerform the step\n----------------\n\n1. Select **External Access** or **Internal Access**: \n\n### External Access\n\nThis section describes how to configure routing from the Cloud Console when you want to allow\n*external* access to your API proxy.\n\n#### Permissions required for this task\n\nYou can give the Apigee provisioner a predefined role that includes the permissions needed to complete this task,\nor give more fine-grained permissions to provide the least privilege necessary. See\n[Predefined roles](/apigee/docs/api-platform/get-started/permissions#predefined-roles)\nand [Access routing permissions](/apigee/docs/api-platform/get-started/permissions#access-routing-permissions).\n\n**To configure routing for external access in the Cloud console**:\n\n1. Click create**Edit** to open the **Configure access** panel.\n2. Select **Enable internet access** .\n\n Choose one of the following options in the **Domain Type** section:\n - **Automatically generated domain, subnetwork and SSL certificates**: Choose this option to use the nip.io wildcard DNS service, and a Google managed certificate to secure your domain. Apigee automatically creates an L7 global external load balancer to forward traffic to your runtime.\n - **Customize** : Choose this option if you want to customize your domain name, SSL certificate, or subnetwork. Apigee automatically creates an L7 global external load balancer to forward traffic to your runtime. You can select or deselect any of the following options to enter custom details:\n - **Domain**: Optional. Enter the custom domain name.\n - **Network**: Optional. Select an available network name from the dropdown menu.\n - **Subnetwork**: Optional. Select an available subnetwork name from the dropdown menu. The subnetwork selected should be in the same region as the runtime instance.\n - **SSL Certificate** : Optional. Select an existing self-managed certificate or provide a new self-managed certificate.\n\n To select an existing certificate:\n 1. Browse the file system and select the certificate you wish to use.\n 2. Click **Save SSL**.\n\n To provide a new certificate:\n 1. Click **Add new**.\n 2. In the respective fields, browse your file system and attach the files containing the certificate and private key. Both should be PEM-formatted.\n 3. Click **Save SSL**.\n3. Click **Set access** .\n\n Apigee prepares your instance for external access. This includes creating firewall\n rules, uploading certificates, and creating a load balancer.\n\n This process can take several minutes.\n\n### Internal Access\n\nThis section describes how to configure routing when you're using the\nCloud Console and you *do not* want to allow external access to your API proxy.\nInstead, you want to limit access to *internal* requests only that originate from\nwithin the VPC.\n\n**To configure routing for internal access in the Cloud Console:**\n\n1. Click create**Edit** to open the **Configure access** panel.\n2. Select **No internet access**.\n\n3. Click **Set access**.\n2. Click **Next**.\n3. Click **Submit** to begin the provisioning process.\n\n The provisioning process may take up to 40 minutes to complete. If you\n want to leave the page while provisioning is in progress, a notification\n will appear in notifications\n **Notifications** in the Cloud console when the operation completes.\n\n Once provisioning is complete, the **Apigee Overview** page will\n appear and you can begin exploring Apigee!"]]
