

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

# Configura CloudFront l'integrazione di base con MediaTailor
<a name="cloudfront-basic-setup"></a>

AWS Elemental MediaTailor l'integrazione con Amazon CloudFront migliora le prestazioni di distribuzione dei contenuti per i tuoi spettatori. Questo argomento ti guida nella configurazione di una CloudFront distribuzione di base per MediaTailor. Con questa integrazione, i tuoi spettatori possono accedere a contenuti personalizzati attraverso la CloudFront rete. Imparerai anche come configurare la corretta memorizzazione nella cache per diversi tipi di contenuto.

Per informazioni sul passaggio dei parametri di interrogazione CloudFront per l'autorizzazione e il routing, consulta. [MediaTailor parametri di query manifest](manifest-query-parameters.md) Per un routing avanzato che utilizza variabili dinamiche, vedere. [MediaTailor variabili di dominio per più fonti di contenuto](variables-domains.md)

## Prerequisiti
<a name="cf-basic-prerequisites"></a>

Prima di eseguire la configurazione CloudFront con MediaTailor, assicurati di disporre di quanto segue:
+ Un AWS account attivo con autorizzazioni per creare e gestire distribuzioni CloudFront
+ Una configurazione di MediaTailor riproduzione configurata (vedi) [Utilizzo AWS Elemental MediaTailor per inserire annunci](configurations.md)
+ Il server di origine dei contenuti è configurato e accessibile correttamente
+ Comprensione di base dei concetti di streaming video (HLS/DASH)

## Configurazione della distribuzione CloudFront
<a name="cf-basic-configuration"></a>

Segui questi passaggi per creare e configurare una CloudFront distribuzione per MediaTailor:

**Per creare una CloudFront distribuzione per MediaTailor**

1. Accedi alla console di AWS gestione e apri la CloudFront console su [https://console.aws.amazon.com/cloudfront/v3/home](https://console.aws.amazon.com/cloudfront/v3/home).

1. Scegliere **Create Distribution (Crea distribuzione)**.

1. Per il **dominio Origin**, inserisci l'URL dell' MediaTailor endpoint (ad esempio,). `a1b2c3d4.mediatailor.us-west-2.amazonaws.com`

1. Per **Protocollo**, seleziona **solo HTTPS**.

1. In **Nome**, inserisci un nome che ti aiuti a identificare l'origine (ad esempio,`mediatailor-origin`).

1. Configura le impostazioni predefinite del comportamento della cache:

   1. Per **il pattern Path**, utilizzate il valore predefinito (`*`).

   1. Per **Comprimere automaticamente gli oggetti**, selezionate **Sì**.

   1. Per la **politica del protocollo Viewer**, selezionate **Reindirizza HTTP a HTTPS**.

   1. Per i **metodi HTTP consentiti**, seleziona **GET, HEAD**.

   1. Per **Cache policy**, selezionate **CachingDisabled**.

   1. Per la **politica di richiesta Origin**, seleziona **AllViewer**di inoltrare tutte le intestazioni per il comportamento predefinito.
**Nota**  
Il comportamento predefinito prevede AllViewer la gestione sicura di qualsiasi contenuto che non corrisponde a schemi di percorso specifici. I comportamenti specifici della cache per manifesti e segmenti verranno configurati separatamente con politiche appropriate.

1. Configura le impostazioni di distribuzione:

   1. Per la **fascia di prezzo**, seleziona l'opzione più adatta alla posizione geografica del tuo pubblico.

   1. Per l'**ACL AWS WAF web**, seleziona un ACL web esistente o lascia su **Non abilitare le protezioni di sicurezza.**

   1. Per l'**oggetto principale predefinito, lascia vuoto**.

   1. Per la **registrazione standard**, selezionate **Attiva** per abilitare la registrazione.

1. Scegliere **Create Distribution (Crea distribuzione)**.

## Configurazione dei comportamenti della cache
<a name="cf-cache-behaviors"></a>

Dopo aver creato la distribuzione, è necessario configurare comportamenti di cache aggiuntivi per gestire in modo appropriato diversi tipi di contenuti. Questa sezione illustra la configurazione di base del comportamento della cache per. CloudFront

Per un'ottimizzazione completa della memorizzazione nella cache, comprese le impostazioni TTL avanzate, le configurazioni delle chiavi di cache e l'ottimizzazione delle prestazioni, consulta la guida all'ottimizzazione della [Ottimizzazione della memorizzazione nella cache per CDN e integrazioni MediaTailor](cdn-optimize-caching.md) CDN.

### Configurazione del comportamento della cache del manifesto
<a name="cf-manifest-behavior"></a>

Non memorizzate nella cache i manifesti perché contengono contenuti personalizzati. Segui questi passaggi per configurare il comportamento della cache:

**Per configurare il comportamento della cache del manifesto**

1. Nella CloudFront console, seleziona la tua distribuzione.

1. Scegli la scheda **Behaviors** (Comportamenti).

1. Scegli **Create behavior** (Crea comportamento).

1. Per **Path pattern**, inserisci in `*.m3u8` modo che corrisponda alle playlist multivarianti e multimediali HLS.

1. Per **Origin, seleziona la tua origine**. MediaTailor 

1. Per **Cache policy**, seleziona **CachingDisabled**.

1. Per la **policy di richiesta Origin**, seleziona questa opzione **AllViewer**per inoltrare tutte le intestazioni richieste per il contenuto dinamico.

1. Scegli **Create** (Crea).

1. Ripeti questi passaggi per i manifesti DASH utilizzando lo schema di percorso corrispondente. `*.mpd` MPDs

Questa configurazione garantisce che ogni spettatore riceva un manifesto personalizzato con il contenuto pubblicitario specifico. Il CDN non memorizza nella cache questi manifesti, quindi ogni richiesta va direttamente a. MediaTailor

### Configurazione del comportamento della cache dei segmenti
<a name="cf-segment-behavior"></a>

Configura comportamenti di cache separati per i segmenti di annunci e i segmenti di contenuto per ottimizzare le prestazioni e garantire una corretta gestione CORS.

#### Configurazione del comportamento della cache dei segmenti pubblicitari
<a name="cf-ad-segment-behavior"></a>

I segmenti di annunci pubblicati tramite il modello di `/tm/*` percorso richiedono una configurazione specifica per gestire correttamente CORS. Completare la procedura riportata di seguito.

**Per configurare il comportamento della cache dei segmenti pubblicitari**

1. Nella CloudFront console, seleziona la tua distribuzione.

1. Scegli la scheda **Behaviors** (Comportamenti).

1. Scegli **Create behavior** (Crea comportamento).

1. Per **Path pattern**, inserisci `/tm/*` per abbinare i segmenti di annunci serviti da MediaTailor.

1. Per **Origin**, seleziona l'origine MediaTailor dei segmenti (utilizzando il nome `segments.mediatailor.region.amazonaws.com` host).

1. Per **Cache policy, seleziona**. **CachingOptimized**

1. Per la **politica di richiesta Origin**, seleziona **Nessuno**.

1. Per la **politica relativa alle intestazioni di risposta**, seleziona **CORS- with-preflight-and - SecurityHeadersPolicy** per assicurarti che le intestazioni CORS cors appropriate siano incluse nelle risposte.

1. Scegli **Create** (Crea).

#### Configurazione del comportamento della cache dei segmenti di contenuto
<a name="cf-content-segment-behavior"></a>

I segmenti di contenuto possono utilizzare politiche di memorizzazione nella cache standard per prestazioni ottimali. Configura comportamenti separati per diversi formati di segmento:

**Per configurare il comportamento della cache dei segmenti di contenuto**

1. Nella CloudFront console, seleziona la tua distribuzione.

1. Scegli la scheda **Behaviors** (Comportamenti).

1. Scegli **Create behavior** (Crea comportamento).

1. Per **Path pattern**, inserisci in `*.ts` modo che corrisponda ai segmenti di contenuto HLS.

1. Per **Origin**, seleziona l'origine del contenuto.

1. Per **Cache policy**, seleziona **CachingOptimized**.

1. Per la **politica di richiesta Origin**, seleziona **Nessuno**.

1. Per la **policy Response Headers**, seleziona **CORS- with-preflight-and - SecurityHeadersPolicy** per garantire una gestione CORS coerente su tutti i tipi di contenuto.

1. Scegli **Create** (Crea).

1. Ripeti questi passaggi per altri formati di segmenti di contenuto utilizzando modelli di percorso appropriati:
   + `*.mp4`per i MP4 segmenti
   + `*.m4s`per segmenti DASH
   + `*.cmfv`e `*.cmfa` per i segmenti CMAF

Questa configurazione garantisce che i segmenti di annunci e i segmenti di contenuto vengano memorizzati nella cache in modo appropriato con una corretta gestione CORS. I segmenti di annunci utilizzano l'origine dei MediaTailor segmenti con protezione CORS, mentre i segmenti di contenuto utilizzano l'origine dei contenuti con politiche di memorizzazione nella cache ottimizzate.

## Aggiornamento della configurazione MediaTailor
<a name="cf-mediatailor-config"></a>

Dopo aver configurato la CloudFront distribuzione, aggiorna la MediaTailor configurazione per utilizzare il CloudFront dominio:

**Per aggiornare la tua MediaTailor configurazione**

1. Apri la [MediaTailor console](https://console.aws.amazon.com/mediatailor/home).

1. Seleziona la configurazione che desideri aggiornare.

1. Nella sezione **Configurazione CDN**, inserisci il nome del dominio di CloudFront distribuzione (ad esempio,`d1234abcdef.cloudfront.net`) nel campo del **prefisso del segmento di contenuto CDN**.

1. Salvare le modifiche.

Con questa configurazione, MediaTailor genera manifesti con URLs quel punto di CloudFront distribuzione anziché direttamente all'origine.

## Verifica della tua integrazione
<a name="cf-basic-testing"></a>

Dopo aver configurato la CloudFront distribuzione e aggiornato la MediaTailor configurazione, verifica l'integrazione:

**Per testare la tua CloudFront integrazione MediaTailor**

1. Richiedi un manifesto tramite la tua CloudFront distribuzione (ad esempio,`https://d1234abcdef.cloudfront.net/v1/master/12345/my-config/index.m3u8`).

1. Verifica che il manifesto contenga segmenti URLs che puntano al tuo CloudFront dominio.

1. Riproduci i contenuti tramite un lettore video e verifica che sia i contenuti che gli annunci vengano riprodotti correttamente.

1. Controlla CloudFront i log per assicurarti che le richieste vengano instradate correttamente.

## Configurazione di esempio
<a name="cf-basic-example"></a>

Ecco un esempio di configurazione di CloudFront distribuzione per i comportamenti MediaTailor appropriati della cache:

**Example CloudFront esempio di configurazione della distribuzione**  

```
{
  "DefaultCacheBehavior": {
    "TargetOriginId": "mediatailor-origin",
    "ViewerProtocolPolicy": "redirect-to-https",
    "AllowedMethods": {
      "Quantity": 2,
      "Items": ["GET", "HEAD"]
    },
    "CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
    "OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
    "Comment": "Default behavior with CachingDisabled and AllViewer"
  },
  "CacheBehaviors": [
    {
      "PathPattern": "*.m3u8",
      "TargetOriginId": "mediatailor-origin",
      "ViewerProtocolPolicy": "redirect-to-https",
      "CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
      "OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
      "Comment": "Manifest behavior with CachingDisabled and AllViewer"
    },
    {
      "PathPattern": "*.ts",
      "TargetOriginId": "mediatailor-origin", 
      "ViewerProtocolPolicy": "redirect-to-https",
      "CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e58f6",
      "OriginRequestPolicyId": "88a5eaf4-2fd4-4709-b370-b4c650ea3fcf",
      "Comment": "Segment behavior with CachingOptimized and HostHeaderOnly"
    }
  ]
}
```

Questo esempio mostra:
+ **Comportamento predefinito**: utilizza `CachingDisabled` e `AllViewer` gestisce in modo sicuro qualsiasi contenuto che non corrisponde a schemi di percorso specifici
+ **Comportamento manifesto (\*.m3u8)**: utilizza e per contenuti dinamici `CachingDisabled` `AllViewer`
+ **Comportamento del segmento (\*.ts)**: usi e `CachingOptimized` `CORS-with-preflight-and-SecurityHeadersPolicy`

## Fasi successive
<a name="cf-basic-next-steps"></a>

Dopo aver configurato l' CloudFront integrazione di base con MediaTailor, considera questi passaggi successivi:
+ Ottimizza le prestazioni con CloudFront funzionalità aggiuntive (vedi[Ottimizzazione delle MediaTailor prestazioni con funzionalità CloudFront](cloudfront-performance-optimization.md))
+ Implementa la resilienza multiregionale con MQAR (vedi) [Implementa la resilienza multiregionale per MediaTailor con MQAR](media-quality-resiliency.md)
+ Configurare il monitoraggio e la risoluzione dei problemi (vedi) [Monitora e risolvi i problemi relativi all'integrazione CloudFront MediaTailor](monitoring-and-troubleshooting.md)