Crea un portale in API Gateway - Gateway Amazon API
Scegli un nome di dominioCrea un portale

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

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

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(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. 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. Non puoi modificare questo valore.

Crea un portale

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.

  2. Nel pannello di navigazione principale, scegli Portali.

  3. Selezionare Create portal (Crea portale).

  4. In Dettagli del portale, per Nome del portale, inserisci un nome.

  5. Per Descrizione del portale, inserisci una descrizione.

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

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

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

  7. 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'indirizzohttps://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.

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

  8. Per aggiungere un app monitor CloudWatch RUM al portale, per RUM app monitor, scegli un app monitor. Per ulteriori informazioni, consulta CloudWatch RUM.

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

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

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

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

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

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.