AWS App Runner non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [AWS App Runner la modifica della disponibilità](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Gestione di nomi di dominio personalizzati per un servizio App Runner
Quando crei un AWS App Runner servizio, App Runner gli assegna un nome di dominio. Si tratta di un sottodominio del `awsapprunner.com` dominio di proprietà di App Runner. Puoi utilizzare il nome di dominio per accedere all'applicazione web in esecuzione nel tuo servizio.
**Nota**
Per aumentare la sicurezza delle tue applicazioni App Runner, il * dominio * \*.awsapprunner.com è registrato nella Public Suffix List (PSL). [https://publicsuffix.org/](https://publicsuffix.org/) Per una maggiore sicurezza, ti consigliamo di utilizzare i cookie con un `__Host-` prefisso se hai bisogno di impostare cookie sensibili nel nome di dominio predefinito per le tue applicazioni App Runner. Questa pratica ti aiuterà a difendere il tuo dominio dai tentativi CSRF (cross-site request forgery). Per ulteriori informazioni, consulta la [ Set-Cookie ](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) pagina del Mozilla Developer Network.
Se possiedi un nome di dominio, puoi associarlo al tuo servizio App Runner. Dopo che App Runner ha convalidato il tuo nuovo dominio, puoi utilizzare il tuo dominio per accedere alla tua applicazione oltre al dominio App Runner. Puoi associare fino a cinque domini personalizzati.
**Nota**
Puoi facoltativamente includere il `www` sottodominio del tuo dominio. Tuttavia, al momento questo è supportato solo dall'API. La console App Runner non supporta l'inclusione del `www` sottodominio del tuo dominio.
**Nota**
AWS App Runner non supporta l'utilizzo delle zone ospitate private di Route 53. Le zone ospitate private personalizzano la risoluzione dei nomi di dominio per il traffico Amazon VPC. Per ulteriori informazioni sulle zone ospitate private, consulta [ Lavorare con le zone ospitate private ](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-private.html) nella documentazione di Route 53.
## Associa (link) un dominio personalizzato al tuo servizio
Quando associ un dominio personalizzato al tuo servizio, devi aggiungere i record CNAME e i record di destinazione DNS al tuo server DNS. Le sezioni seguenti forniscono informazioni sui record CNAME e sui record di destinazione DNS e su come utilizzarli.
**Nota**
Se utilizzi Amazon Route 53 come provider DNS, App Runner configura automaticamente il tuo dominio personalizzato con la convalida del certificato e i record DNS richiesti da collegare all'applicazione web App Runner. Ciò accade quando utilizzi la console App Runner per collegare il tuo dominio personalizzato al tuo servizio. L'[Gestisci i domini personalizzati](#manage-custom-domains.manage)argomento che segue fornisce ulteriori informazioni.
### Registri CNAME
Quando associ un dominio personalizzato al tuo servizio, App Runner ti fornisce una serie di record di convalida del certificato per la convalida del certificato. È necessario aggiungere questi record di convalida del certificato al server DNS (Domain Name System). Aggiungi i record di convalida del certificato, forniti da App Runner, al tuo server DNS. In questo modo, App Runner può confermare che possiedi o controlli il dominio.
**Nota**
Per rinnovare automaticamente i certificati di dominio personalizzati, assicurati di non eliminare i record di convalida dei certificati dal tuo server DNS. Per informazioni su come risolvere i problemi relativi al rinnovo del certificato, consulta. [Rinnovo del certificato di dominio personalizzato](manage-custom-domain-troubleshoot.md#certificate-renewal.troubleshoot)
App Runner utilizza ACM per verificare il dominio. Se utilizzi i record CAA nei tuoi record DNS, assicurati che almeno un record CAA faccia riferimento. `amazon.com` Altrimenti, ACM non può verificare il dominio e creare correttamente il tuo dominio.
Se ricevi errori relativi al CAA, consulta i seguenti link per scoprire come risolverli:
+ [Problemi relativi all'autorizzazione dell'autorità di certificazione (CAA) ](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting-caa.html)
+ [Come posso risolvere gli errori CAA relativi all'emissione o al rinnovo di un certificato ACM? ](https://aws.amazon.com/premiumsupport/knowledge-center/acm-troubleshoot-caa-errors/)
+ [Nomi di dominio personalizzati](manage-custom-domain-troubleshoot.md)
**Nota**
Se utilizzi Amazon Route 53 come provider DNS, App Runner configura automaticamente il tuo dominio personalizzato con la convalida del certificato e i record DNS richiesti da collegare alla tua applicazione web App Runner. Ciò accade quando utilizzi la console App Runner per collegare il tuo dominio personalizzato al tuo servizio. L'[Gestisci i domini personalizzati](#manage-custom-domains.manage)argomento che segue fornisce ulteriori informazioni.
### Record di destinazione DNS
Aggiungi i record di destinazione DNS al tuo server DNS per indirizzare il dominio App Runner. Aggiungi un record per il dominio personalizzato e un altro per il `www` sottodominio, se hai scelto questa opzione. Quindi, attendi che lo stato del dominio personalizzato diventi ** Attivo ** nella console App Runner. Questa operazione richiede in genere diversi minuti, ma può richiedere fino a 24-48 ore (1—2 giorni). Quando il dominio personalizzato viene convalidato, App Runner inizia a indirizzare il traffico da questo dominio alla tua applicazione web.
**Nota**
Per una migliore compatibilità con i servizi App Runner, ti consigliamo di utilizzare Amazon Route 53 come provider DNS. Se non usi Amazon Route 53 per gestire i tuoi record DNS pubblici, contatta il tuo provider DNS per scoprire come aggiungere record.
Se utilizzi Amazon Route 53 come provider DNS, puoi aggiungere un record CNAME o alias per il sottodominio. * * Per il dominio * principale*, assicurati di utilizzare il record alias.
Puoi acquistare un nome di dominio da Amazon Route 53 o da un altro provider. Per acquistare un nome di dominio con Amazon Route 53, consulta [ Registrazione di un nuovo dominio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html), nella * Amazon Route 53 Developer Guide*.
Per istruzioni su come configurare un target DNS in Route 53, consulta [ Routing traffic to your resources](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-routing-traffic-to-resources.html), nella * Amazon Route 53 Developer Guide. *
Per istruzioni su come configurare un target DNS su altri registrar, come GoDaddy Shopify, Hover e così via, consulta la loro documentazione specifica sull'aggiunta di record DNS Target.
### Specifica un dominio da associare al tuo servizio App Runner
Puoi specificare un dominio da associare al tuo servizio App Runner nei seguenti modi:
+ *Un dominio principale*: il DNS presenta alcune limitazioni intrinseche che potrebbero impedirti di creare record CNAME per il nome di dominio principale. Ad esempio, se il tuo nome di dominio è`example.com`, puoi creare un record CNAME che indirizza il traffico verso il tuo servizio App `acme.example.com` Runner. Tuttavia, non puoi creare un record CNAME che indirizzi il traffico verso il tuo servizio App `example.com` Runner. Per creare un dominio principale, assicurati di aggiungere un record alias.
Un record alias è specifico di Route 53 e presenta i seguenti vantaggi rispetto ai record CNAME:
+ Route 53 offre una maggiore flessibilità in quanto è possibile creare record alias per il dominio principale o il sottodominio. Ad esempio, se il tuo nome di dominio è`example.com`, puoi creare un record che indirizza le richieste da `example.com` o `acme.example.com` verso il tuo servizio App Runner.
+ È più efficiente in termini di costi. Questo perché Route 53 non addebita alcun costo per le richieste che utilizzano un record alias per indirizzare il traffico.
+ *Un sottodominio*: ad esempio, `login.example.com` o. `admin.login.example.com` Facoltativamente, puoi anche associare il `www` sottodominio come parte della stessa operazione. Puoi aggiungere un record CNAME o alias per il sottodominio.
+ *Una jolly*: ad esempio,. `*.example.com` In questo caso non puoi utilizzare l'`www`opzione. Puoi specificare un carattere jolly solo come sottodominio immediato di un dominio principale e solo a sé stante. Queste non sono specifiche valide:`login*.example.com`,. `*.login.example.com` Questa specifica jolly associa tutti i sottodomini immediati e non associa il dominio principale stesso. Il dominio principale deve essere associato in un'operazione separata.
Un'associazione di dominio più specifica ha la precedenza su un'associazione meno specifica. Ad esempio, sostituisce`login.example.com`. `*.example.com` Vengono utilizzati il certificato e il CNAME dell'associazione più specifica.
L'esempio seguente mostra come è possibile utilizzare più associazioni di dominio personalizzate:
1. `example.com`Associati alla home page del tuo servizio. Abilita `www` l'associazione`www.example.com`.
1. `login.example.com`Associati alla pagina di accesso del tuo servizio.
1. `*.example.com`Associa a una pagina personalizzata «non trovata».
## Dissociare (scollegare) un dominio personalizzato
Puoi dissociare (scollegare) un dominio personalizzato dal tuo servizio App Runner. Quando scolleghi un dominio, App Runner interrompe il routing del traffico da questo dominio alla tua applicazione web.
**Nota**
Devi eliminare i record del dominio che hai dissociato dal tuo server DNS.
App Runner crea internamente certificati che tracciano la validità del dominio. Questi certificati sono archiviati in AWS Certificate Manager (ACM). App Runner non elimina questi certificati per 7 giorni dopo la dissociazione di un dominio dal servizio o dopo l'eliminazione del servizio.
## Gestisci i domini personalizzati
Gestisci i domini personalizzati per il tuo servizio App Runner utilizzando uno dei seguenti metodi:
**Nota**
Per una migliore compatibilità con i servizi App Runner, ti consigliamo di utilizzare Amazon Route 53 come provider DNS. Se non usi Amazon Route 53 per gestire i tuoi record DNS pubblici, contatta il tuo provider DNS per scoprire come aggiungere record.
Se utilizzi Amazon Route 53 come provider DNS, puoi aggiungere un record CNAME o alias per il sottodominio. * * Per il dominio * principale*, assicurati di utilizzare un record alias.
------
#### [ App Runner console ]
**Per associare (collegare) un dominio personalizzato utilizzando la console App Runner**
1. Apri la console [ App Runner e](https://console.aws.amazon.com/apprunner), nell'**elenco delle ** regioni, seleziona il tuo. Regione AWS
1. Nel pannello di navigazione, scegli ** Servizi**, quindi scegli il tuo servizio App Runner.
La console mostra la dashboard del servizio con una panoramica ** ** del servizio.
1. Nella pagina del dashboard del servizio, scegli la scheda Domini ** ** personalizzati.
La console mostra i domini personalizzati associati al servizio o ** Nessun dominio personalizzato. **
1. Nella ** scheda Domini ** personalizzati, scegli Collega dominio. ** **
1. Viene visualizzata la ** pagina ** Link al dominio personalizzato.
+ Se il tuo dominio personalizzato è registrato con Amazon Route 53, seleziona ** Amazon Route 53 ** for ** Domain registrar**.
1. Seleziona il nome di ** dominio ** dall'elenco a discesa. Questo elenco mostra il nome dei nomi di dominio di Route 53 e l'ID della zona ospitata.
**Nota**
Devi prima creare un dominio Route 53 utilizzando il servizio Amazon Route 53 dallo stesso AWS account che utilizzi per gestire le altre risorse App Runner.
1. Seleziona il tipo di record ** DNS. **
1. Scegli ** Link domain**.
**Nota**
Se App Runner mostra un messaggio di errore che indica che il tentativo di configurazione automatica non è riuscito, puoi procedere configurando i record DNS manualmente. Questo problema può verificarsi se lo stesso nome di dominio è stato precedentemente scollegato da un servizio, senza che il provider DNS registri che indichino che il servizio è stato successivamente eliminato. In questo caso, ad App Runner viene impedito di sovrascrivere automaticamente questi record. Per completare la configurazione DNS, salta il resto dei passaggi di questa procedura e segui le istruzioni in. [Configura un record alias Amazon Route 53](manage-custom-domains-route53.md)
+ Se il tuo dominio personalizzato è registrato presso un altro registrar di domini, seleziona ** ** Non—Amazon for Domain registrar. ** **
1. Inserisci il nome del dominio. ** **
1. Scegli ** Link domain**.
1. Viene visualizzata la ** pagina ** Configura DNS.
+ Se Amazon Route 53 è il tuo provider DNS, questo passaggio è facoltativo.
A questo punto App Runner ha configurato automaticamente il dominio Route 53 con la convalida del certificato e i record DNS richiesti.
**Nota**
Se lo stesso nome di dominio era stato precedentemente scollegato da un servizio, senza che il provider DNS registrasse che indicasse che il servizio veniva successivamente eliminato, la configurazione automatica tentata da App Runner avrebbe potuto fallire. Per ovviare a questo problema e completare l'associazione DNS, procedi con i passaggi ** (1) ** e ** (2) ** nella ** pagina ** Configura DNS per copiare i record di destinazione e certificato correnti nel provider DNS.
1. Copia i record di convalida del certificato e i record di destinazione DNS e aggiungili al tuo server DNS. App Runner può quindi convalidare che possiedi o controlli il dominio.
**Nota**
Per rinnovare automaticamente i certificati di dominio personalizzati, assicurati di non eliminare i record di convalida dei certificati dal tuo server DNS.
+ Per ulteriori informazioni sulla ** configurazione della convalida dei certificati**, consulta la convalida [ DNS nella Guida per l'utente. ](https://docs.aws.amazon.com/acm/latest/userguide/dns-validation.html) * [AWS Certificate Manager](https://docs.aws.amazon.com/acm/latest/userguide/) *
+ Per informazioni su come ** configurare la destinazione DNS ** con il record alias di Amazon Route 53, consulta. [Configura il record alias di Amazon Route 53 per il tuo DNS di destinazione](manage-custom-domains-route53.md)
+ Se utilizzi un provider DNS diverso da Amazon Route 53, segui questi passaggi.
1. Copia i record di convalida del certificato e i record di destinazione DNS e aggiungili al tuo server DNS. App Runner può quindi convalidare che possiedi o controlli il dominio.
**Nota**
Per rinnovare automaticamente i certificati di dominio personalizzati, assicurati di non eliminare i record di convalida dei certificati dal tuo server DNS.
+ Per ulteriori informazioni sulla ** configurazione della convalida dei certificati**, consulta la convalida [ DNS nella Guida per l'utente. ](https://docs.aws.amazon.com/acm/latest/userguide/dns-validation.html) * [AWS Certificate Manager](https://docs.aws.amazon.com/acm/latest/userguide/) *
+ Per istruzioni su come configurare un target DNS su altri registrar, come Shopify, Hover e così via GoDaddy, consulta la loro documentazione specifica sull'aggiunta di DNS Target.
1. Scegli Chiudi ** **
La console mostra nuovamente il pannello di controllo. La ** scheda Domini ** personalizzati ha un nuovo riquadro che mostra il dominio che hai appena collegato allo stato di convalida DNS del certificato in ** sospeso. **
1. Quando lo stato del dominio cambia in ** Attivo**, verifica che il dominio funzioni per indirizzare il traffico accedendo al dominio.
**Nota**
Per istruzioni su come risolvere gli errori relativi al dominio personalizzato, consulta. [Nomi di dominio personalizzati](manage-custom-domain-troubleshoot.md)
**Per dissociare (scollegare) un dominio personalizzato utilizzando la console App Runner**
1. **Nella scheda Domini ** personalizzati, seleziona il riquadro relativo al dominio da dissociare, quindi scegli Scollega il dominio. ** **
1. Nella finestra di ** dialogo ** Scollega dominio, verifica l'azione scegliendo Scollega dominio. ** **
**Nota**
Devi eliminare i record del dominio che hai disassociato dal tuo server DNS.
------
#### [ App Runner API or AWS CLI ]
Per associare un dominio personalizzato al tuo servizio utilizzando l'API App Runner oppure AWS CLI, richiama l'[AssociateCustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_AssociateCustomDomain.html)azione API. Quando la chiamata ha esito positivo, viene restituito un [ CustomDomain ](https://docs.aws.amazon.com/apprunner/latest/api/API_CustomDomain.html) oggetto che descrive il dominio personalizzato associato al servizio. L'oggetto mostra uno `CREATING` stato e contiene un elenco di [ CertificateValidationRecord ](https://docs.aws.amazon.com/apprunner/latest/api/API_CertificateValidationRecord.html) oggetti. La chiamata restituisce anche l'alias di destinazione che è possibile utilizzare per configurare la destinazione DNS. Si tratta di record che puoi aggiungere al tuo DNS.
Per dissociare un dominio personalizzato dal tuo servizio utilizzando l'API App Runner oppure AWS CLI, richiama l'[DisassociateCustomDomain](https://docs.aws.amazon.com/apprunner/latest/api/API_DisassociateCustomDomain.html)azione API. Quando la chiamata ha esito positivo, viene restituito un [ CustomDomain ](https://docs.aws.amazon.com/apprunner/latest/api/API_CustomDomain.html) oggetto che descrive il dominio personalizzato che viene dissociato dal servizio. L'oggetto mostra uno `DELETING` stato.
------
**Topics**
+ [Associa (link) un dominio personalizzato al tuo servizio](#manage-custom-domains.associate-custom-domain)
+ [Dissociare (scollegare) un dominio personalizzato](#manage-custom-domains.disassociate-custom-domain)
+ [Gestisci i domini personalizzati](#manage-custom-domains.manage)
+ [Configura il record alias di Amazon Route 53 per il tuo DNS di destinazione](manage-custom-domains-route53.md)