Questa pagina si applica a Apigee e Apigee ibrido.
Visualizza la documentazione di
Apigee Edge.
Quando crei un portale per sviluppatori, per impostazione predefinita ti viene fornito un nome di dominio di esempio Apigee per accedere al tuo portale online nel seguente formato:
https://orgname-portalname.apigee.io
Dove orgname è il nome dell'organizzazione e portalname viene definito utilizzando il nome del portale convertito in minuscolo e con spazi e trattini rimossi.
Prima di lanciare un portale per gli sviluppatori, ti consigliamo di fornire un nome di dominio personalizzato. Ad esempio, un'alternativa molto diffusa è:
https://developers.example.com
Per considerazioni sull'utilizzo di un dominio personalizzato con un provider di identità SAML, vedi Utilizzo di un dominio personalizzato con il provider di identità SAML.
Passaggi per personalizzare il dominio
Per personalizzare il tuo nome di dominio:
- Registra il tuo nome di dominio.
- Crea un certificato TLS per il dominio personalizzato. Avrai bisogno del certificato durante la creazione del bilanciatore del carico.
- Determina il nome host predefinito per il portale.
- Crea un gruppo di endpoint di rete internet (NEG) per definire l'endpoint di backend del portale integrato per il bilanciatore del carico.
- Crea un bilanciatore del carico che punti al NEG internet e prenoti l'IP per le richieste client in entrata.
- Configura il dominio personalizzato sul tuo portale.
- Aggiorna il DNS per creare un nuovo record per l'host del dominio personalizzato.
Passaggio 1: registra il tuo nome di dominio
Se hai bisogno di registrare un nuovo dominio, puoi ricorrere a molti siti di registrazione del dominio molto diffusi, come Google Domains. La scelta del sito di registrazione del dominio spetta a te.
Quando decidi il tuo nome di dominio, tieni presente che gli URL facili da usare e leggibili da una persona sono un componente fondamentale per migliorare l'ottimizzazione per i motori di ricerca, come descritto in Implementare l'ottimizzazione per i motori di ricerca (SEO).
Passaggio 2: crea un certificato TLS per il dominio personalizzato
Crea un certificato TLS per il tuo dominio personalizzato utilizzando lo strumento che preferisci, ad esempio Let's Encrypt. Per ulteriori informazioni, vedi:
Passaggio 3: determina il nome host predefinito per il portale
Per determinare il nome host predefinito per il tuo portale:
- Nella UI di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale. Viene visualizzato l'elenco di portali.
Copia il contenuto del campo Posizione relativo al portale per il quale vuoi creare un dominio personalizzato.
Questo valore ti servirà nel passaggio successivo.
Passaggio 4: crea un NEG internet
In questo passaggio creerai un gruppo di endpoint di rete internet (NEG) per definire l'endpoint di backend del portale integrato per il bilanciatore del carico. Per ulteriori informazioni, consulta la panoramica sui gruppi di endpoint di rete internet.
Nella console Google Cloud, vai alla pagina Dashboard e seleziona o crea un progetto Google Cloud.
Seleziona Compute Engine > Gruppi di endpoint di rete nel navigatore.
Fai clic su Crea gruppo di endpoint di rete.
Configura i seguenti campi:
Campo Valore Nome Inserisci un nome per il NEG internet. Tipo di gruppo di endpoint di rete Seleziona Gruppo di endpoint di rete (Internet). Nuovo endpoint di rete - Aggiungi tramite: seleziona Nome di dominio e porta completi.
- Nome di dominio completo: inserisci il nome di dominio predefinito che hai copiato nel Passaggio 3: determina il nome host predefinito per il portale.
Puoi lasciare i valori predefiniti per gli altri campi.
Fai clic su Crea.
Il NEG internet viene creato.
Passaggio 5: crea un bilanciatore del carico
Crea un bilanciatore del carico che punti al NEG internet e prenoti l'IP per le richieste client in entrata.
Avvia la configurazione
Nella console Google Cloud, vai alla pagina Bilanciamento del carico.
- Fai clic su Crea bilanciatore del carico.
- Per Tipo di bilanciatore del carico, seleziona Bilanciatore del carico delle applicazioni (HTTP/HTTPS) e fai clic su Avanti.
- Per Pubblico o interno, seleziona Pubblico (esterno) e fai clic su Avanti.
- Per Deployment globale o in una regione singola, seleziona Ideale per carichi di lavoro globali e fai clic su Avanti.
- Per Generazione del bilanciatore del carico, seleziona Bilanciatore del carico delle applicazioni esterno globale e fai clic su Avanti.
- Fai clic su Configura.
Configura il bilanciatore del carico
Fai clic su ciascuna categoria e configura il bilanciatore del carico come descritto nella tabella seguente.
Categoria Passaggi Configurazione frontend Prenota l'indirizzo IP per le richieste client in entrata e carica il certificato TLS creato nel Passaggio 2: crea un certificato TLS:
- Nella sezione Crea un bilanciatore del carico delle applicazioni esterno globale, posiziona il cursore su Configurazione frontend e fai clic sulla freccia.
- Inserisci un nome per il frontend nel campo Nome.
- Seleziona HTTPS dal menu a discesa Protocollo.
- Nel menu a discesa Indirizzo IP, seleziona Crea indirizzo IP.
Viene visualizzata la finestra di dialogo Prenota un nuovo indirizzo IP statico. - Inserisci un nome per l'indirizzo IP statico nel campo Nome.
- (Facoltativo) Inserisci una descrizione.
- Fai clic su Prenota.
- Archivia l'indirizzo IP riservato per l'utilizzo durante la configurazione del record DNS.
- Seleziona Crea un nuovo certificato nel menu a discesa Certificato.
Si apre la finestra Crea un nuovo certificato. - Inserisci un nome per il nuovo certificato nel campo Nome.
- Seleziona Carica il mio certificato in Modalità creazione.
- Carica i dettagli del certificato TLS, incluse la chiave pubblica, la catena di certificati e la chiave privata.
- Fai clic su Crea.
- Fai clic su Fine per creare il nuovo IP e la nuova porta del frontend.
Configurazione backend Configura la configurazione del backend in modo da indirizzare il traffico in entrata al NEG internet creato nel Passaggio 4: crea un gruppo di endpoint di rete (NEG) internet:
- Nella sezione Crea un bilanciatore del carico delle applicazioni esterno globale, posiziona il cursore su Configurazione backend e fai clic sulla freccia.
- Nella sezione Servizi e bucket di backend, seleziona Servizi di backend > Crea un servizio di backend dal menu a discesa.
Si apre la finestra Crea servizio di backend. - Inserisci un nome nel campo Nome.
- Seleziona Gruppo di endpoint di rete internet nell'elenco a discesa Tipo di backend.
- Seleziona HTTPS come protocollo.
- Nella sezione Nuovo backend, seleziona il NEG internet creato nel Passaggio 4: crea un gruppo di endpoint di rete internet (NEG) nel menu a discesa Gruppo di endpoint di rete internet e fai clic su Fine.
- Deseleziona la casella di controllo Abilita Cloud CDN.
- Puoi lasciare le impostazioni predefinite per tutti gli altri valori.
- Fai clic su Crea.
Regole host e percorso Configura le regole relative a host e percorso per determinare come sarà indirizzato il traffico:
- Nella sezione Crea un bilanciatore del carico delle applicazioni esterno globale, posiziona il cursore su Regole host e percorso e fai clic sulla freccia.
- Fai clic su Regola host e percorso avanzata (reindirizzamento URL, riscrittura URL) in Modalità.
- Nella sezione Nuova regola host e percorso:
- Seleziona Instrada il traffico a un singolo backend nell'elenco a discesa Azione.
- Espandi Azione aggiuntiva (riscrittura URL).
- Inserisci il nome di dominio predefinito che hai copiato nel Passaggio 3: determina il nome host predefinito per il portale nel campo Riscrittura host.
- Seleziona il servizio di backend che hai configurato nell'elenco a discesa Backend.
- Fai clic su Fine.
Fai clic su Crea nella pagina Crea un bilanciatore del carico delle applicazioni esterno globale.
Passaggio 6: configura il dominio personalizzato sul portale
Per configurare il dominio personalizzato sul tuo portale:
- Nella UI di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale.
Viene visualizzato l'elenco di portali. - Seleziona il tuo portale dall'elenco.
- Seleziona Impostazioni nella pagina di destinazione o nel menu a discesa nella barra di navigazione in alto.
- Fai clic sulla scheda Domains (Domini).
- Inserisci il tuo nome di dominio personalizzato nel campo Dominio.
- Fai clic su Abilita.
Verifica che quando accedi al dominio personalizzato in un browser, vieni indirizzato al portale integrato.
Vedi anche Modifica di un dominio personalizzato e Disattivazione di un dominio personalizzato.
Passaggio 7: aggiorna il DNS
Nel tuo sistema DNS, crea un nuovo record per l'host del dominio personalizzato.
Per creare una zona Cloud DNS, segui i passaggi descritti in Gestione delle zone. Assicurati di configurare i seguenti campi come descritto di seguito:
| Campo | Descrizione |
|---|---|
| Tipo di zona | Seleziona Public (Pubbliche). |
| Nome zona | Inserisci un nome significativo per la zona. Ad esempio: mycompany-zone
|
| Nome DNS | Inserisci il suffisso per la zona utilizzando un nome di dominio di tua proprietà. Ad esempio: mycompany.com
|
Dopo aver creato una zona, nella pagina Dettagli zona, fai clic su Aggiungi set di record e segui i passaggi descritti in Gestione dei record. Assicurati di configurare i seguenti campi come descritto di seguito:
| Campo | Descrizione |
|---|---|
| Nome DNS | Specifica il prefisso del tuo nome DNS. Viene visualizzato anche il suffisso definito per la zona Cloud DNS, ma non è modificabile. Ad esempio: developers.mycompany.com
|
| Tipo di record risorsa | Seleziona A (impostazione predefinita). |
| TTL | Imposta il valore desiderato o lascia impostato su 5 (impostazione predefinita). |
| Unità TTL | Imposta il valore desiderato o lascia impostato su minuti (impostazione predefinita). |
| Indirizzo IPv4 | Inserisci l'indirizzo IP esterno che hai prenotato durante la creazione del bilanciatore del carico. |
Modificare un dominio personalizzato sul portale
Per modificare un dominio personalizzato sul portale:
- Nella UI di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale.
Viene visualizzato l'elenco di portali. - Seleziona il tuo portale dall'elenco.
- Seleziona Impostazioni nel menu a discesa della barra di navigazione in alto o nella pagina di destinazione.
- Fai clic sulla scheda Domains (Domini).
- Modifica le informazioni del dominio personalizzato.
- Fai clic su Salva.
Disattivazione di un dominio personalizzato sul portale
Per disattivare un nome di dominio personalizzato sul tuo portale:
- Nella UI di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale. Viene visualizzato l'elenco di portali.
- Seleziona il tuo portale dall'elenco.
- Seleziona Impostazioni nel menu a discesa della barra di navigazione in alto o nella pagina di destinazione.
- Fai clic sulla scheda Domains (Domini).
- Fai clic su Disattiva.
- Quando richiesto, fai clic su Disabilita per confermare l'operazione.
Il dominio personalizzato è disabilitato e i campi sono stati cancellati.