Condividi tramite

Aggiungere un dominio personalizzato

  • Articolo

Oltre al dominio predefinito incluso in un'istanza di PubSub Web di Azure, è possibile aggiungere un dominio personalizzato. Un dominio personalizzato è un nome di dominio di cui si è proprietari e gestiti. È possibile usare un dominio personalizzato per accedere alle risorse Web PubSub. Ad esempio, è possibile usare contoso.example.com invece di contoso.webpubsub.azure.com per accedere alle risorse.

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Se non si ha un account Azure, è possibile creare un account gratuitamente.
  • Una risorsa PubSub di Azure con un livello Premium minimo.
  • Una risorsa di Azure Key Vault.
  • Un certificato personalizzato che corrisponde a un dominio personalizzato archiviato in Azure Key Vault.

Aggiungere un certificato personalizzato

Prima di poter aggiungere un dominio personalizzato, aggiungere un certificato personalizzato corrispondente. Un certificato personalizzato è una risorsa dell'istanza di Web PubSub. Fa riferimento a un certificato nell'insieme di credenziali delle chiavi. Per motivi di sicurezza e conformità, Web PubSub non archivia definitivamente il certificato. Recupera invece il certificato dall'insieme di credenziali delle chiavi e lo mantiene in memoria.

Accedere all'insieme di credenziali delle chiavi usando un'identità gestita

Web PubSub di Azure usa un'identità gestita per accedere all'insieme di credenziali delle chiavi. Per autorizzare l'accesso, è necessario concedere le autorizzazioni.

Creare un'identità gestita

  1. Nel portale di Azure passare alla risorsa Web PubSub.

  2. Nel menu a sinistra selezionare Identità.

  3. Selezionare il tipo di identità da usare: Assegnato dal sistema o Assegnato dall'utente. Per usare un'identità assegnata dall'utente, crearne prima una.

    Per usare un'identità assegnata dal sistema:

    1. Selezionare Attivato.

    2. Seleziona Sì per confermare.

    3. Seleziona Salva.

    Screenshot che mostra l'aggiunta di un'identità gestita assegnata dal sistema.

    Per aggiungere un'identità assegnata dall'utente:

    1. Selezionare Aggiungi identità gestita assegnata dall'utente.

    2. Selezionare un'identità esistente.

    3. Selezionare Aggiungi.

    Screenshot che mostra l'aggiunta di un'identità gestita assegnata dall'utente.

  4. Seleziona Salva.

Concedere all'insieme di credenziali delle chiavi l'accesso all'identità gestita

A seconda della configurazione del modello di autorizzazioni di Azure Key Vault, potrebbe essere necessario concedere le autorizzazioni in posizioni diverse nel portale di Azure.

Se si usa un criterio di accesso predefinito dell'insieme di credenziali delle chiavi come modello di autorizzazioni dell'insieme di credenziali delle chiavi:

Screenshot di un criterio di accesso predefinito selezionato come modello di autorizzazioni dell'insieme di credenziali delle chiavi.

  1. Nel portale di Azure andare all'insieme di credenziali delle chiavi.

  2. Nel menu a sinistra selezionare Configurazione di accesso.

  3. Selezionare Criteri di accesso all'insieme di credenziali.

  4. Selezionare Vai ai criteri di accesso.

  5. Seleziona Crea.

  6. Nel riquadro Crea criteri di accesso selezionare la scheda Autorizzazioni.

  7. Per Autorizzazioni segrete, selezionare Ottieni.

  8. Per Autorizzazioni certificato, selezionare Ottieni.

  9. Selezionare Avanti.

    Screenshot della selezione delle autorizzazioni in un insieme di credenziali delle chiavi.

  10. Cercare il nome della risorsa Web PubSub.

  11. Selezionare Avanti.

    Screenshot della selezione dell'entità in un insieme di credenziali delle chiavi.

  12. Selezionare la scheda Applicazione e quindi selezionare Avanti.

  13. Seleziona Crea.

Creare un certificato personalizzato

  1. Nel portale di Azure passare alla risorsa Web PubSub.

  2. Nel menu a sinistra selezionare Dominio personalizzato.

  3. Nel riquadro Certificato personalizzato selezionare Aggiungi.

    Screenshot che mostra la gestione di un certificato personalizzato.

  4. Immettere un nome per il certificato personalizzato.

  5. Scegliere Seleziona dall'insieme di credenziali delle chiavi per scegliere un certificato dell'insieme di credenziali delle chiavi. Dopo aver selezionato un insieme di credenziali delle chiavi, i valori per l'URI di base dell'insieme di credenziali delle chiavi e il nome del segreto dell'insieme di credenziali delle chiavi vengono aggiunti automaticamente. È anche necessario scegliere di modificare questi campi manualmente.

  6. (Facoltativo) Per aggiungere il certificato a una versione specifica, immettere un valore per Versione segreta dell'insieme di credenziali delle chiavi.

  7. Selezionare Aggiungi.

    Screenshot che mostra l'aggiunta di un certificato personalizzato.

Web PubSub recupera il certificato e ne convalida il contenuto. Quando la convalida del certificato ha esito positivo, lo stato del provisioning per il certificato è Completato.

Screenshot che mostra un certificato personalizzato aggiunto.

Creare un dominio personalizzato CNAME

Per convalidare la proprietà del dominio personalizzato, creare un record CNAME per il dominio personalizzato e puntare al dominio predefinito della risorsa Web PubSub.

Ad esempio, se il dominio predefinito è contoso.webpubsub.azure.com e il dominio personalizzato è contoso.example.com, creare un record CNAME in example.com come in questo esempio:

contoso.example.com. 0 IN CNAME contoso.webpubsub.azure.com

Se si usa la zona DNS di Azure, per informazioni su come aggiungere un record CNAME, vedere Gestire i record DNS.

Screenshot che mostra l'aggiunta di un record CNAME nella zona DNS di Azure.

Se si usano altri provider DNS, seguire le indicazioni nella documentazione del provider per creare un record CNAME.

Aggiungere un dominio personalizzato a Web PubSub

Un dominio personalizzato è un'altra risorsa secondaria dell'istanza di Web PubSub. Contiene tutte le configurazioni necessarie per un dominio personalizzato.

  1. Nel portale di Azure passare alla risorsa Web PubSub.

  2. Nel menu a sinistra selezionare Dominio personalizzato.

  3. Nel riquadro Dominio personalizzato selezionare Aggiungi.

    Screenshot che mostra la gestione del dominio personalizzata.

  4. Immettere un nome per il dominio personalizzato. Usare il nome della risorsa secondaria.

  5. Immettere il nome di dominio. Usare il nome di dominio completo del dominio personalizzato, ad esempio contoso.com.

  6. Selezionare un certificato personalizzato applicabile a questo dominio personalizzato.

  7. Selezionare Aggiungi.

    Screenshot che mostra l'aggiunta di un dominio personalizzato.

Verificare il dominio personalizzato

È ora possibile accedere all'endpoint Web PubSub usando il dominio personalizzato.

Per verificare il dominio, è possibile accedere all'API integrità. Negli esempi seguenti viene usato cURL.

PS C:\> curl.exe -v https://contoso.example.com/api/health
...
> GET /api/health HTTP/1.1
> Host: contoso.example.com

< HTTP/1.1 200 OK
...
PS C:\>

L'API Integrità deve restituire un codice di stato 200 senza errori del certificato.

Configurare un insieme di credenziali delle chiavi di rete privato

Se si configura un endpoint privato nell'insieme di credenziali delle chiavi, Web PubSub non può accedere all'insieme di credenziali delle chiavi usando una rete pubblica. È necessario configurare un endpoint privato condiviso per concedere a Web PubSub l'accesso all'insieme di credenziali delle chiavi tramite una rete privata.

Dopo aver creato un endpoint privato condiviso, è possibile creare un certificato personalizzato come di consueto. Non è necessario modificare il dominio nell'URI dell'insieme di credenziali delle chiavi. Ad esempio, se l'URI di base dell'insieme di credenziali delle chiavi è https://contoso.vault.azure.net, continuare a usare questo URI per configurare un certificato personalizzato.

Non è necessario consentire in modo esplicito gli indirizzi IP Web PubSub nelle impostazioni del firewall dell'insieme di credenziali delle chiavi. Per altre informazioni, vedere Diagnostica dei collegamenti privati dell'insieme di credenziali delle chiavi.

Ruotare il certificato

Se non si specifica una versione privata quando si crea un certificato personalizzato, Web PubSub controlla periodicamente la versione più recente nell'insieme di credenziali delle chiavi. Quando viene rilevata una nuova versione, viene applicata automaticamente. Il ritardo è in genere inferiore a un'ora.

In alternativa, è possibile aggiungere un certificato personalizzato a una versione privata specifica nell'insieme di credenziali delle chiavi. Quando è necessario applicare un nuovo certificato, è possibile modificare la versione del segreto e quindi aggiornare il certificato personalizzato in modo proattivo.

Contenuto correlato