Creazione e configurazione di un endpoint personalizzato

È possibile mappare un endpoint personalizzato a un'istanza di Visual Builder e utilizzarlo per accedere all'istanza anziché all'URL originale generato nella console OCI.

Si supponga di voler aprire l'istanza di Visual Builder da un URL personalizzato come https://my-custom-endpoint.example.com/ic/builder anziché l'URL originale generato da Oracle (che può avere un aspetto simile a https://<instance-display-name>-<tenancy-name>-<region-code>...oraclecloud.com). A tale scopo, creare un nome host per il dominio personalizzato scelto (ad esempio, my-custom-endpoint.example.org), quindi un endpoint personalizzato nell'istanza di Visual Builder associato al nome host. La creazione di un endpoint personalizzato non influisce sull'URL dell'istanza originale dell'istanza di Visual Builder. Potrai accedere all'istanza utilizzando l'URL dell'endpoint personalizzato e l'URL dell'istanza originale.

Nota

Se si sta creando un endpoint personalizzato per un'istanza VB abilitata per l'endpoint privato e si desidera rendere pubblico l'endpoint personalizzato, sarà necessario utilizzare un load balancer pubblico nella tenancy e creare un nome host, un listener e un backend che punti all'indirizzo IP dell'endpoint privato. Questo non è necessario se non si intende rendere pubblico l'endpoint.

Dopo aver configurato un endpoint personalizzato, è possibile mappare un'applicazione nell'istanza all'endpoint selezionando l'endpoint come URL univoco nelle impostazioni dell'applicazione visiva contenente l'applicazione. Dopo aver impostato l'URL univoco dell'applicazione, gli utenti possono e devono aprire l'applicazione direttamente inserendo la radice URL univoco (https://my-custom-endpoint.example.com) nel proprio browser. Per ulteriori informazioni sull'uso di un URL univoco per un'applicazione, vedere Configura supporto per un dominio personalizzato.

Queste istruzioni presuppongono l'accesso diretto a un'istanza di Visual Builder e a OCI Console.

Per creare e configurare un endpoint personalizzato per l'istanza di Visual Builder:

  1. Scegliere un nome host personalizzato per l'istanza e registrarlo presso un provider DNS.
  2. Ottenere un certificato SSL da un'autorità di certificazione (CA) per il proprio nome host.
  3. Configurare il nome host per l'endpoint personalizzato.

    Per creare e configurare un nome host, effettuare una delle operazioni riportate di seguito.

    Oracle consiglia di utilizzare il servizio Oracle Web Application Firewall, in quanto ciò consente di mappare il nome DNS e caricare il certificato e la chiave privata associati personalmente e non è necessario aggiornare l'istanza di Visual Builder ogni volta che viene creata una nuova versione del segreto.

    Nota

    Le opzioni sopra riportate per la creazione e la configurazione di un nome host sono applicabili solo per il primo endpoint personalizzato (primario). Se l'istanza ha già un endpoint personalizzato e si desidera aggiungerne un altro, è necessario utilizzare la riga di comando. Analogamente, se l'istanza dispone già di più endpoint personalizzati e si desidera modificarne uno qualsiasi, è necessario eseguire questa operazione utilizzando la riga di comando. Per informazioni dettagliate su come eseguire questa operazione, vedere Crea e aggiorna endpoint alternativi.
  4. Nella pagina Istanze di Visual Builder, individuare l'istanza da utilizzare e aprirne la pagina dei dettagli. Se è necessaria assistenza per trovare la pagina Istanze o l'istanza, vedere Visualizza e gestisci l'istanza di Visual Builder.
  5. Selezionare Modifica per aprire il pannello Modifica istanza di Visual Builder.

    Se non si dispone di un'istanza, vedere Crea l'istanza di Visual Builder.

  6. Fornire i dettagli dell'endpoint personalizzato nel riquadro Endpoint personalizzato.


    Nota

    Se è stato configurato il nome host per l'endpoint personalizzato utilizzando WAF, è necessario fornire solo il nome host. Non è necessario fornire il compartimento, il vault o il segreto.

    Campo Descrizione
    Nome host Obbligatorio.

    Immettere il nome host personalizzato scelto per l'istanza.

    Il nome host personalizzato che si desidera mappare all'istanza deve essere già registrato in un provider DNS,

    Se il nome host viene configurato utilizzando un vault OCI, il relativo certificato SSL deve essere memorizzato come segreto nel vault.

    Certificato Obbligatorio quando il nome host viene configurato utilizzando un vault OCI.

    Fornire la posizione del certificato del nome host nella tenancy OCI.

    • Compartimento: selezionare il compartimento OCI che contiene il vault dei certificati.
    • Vault: selezionare il vault contenente il certificato del nome host.
    • Segreto: selezionare il segreto corrispondente al certificato del nome host.
    Nota

    È inoltre possibile aggiornare o sostituire un endpoint personalizzato precedentemente associato all'istanza. È possibile modificare il nome host e i dettagli del certificato. Tuttavia, per aggiornare i dettagli del certificato, è necessario disporre delle autorizzazioni di accesso al vault contenente il certificato richiesto. Per informazioni dettagliate, vedere Aggiornare un segreto in un vault.
  7. Infine, aggiornare il record DNS dell'endpoint personalizzato al nome host dell'istanza originale.

    Come procedura ottimale, aggiornare CNAME con il nome host o aggiornare il record A utilizzando l'indirizzo IP pubblico se si desidera che l'endpoint sia pubblico. È possibile ottenere l'indirizzo IP aprendo un terminale e utilizzando il comando dig nel nome host VB, ad esempio:

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