Documentação do Oracle Cloud Infrastructure

Criar e Configurar um Ponto Final Personalizado

Você pode mapear um ponto final personalizado para uma instância do Visual Builder e usá-lo para acessar a instância em vez do URL original gerado na Console do OCI.

Digamos que você queira abrir sua instância do Visual Builder em um URL personalizado como https://my-custom-endpoint.example.com/ic/builder, em vez do URL original gerado pela Oracle (que pode ser parecido com https://<instance-display-name>-<tenancy-name>-<region-code>...oraclecloud.com). Para fazer isso, você cria um nome de host para o domínio personalizado escolhido (por exemplo, my-custom-endpoint.example.org) e, em seguida, cria um ponto final personalizado na sua instância do Visual Builder que está associada ao nome do host. A criação de um ponto final personalizado não afeta o URL da instância original da sua instância do Visual Builder. Você poderá acessar sua instância usando o URL do ponto final personalizado, bem como o URL da instância original.

Observação

Se você estiver criando um ponto final personalizado para uma instância do VB ativada por ponto final privado e quiser tornar o ponto final personalizado público, precisará usar um balanceador de carga público em sua tenancy e criar um nome de host, listener e um backend que aponte para o endereço IP do ponto final privado. Isso não será necessário se você não pretende tornar o ponto final público.

Depois de configurar um ponto final personalizado, você poderá mapear um aplicativo em sua instância para o ponto final selecionando-o como o URL personalizado nas definições do aplicativo visual que contém o aplicativo. Depois de definir o URL personalizado do aplicativo, os usuários podem e devem abrir o aplicativo diretamente digitando a raiz do URL personalizado (https://my-custom-endpoint.example.com) em seu navegador. Para obter mais informações sobre como usar um URL personalizado para um aplicativo, consulte Configurar Suporte para um Domínio Personalizado.

Essas instruções pressupõem que você tenha acesso direto a uma instância do Visual Builder e à Console do OCI.

Para criar e configurar um ponto final personalizado para sua instância do Visual Builder:

  1. Escolha um nome de host personalizado para sua instância e registre-o em um provedor de DNS.
  2. Obtenha um certificado SSL de uma autoridade de certificação (CA) para seu nome de host.
  3. Configure o nome do host para seu ponto final personalizado.

    Para criar e configurar um nome de host, execute um dos seguintes procedimentos:

    A Oracle recomenda que você use o serviço Oracle Web Application Firewall, pois isso permite mapear seu nome de DNS e fazer upload de seu certificado associado e da chave privada por conta própria, e você não precisa atualizar a instância do Visual Builder toda vez que uma nova versão do segredo for criada.

    Observação

    As opções acima para criar e configurar um nome de host só se aplicam ao seu primeiro ponto final personalizado (principal). Se sua instância já tiver um ponto final personalizado e você quiser adicionar outro, use a linha de comando. Da mesma forma, se sua instância já tiver vários pontos finais personalizados e você quiser editar qualquer um deles, precisará fazer isso usando a linha de comando. Para obter detalhes sobre como fazer isso, consulte Criar e Atualizar Pontos Finais Alternativos.
  4. Na página Instâncias do Visual Builder, localize a instância com a qual você deseja trabalhar e abra sua página de detalhes. Se precisar de ajuda para localizar a página Instâncias ou a instância, consulte Exibir e Gerenciar a Instância do Visual Builder.
  5. Selecione Editar para abrir o painel Editar instância do visual builder.

    Se você não tiver uma instância, consulte Criar a Instância do Visual Builder.

  6. Forneça os detalhes do ponto final personalizado no painel Ponto final Personalizado.

    Descrição da ilustração admin-instancedetails-edit.png a seguir
    Descrição da ilustração admin-instancedetails-edit.png

    Observação

    Se você tiver configurado o nome do host para o ponto final personalizado usando o WAF, só precisará fornecer o nome do host. Você não precisa fornecer o Compartimento, o Vault ou o Segredo.

    Campo Descrição
    Nome do host Obrigatório.

    Informe o nome de host personalizado escolhido para a instância.

    O nome de host personalizado que você deseja mapear para a instância já deve estar registrado em um provedor de DNS,

    Se o nome do host for configurado usando um vault do OCI, seu certificado SSL deverá ser armazenado como segredo no vault.
    Certificado Obrigatório quando o nome do host é configurado usando um vault do OCI.

    Forneça o local do certificado do nome do host na sua tenancy da OCI.

    • Compartimento: Selecione o compartimento do OCI que contém o vault do certificado.
    • Vault: Selecione o vault que contém o certificado do nome do host.
    • Segredo: Selecione o segredo correspondente ao certificado do nome do host.
    Observação

    Você também pode atualizar ou substituir um ponto final personalizado que foi associado anteriormente à instância. Você pode modificar o nome do host e os detalhes do certificado. No entanto, para atualizar os detalhes do certificado, você deve ter permissões de acesso ao vault que contém o certificado necessário. Para obter detalhes, consulte Atualizar um Segredo em um Vault.
  7. Por fim, atualize o registro de DNS do ponto final personalizado para o nome do host da instância original.

    Como prática recomendada, atualize o CNAME com o nome do host ou atualize o registro A usando o endereço IP público se quiser que o ponto final seja público. Você pode obter o endereço IP abrindo um terminal e usando o comando dig no nome de host do VB, por exemplo: 

    dig vb-myinst-vb-adkj3-px.builder.ocp.oraclecloud.com