Configurazione di un dominio personalizzato

Quando crei un portale per l'API Cloud Endpoints, per impostazione predefinita il portale è ospitato nel cloud.googdominio di proprietà e gestito da Google. L'URL predefinito per il portale è nel seguente formato in cui YOUR_PROJECT_ID è il progetto Google Cloud in cui hai eseguito il deployment della configurazione degli endpoint:

https://endpointsportal.YOUR_PROJECT_ID.cloud.goog
Questo è l'URL predefinito anche se hai specificato un dominio personalizzato (ad esempio example.com o my-api.example.com) nel campo host del documento OpenAPI.

Se vuoi che gli utenti della tua API accedano al tuo portale utilizzando un dominio personalizzato, devi configurare il portale Cloud Endpoints e le impostazioni DNS nel registrar del nome di dominio. Quando aggiungi un dominio personalizzato al tuo portale, nel portale degli endpoint vengono visualizzati il tipo di record DNS e altre informazioni che devi configurare nel registrar del nome di dominio.

In questa pagina viene descritto come configurare il portale Endpoints per utilizzare un dominio personalizzato. Per ogni attività viene fornito il ruolo o i ruoli minimi richiesti per completare l'attività. Per ulteriori informazioni sulle autorizzazioni IAM, consulta quanto segue:

Prerequisiti

Questa guida presuppone che:

Aggiungere un dominio personalizzato

  1. Nella console Google Cloud, vai alla pagina Endpoint > Portale sviluppatori per il tuo progetto.

    Vai al portale Cloud Endpoints

  2. Fai clic su Aggiungi un dominio personalizzato.
  3. Inserisci il nome di un dominio principale o di un sottodominio.
  4. Per aggiungere il dominio, fai clic su Continua.

  5. Nel portale degli endpoint viene visualizzato Update your DNS records (Aggiorna i tuoi record DNS). Aggiungi i record DNS utilizzando il tuo registrar del nome di dominio per tutti i record elencati nella sezione Aggiorna i tuoi record DNS.

    • Se hai inserito un dominio principale come example.com, la sezione Aggiorna i record DNS mostra un elenco di record A e record AAAA con indirizzi IP. Ad esempio:

      Tipo Dati Alias
      A 198.51.100.0 -
      A 198.51.100.2 -
      A 198.51.100.4 -
      A 198.51.100.6 -
      AAAA 2001:db8:ffff:32::15 -
      AAAA 2001:db8:ffff:34::15 -
      AAAA 2001:db8:ffff:36::15 -
      AAAA 2001:db8:ffff:38::15 -

      I passaggi di configurazione e la terminologia per l'aggiunta di più record A e AAAA per un nome di dominio variano a seconda del registrar del nome di dominio. Se hai dubbi, cerca nella documentazione del registrar del nome di dominio termini come set di record o più risposte.

    • Se hai inserito un sottodominio, ad esempio apidocs.example.com, nella sezione Aggiorna i record DNS viene visualizzato un CNAME. Ad esempio:

      Tipo Dati Alias
      CNAME ghs.googlehosted.com apidocs

  6. Fai clic su Fine.

  7. Per visitare il tuo portale, fai clic sul link del dominio personalizzato. A seconda della distribuzione del record DNS, potrebbero essere necessarie fino a 24 ore per un link di dominio personalizzato funzionante.

Google esegue il provisioning di un certificato SSL solo dopo aver aggiunto i record DNS utilizzando il tuo registrar di domini. Fino a quel momento, il dominio personalizzato non funziona con il tuo portale, nemmeno utilizzando http://. Tuttavia, puoi continuare a utilizzare l'URL predefinito visualizzato nella pagina Endpoint &gt Portale sviluppatori.

Visualizzazione delle informazioni da aggiungere al DNS

Per visualizzare le informazioni che devi aggiungere (o che sono già aggiunte) al tuo registrar del nome di dominio:

  1. Nella console Google Cloud, vai alla pagina Endpoint > Portale sviluppatori.

    Vai al portale Cloud Endpoints

  2. Seleziona il progetto Google Cloud proprietario dell'API.
  3. Accanto al dominio personalizzato, fai clic su DNS details (Dettagli DNS).

Eliminare un dominio personalizzato

  1. Nella console Google Cloud, vai alla pagina Endpoint > Portale sviluppatori per il tuo progetto.

    Vai al portale Cloud Endpoints

  2. Accanto a Dettagli DNS per il dominio personalizzato, fai clic su Elimina .
  3. Nella finestra di dialogo di conferma, fai clic su Elimina.

Risolvere i problemi

L'aggiunta di un dominio personalizzato non riesce a causa di un errore generico. I motivi potrebbero essere diversi. Assicurati che l'URL predefinito al tuo portale, endpointsportal.YOUR_PROJECT_ID.cloud.goog, sia funzionale. Se l'URL predefinito non funziona, elimina il portale e segui i passaggi descritti in Creazione di un portale per l'API Endpoints per ricrearlo.

L'aggiunta di un dominio personalizzato non è riuscita, ma viene ancora visualizzata nella tabella principale della pagina principale. Questo è un problema noto. Per risolvere il problema, elimina il dominio personalizzato, quindi aggiungilo di nuovo.

Fai clic su "Dettagli DNS" per visualizzare una tabella vuota senza record da aggiungere. Ciò può accadere se l'aggiunta del dominio personalizzato non è riuscita, ma viene ancora visualizzata nella tabella. Per risolvere il problema, elimina il dominio personalizzato, quindi aggiungilo di nuovo.

Il link del dominio personalizzato non funziona. Devi assicurarti di avere aggiunto correttamente i record DNS al tuo registrar di dominio. Possono trascorrere fino a 24 ore prima che il dominio personalizzato funzioni.

Non dispongo dell'autorizzazione per aggiungere un dominio personalizzato. Devi ridurre al minimo il ruolo di Visualizzatore progetto e l'Amministratore portale endpoint del progetto. Il ruolo Editor di progetto al progetto ha anche le autorizzazioni richieste. Per saperne di più, consulta Creazione e gestione dei ruoli personalizzati.

Vorrei riutilizzare lo stesso nome di dominio che ho utilizzato per la mia applicazione App Engine. Un nome di dominio specifico può pubblicare una sola applicazione web. Non puoi utilizzare lo stesso nome di dominio per l'applicazione web di App Engine e per il portale. Utilizza un nome di dominio univoco.

Passaggi successivi

Scopri di più su: