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

Usa IPv6 con Kinesis Video Streams

È possibile configurare Kinesis Video Streams per utilizzare IPv6 sia per le operazioni sul piano di controllo che sul piano dati. Ciò consente alle applicazioni di comunicare con i servizi Kinesis Video Streams utilizzando indirizzi IPv6 tramite endpoint dual-stack.

Kinesis Video Streams supporta IPv6 tramite endpoint dual-stack per applicazioni di produzione e consumo. Puoi configurare le tue applicazioni per utilizzare IPv6 per le chiamate API del piano di controllo e le operazioni di streaming del piano dati.

Configura il AWS SDK per IPv6

Se utilizzi l' AWS SDK per richiamare le API del piano di controllo di Kinesis Video Streams nella configurazione di produzione, puoi abilitare IPv6 configurando gli endpoint dual-stack. L'SDK fornisce diversi metodi standardizzati per abilitare gli endpoint dual-stack. AWS

Usa variabili di ambiente

Imposta la seguente variabile di ambiente per abilitare gli endpoint dual-stack IPv6:

export AWS_USE_DUALSTACK_ENDPOINT=true

Usa il AWS file di configurazione

Aggiungi la seguente impostazione al tuo file AWS di configurazione (~/.aws/config):

[default]
use_dualstack_endpoint = true

Usa le proprietà del sistema JVM (solo SDK Java e Kotlin)

Per le applicazioni Java e Kotlin, imposta la seguente proprietà di sistema JVM:

-Daws.useDualstackEndpoint=true

O a livello di codice nel tuo codice Java:

System.setProperty("aws.useDualstackEndpoint", "true");

Supporto SDK

I seguenti AWS SDK supportano la configurazione degli endpoint dual-stack:

Dopo aver configurato gli endpoint dual-stack, l' AWS SDK utilizza automaticamente gli endpoint IPv6 quando chiama le API del piano di controllo di Kinesis Video Streams.

Configurazione dell'SDK di Kinesis Video Streams Producer per IPv6

L'SDK Kinesis Video Streams Producer offre opzioni di configurazione IPv6 per le operazioni sul piano di controllo e sul piano dati. Queste impostazioni funzionano con la configurazione degli endpoint dual-stack SDK. AWS

Configura l'SDK ++ Producer C/C

Gli endpoint e la catena di risoluzione DNS predefiniti sono implementati dalla versione 1.6.0 di KVS SDK Producer-C . Controlla in sequenza ogni posizione in cui è possibile impostare la configurazione per questi parametri, quindi seleziona la prima che imposti. La sequenza predefinita è la seguente:

Per ulteriori informazioni sugli SDK di Producer, consulta gli argomenti correlati a Producer SDK for C, Producer SDK for C++ e Producer SDK.

Configurazione degli endpoint

Con 2, 3 e 4, l'endpoint verrà costruito in base alla regione fornita a. createAbstractDefaultCallbacksProvider

Filtraggio DNS

KVS Producer SDK imposterà il CURLOPT_IPRESOLVE parametro appropriato in base alla configurazione:

La versione 3.5.0 di C++ Producer SDK utilizza l'SDK 1.6.0 per le Producer-C chiamate API KVS.

Configura il plugin GStreamer

Il plugin GStreamer utilizza l'SDK C Producer sottostante, quindi la configurazione IPv6 viene gestita automaticamente quando si configura il C SDK per IPv6 come descritto in precedenza.

Non è necessario modificare il codice, è sufficiente creare l'SDK con i parametri CMake o impostare le variabili di ambiente appropriate come descritto nella sezione precedente.

Risoluzione degli endpoint del piano dati

Per le operazioni sul piano dati, utilizza l'GetDataEndpointAPI per recuperare l'endpoint del piano dati dual-stack appropriato. Il servizio restituisce l'endpoint corrispondente in base all'URL della richiesta.

Esempio:

Configura il AWS CLI per IPv6

Se utilizzi le operazioni di Kinesis Video Streams (in genere AWS CLI per lavori di prototipazione), puoi abilitare IPv6 configurando endpoint dual-stack.

Usa una variabile di ambiente

export AWS_USE_DUALSTACK_ENDPOINT=true

Usa il AWS file di configurazione

Aggiungi quanto segue al tuo file AWS CLI di configurazione (~/.aws/config):

[default]
use_dualstack_endpoint = true

Esempi di configurazione

Esempio di SDK C

Per creare l' Producer-C SDK KVS in IPV6-only modalità e ignorare la configurazione delle variabili di ambiente, usa i seguenti comandi per creare l'SDK:

cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE
make -j

Considerazioni

Requisiti di rete

Compatibilità con SDK

Test e convalida

Prima di distribuire le applicazioni IPv6-enabled Kinesis Video Streams in produzione:

Clienti interessati dall'aggiornamento per l'inclusione di IPv6

Quando abiliti IPv6 per Kinesis Video Streams, ci sono diverse aree in cui potresti dover aggiornare le configurazioni e le politiche esistenti per garantire la continuità della funzionalità.

Policy IAM e filtraggio degli indirizzi IP

Se utilizzi il filtraggio degli indirizzi IP di origine nelle politiche degli utenti, delle politiche dei ruoli o delle politiche basate sulle risorse IAM, devi aggiornare queste politiche per includere gli intervalli di indirizzi IPv6.

Esempio di aggiornamento della policy IAM per IPv6:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "kinesisvideo:*",
      "Resource": "*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "203.0.113.0/24",
            "2001:db8::/32"
          ]
        }
      }
    }
  ]
}

Registrazione di log e monitoraggio

Gli indirizzi IPv6 hanno un formato diverso dagli indirizzi IPv4, il che può influire sui sistemi di registrazione, monitoraggio e analisi.

log

i registri conterranno gli indirizzi IPv6 nel campo quando le richieste vengono effettuate tramite IPv6. sourceIPAddress Aggiorna gli strumenti e gli script di analisi dei log per gestire i formati di indirizzi IPv6.

Esempio di indirizzo IPv6 nei log:

{
  "sourceIPAddress": "2001:db8::1",
  "eventName": "CreateStream",
  "eventSource": "kinesisvideo.amazonaws.com"
}

Risoluzione dei problemi

Problemi comuni

Fasi di verifica

Convalida della configurazione

Puoi verificare la configurazione dell'endpoint dual-stack controllando: