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à.

# Crea un portale in API Gateway
<a name="apigateway-portals-create-portal"></a>

Un portale è una raccolta di prodotti. Sei tu a controllare l'autorizzazione, il marchio e la pubblicazione del tuo portale. Quando crei un portale, il relativo stato di pubblicazione è`Disabled`. Ciò significa che il portale non è individuabile sul Web. Per consentire ai consumatori di accedere al tuo portale, devi pubblicarlo. Prima di pubblicare il portale, puoi anche visualizzarlo in anteprima. 

API Gateway supporta i portali sui seguenti browser:
+ Firefox
+ Google Chrome
+ Microsoft Edge
+ Safari

## Scegli un nome di dominio
<a name="apigateway-portals-create-portal-domain-name"></a>

Per impostazione predefinita, l'URL del portale è ospitato nel seguente nome di dominio di proprietà di Amazon:

```
https://p-portalId.apigw-portal.us-east-1.on.aws
```

Per personalizzare il nome di dominio, puoi fornire un nome di dominio di tua proprietà e un certificato SSL per il dominio personalizzato. Il certificato deve essere gestito con [AWS Certificate Manager](https://docs.aws.amazon.com/acm/latest/userguide/)(ACM) negli Stati Uniti orientali (Virginia settentrionale) ed essere supportato da Amazon. CloudFront Per ulteriori informazioni, consulta [Requisiti per l'utilizzo dei SSL/TLS certificati con](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cnames-and-https-requirements.html). CloudFront

Quando utilizzi un nome di dominio personalizzato, API Gateway crea una CloudFront distribuzione, protetta in transito con il tuo certificato ACM. API Gateway fornisce quindi un record di alias da aggiungere alla configurazione DNS. Il record di alias è il nome di dominio di proprietà di Amazon. Devi aggiungere questo record di alias per indirizzare il traffico verso la CloudFront distribuzione del tuo dominio personalizzato. Il nome di dominio fornito deve essere univoco e non essere già utilizzato dall'elenco degli alias di una distribuzione esistente CloudFront .

Se utilizzi il tuo nome di dominio, API Gateway utilizza la politica `TLS_1_2` di sicurezza per proteggere il tuo portale. Per ulteriori informazioni, consulta [Protocolli e cifrari supportati tra i visualizzatori.](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/secure-connections-supported-viewer-protocols-ciphers.html) Non puoi modificare questo valore.

## Crea un portale
<a name="apigateway-portals-create-portal-create"></a>

Utilizzi la console API Gateway per creare e configurare il tuo portale. Le seguenti procedure guidano l'utente attraverso tutti i passaggi richiesti. Puoi anche scegliere **Vai alla revisione e crea** alla fine della prima procedura per creare un portale vuoto.

La procedura seguente mostra come creare un portale. Innanzitutto, definisci i dettagli del tuo portale.

**Per definire i dettagli del portale**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. **Nel pannello di navigazione principale, scegli Portali.**

1. Selezionare **Create portal (Crea portale)**.

1. In Dettagli del portale, per **Nome del portale**, inserisci un nome.

1. Per **Descrizione del portale**, inserisci una descrizione.

1. Per **l'autorizzazione del portale**, seleziona come autorizzare il portale.
   + Se è la prima volta che crei un portale, ti consigliamo di scegliere **Nessuno**. Se prevedi di aggiungere una produzione APIs al tuo portale, usa **Richiedi autorizzazione**.
   + Per richiedere agli utenti del portale di autenticarsi per utilizzare il portale, scegli **Richiedi autorizzazione** ed esegui le seguenti operazioni:

     1. Per il pool di **utenti di Amazon Cognito, seleziona il tuo pool** di utenti.

        Il pool di utenti deve trovarsi nella stessa regione del portale.

     1. Per **l'ID client dell'applicazione**, scegli l'ID client dell'app.

        Nel client dell'app, devi impostare l'URL di callback sull'URL predefinito del portale.

     1. Per il **dominio del pool di utenti**, inserisci il dominio del pool di utenti. Per ulteriori informazioni, vedere [Configurazione di un dominio del pool di utenti](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html).

1. Per la **configurazione del dominio**, seleziona il nome di dominio per il tuo portale.
   + Se è la prima volta che crei un portale, ti consigliamo di scegliere **Dominio predefinito**. Una volta pubblicato, il portale sarà disponibile all'indirizzo`https://p-portalId.apigw-portal.us-east-1.on.aws`.
   + Per fornire un nome di dominio personalizzato di tua proprietà, seleziona **Nome di dominio personalizzato** e procedi come segue:

     1. Per **Nome di dominio**, inserisci un nome di dominio completo.

     1. Per il **certificato ACM**, scegli un certificato ACM che copra il nome di dominio.

         Dovrai aggiungere il record di alias fornito da API Gateway al tuo record DNS, per servire il traffico proveniente dal tuo portale.

1. Per aggiungere un app monitor CloudWatch RUM al portale, per **RUM app monitor**, scegli un app monitor. Per ulteriori informazioni, consulta [CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM.html).

1. Scegli **Next (Successivo)**.

Dopo aver definito i dettagli del portale, aggiungi i prodotti del portale. È possibile modificare i prodotti del portale nel portale in qualsiasi momento, ma è necessario ripubblicare il portale affinché le modifiche abbiano effetto.

**Per selezionare i prodotti del portale**

1. Dall'elenco delle risorse, seleziona i prodotti da aggiungere al portale.

1. Scegli **Next (Successivo)**.

Dopo aver selezionato i prodotti, personalizzi il design del portale. Per caricare un logo del portale, devi avere un'immagine caricata su Amazon S3. Puoi modificare questi valori in qualsiasi momento, ma devi ripubblicare il portale affinché le modifiche abbiano effetto. 

**(Facoltativo) Per personalizzare il portale**

1. Per il **logo di Portal**, fornisci l'URI S3 per il tuo file.

   Sono `.jpg` supportati solo `.svg` o. `.png`

1. Per personalizzare il design del tuo portale, hai due opzioni:

   1. Puoi scegliere il **tema Portal** per applicare un tema cromatico predefinito al tuo portale.

   1. Puoi usare i selettori di colore per selezionare tutte le opzioni di progettazione del tuo portale.

1. Scegli **Next (Successivo)**.

Dopo aver selezionato il design del portale, esamina le informazioni relative al portale.

**Per rivedere il tuo portale**
+ Rivedi le impostazioni nella pagina di revisione e creazione. Quando si è soddisfatti delle impostazioni, selezionare **Create (Crea)**.

Se utilizzi un pool di utenti Amazon Cognito per controllare l'accesso al tuo portale, devi impostare l'URL di callback sull'URL predefinito del portale nel client dell'app. Per ulteriori informazioni, consulta Impostazioni [specifiche dell'applicazione con i client dell'app](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html).

Il portale non sarà più disponibile per i consumatori dopo la sua creazione. È necessario pubblicare il portale per renderlo accessibile su Internet. Per ulteriori informazioni, consulta [Pubblica un portale in API Gateway](apigateway-portals-publish-portal.md).