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 pelo 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 inclua as permissões necessárias para realizar essa tarefa
ou conceder permissões mais refinadas a fim de 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 Google 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
gerenciados 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:
Selecione um certificado na lista suspensa.
lista. Se não houver nenhum certificado na lista, clique em
Adicionar novo.
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 na lista suspensa Selecionar certificado.
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 a criação de um balanceador de carga.
Esse processo pode levar vários minutos.
Acesso interno
Nesta seção, descrevemos como configurar o roteamento quando você estiver usando
o console do Google Cloud e não quiser permitir acesso
externo ao proxy de API.
Em vez disso, você quer limitar o acesso apenas a solicitações internas
originadas na VPC.
Para configurar o roteamento para acesso interno no console do Google 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çõesnotificações no console do Google 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-08-07 UTC."],[[["\u003cp\u003eThis content pertains to Apigee, excluding Apigee hybrid, and provides guidance on configuring API proxy access.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose to allow external access to your Apigee instance, which simplifies the process of deploying and testing an API proxy, or restrict access to internal requests only.\u003c/p\u003e\n"],["\u003cp\u003eEnabling internet access for your API proxy involves configuring routing in the Google Cloud console, and you can use an automatically managed domain or customize the domain, network, and SSL certificate.\u003c/p\u003e\n"],["\u003cp\u003eRestricting access to internal requests only also requires configuration through the Google Cloud console, where you select the "No internet access" option, and this setup limits the API proxy to requests originating from within the VPC.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring your instance for external access involves tasks such as creating firewall rules, uploading certificates, and setting up a load balancer, which may take several minutes to complete.\u003c/p\u003e\n"]]],[],null,["*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\nIn this step, you can choose to expose your new Apigee instance to\nexternal requests or keep it private (and only allow requests from within the\nfirewall).\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\n| Access Type | Description of the configuration and deployment process |\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| No internet access | Allow only internal access to your API proxy. You can download the `Hello World` proxy from GitHub and then deploy it to your Apigee instance. You must then create a new VM inside the network and connect to it. From the new VM, you can send a request to the API proxy. |\n| Enable internet access | Allow external access to your API proxy. | **Note:** Apigee recommends using this approach. Apigee deploys a `Hello World` proxy to your Apigee instance. You can then send a request to the API proxy from your administration machine or any network-enabled machine, whether it is within or outside the firewall. |\n\nEach of these approaches is presented on a tab in the instructions below.\n\nPerform the step\n\n1. Select **External Access** or **Internal Access**: \n\nExternal Access\n\nThis section describes how to configure routing from the\nGoogle Cloud console when you want to allow\n*external* access to your API proxy.\n\nPermissions required for this task\n\nYou can give the Apigee provisioner a predefined role\nthat includes the permissions needed to complete this task,\nor give more fine-grained permissions to provide the least\nprivilege 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 Google 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**\n section:\n - **Automatically managed domain, subnetwork and SSL\n 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 clear 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. Select an existing certificate from the drop-down list. If there is no certificate in the list, click **Add new**.\n 2. Browse the file system and select the certificate you wish to use.\n 3. Click **Save SSL**.\n\n To provide a new certificate:\n 1. Click in the **Select certificate** drop-down list.\n 2. Click **Add new**.\n 3. In the respective fields, browse your file system and attach the files containing the certificate and private key. Both should be PEM-formatted.\n 4. Click **Save SSL**.\n3. Click **Set access** .\n\n Apigee prepares your instance for external access.\n This includes creating firewall\n rules, uploading certificates, and creating a load balancer.\n\n This process can take several minutes.\n\nInternal Access\n\nThis section describes how to configure routing when you're using\nthe Google Cloud console and you *do not* want to allow external\naccess to your API proxy.\nInstead, you want to limit access to *internal* requests only\nthat originate from within the VPC.\n\n**To configure routing for internal access in the Google 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 Google 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!"]]
