Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza
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 usata è:
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 tuo dominio personalizzato. Ti servirà il certificato quando crei il bilanciatore del carico.
- Determina il nome host predefinito per il tuo portale.
- Crea un gruppo di endpoint di rete (NEG) internet per definire l'endpoint di backend del tuo portale integrato per il bilanciatore del carico.
- Crea un bilanciatore del carico che punti al NEG di internet e che riservi l'IP per le richieste in entrata dei client.
- 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 devi registrare un nuovo dominio, sono disponibili molti siti di registrazione di domini popolari, 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:
- Nell'interfaccia utente di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale. Viene visualizzato l'elenco dei portali.
Copia i contenuti nel campo Posizione per il portale per cui vuoi creare un dominio personalizzato.
Ti servirà questo valore nel passaggio successivo.
Passaggio 4: crea un NEG per 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 dei 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 riquadro di navigazione.
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 invariati i valori predefiniti dei restanti 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 di internet e riserva l'IP per le richieste in entrata dei client.
Avvia la configurazione
Nella console Google Cloud, vai alla pagina Bilanciamento del carico.
- Fai clic su Crea bilanciatore del carico.
- In Tipo di bilanciatore del carico, seleziona Bilanciatore del carico delle applicazioni (HTTP/HTTPS) e fai clic su Avanti.
- Per Pubblico o interno, seleziona Rivolto al pubblico (esterno) e fai clic su Avanti.
- In 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 Esterno globale Bilanciatore del carico delle applicazioni e fai clic su Avanti.
- Fai clic su Configura.
Configura il bilanciatore del carico
Fai clic su ogni categoria e configura il bilanciatore del carico come descritto nella tabella seguente.
Categoria Passaggi Configurazione frontend Riserva l'indirizzo IP per le richieste client in arrivo 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.
- Se vuoi, 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.
La finestra Crea un nuovo certificato si apre. - 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 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.
La finestra Crea servizio di backend si apre. - 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 invariati 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 bilanciatore del carico delle applicazioni esterno globale, posiziona il cursore sopra 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 nel menu 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 tuo portale nel campo Riscrivi host.
- Seleziona il servizio di backend che hai configurato nel menu 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 nel tuo portale:
- Nell'interfaccia utente di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale.
Viene visualizzato l'elenco dei portali. - Seleziona il tuo portale nell'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 nome di dominio personalizzato nel campo Dominio.
- Fai clic su Attiva.
Verifica che quando accedi al dominio personalizzato in un browser venga visualizzato il tuo 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 Gestire le 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 per il nome DNS. Viene visualizzato anche il suffisso che hai definito per la zona Cloud DNS, ma non è modificabile. Ad esempio: developers.mycompany.com
|
| Tipo di record risorsa | Seleziona A (l'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 nel tuo portale:
- Nell'interfaccia utente di Apigee, seleziona Pubblica > Portali nella barra di navigazione laterale.
Viene visualizzato l'elenco dei portali. - Seleziona il tuo portale nell'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.
Disattivare un dominio personalizzato nel tuo 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.
- Fai clic su Disattiva quando richiesto per confermare l'operazione.
Il dominio personalizzato è disabilitato e i campi sono stati cancellati.