Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utiliser IPv6 avec Kinesis Video Streams

Vous pouvez configurer Kinesis Video Streams pour utiliser IPv6 à la fois pour les opérations du plan de contrôle et du plan de données. Cela permet à vos applications de communiquer avec les services Kinesis Video Streams à l'aide d'adresses IPv6 via des points de terminaison à double pile.

Kinesis Video Streams prend en charge le protocole IPv6 via des points de terminaison à double pile pour les applications destinées aux producteurs et aux consommateurs. Vous pouvez configurer vos applications pour utiliser IPv6 pour les appels d'API du plan de contrôle et les opérations de streaming du plan de données.

Configurez le AWS SDK pour IPv6

Si vous utilisez le AWS SDK pour appeler les API du plan de contrôle Kinesis Video Streams dans votre configuration de production, vous pouvez activer IPv6 en configurant des points de terminaison à double pile. Le AWS SDK fournit plusieurs méthodes standardisées pour activer les points de terminaison à double pile.

Utiliser des variables d'environnement

Définissez la variable d'environnement suivante pour activer les points de terminaison IPv6 à double pile :

export AWS_USE_DUALSTACK_ENDPOINT=true

Utilisez la commande AWS Fichier de configuration  

Ajoutez le paramètre suivant à votre fichier AWS de configuration (~/.aws/config) :

[default]
use_dualstack_endpoint = true

Utiliser les propriétés du système JVM (SDK Java et Kotlin uniquement)

Pour les applications Java et Kotlin, définissez la propriété système JVM suivante :

-Daws.useDualstackEndpoint=true

Ou par programmation dans votre code Java :

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

Prise en charge de SDK

Les AWS SDK suivants prennent en charge la configuration des terminaux à double pile :

Après avoir configuré des points de terminaison à double pile, le AWS SDK utilise automatiquement les points de terminaison IPv6 lorsqu'il appelle les API du plan de contrôle Kinesis Video Streams.

Configuration du SDK Kinesis Video Streams Producer pour IPv6

Le SDK Kinesis Video Streams Producer fournit des options de configuration IPv6 pour les opérations du plan de contrôle et du plan de données. Ces paramètres fonctionnent avec la configuration du point de terminaison à double pile du AWS SDK.

Configuration du SDK C/C ++ Producer

Les points de terminaison par défaut et la chaîne de résolution DNS sont implémentés par le Producer-C SDK KVS version 1.6.0. Il vérifie séquentiellement chaque endroit où vous pouvez définir la configuration de ces paramètres, puis sélectionne le premier que vous définissez. La séquence prédéfinie est la suivante :

Pour plus d'informations sur les SDK Producer, consultez les rubriques relatives au SDK Producer pour C, au SDK Producer pour C++ et au SDK Producer.

Configuration du terminal

Avec 2, 3 et 4, le point de terminaison sera construit en fonction de la région fournie àcreateAbstractDefaultCallbacksProvider.

Filtrage DNS

Le SDK KVS Producer définira le CURLOPT_IPRESOLVE paramètre approprié en fonction de la configuration :

La version 3.5.0 du SDK C++ Producer utilise le Producer-C SDK 1.6.0 pour les appels d'API KVS.

Configurer le plugin GStreamer

Le plugin GStreamer utilise le SDK C Producer sous-jacent, de sorte que la configuration IPv6 est gérée automatiquement lorsque vous configurez le SDK C pour IPv6 comme décrit précédemment.

Il n'est pas nécessaire de modifier le code, il suffit de créer le SDK avec les paramètres CMake ou de définir les variables d'environnement appropriées comme décrit dans la section précédente.

Résolution des extrémités du plan de données

Pour les opérations sur le plan de données, utilisez l'GetDataEndpointAPI pour récupérer le point de terminaison du plan de données à double pile approprié. Le service renvoie le point de terminaison correspondant en fonction de l'URL de la demande.

Exemple :

Configurez le AWS CLI pour IPv6

Si vous utilisez les opérations AWS CLI pour Kinesis Video Streams (généralement pour des travaux de validation de concept), vous pouvez activer IPv6 en configurant des points de terminaison à double pile.

Utiliser une variable d'environnement

export AWS_USE_DUALSTACK_ENDPOINT=true

Utilisez la commande AWS Fichier de configuration  

Ajoutez ce qui suit à votre fichier AWS CLI de configuration (~/.aws/config) :

[default]
use_dualstack_endpoint = true

Exemples de configuration

Exemple de SDK C

Pour créer le Producer-C SDK KVS en IPV6-only mode et ignorer la configuration des variables d'environnement, utilisez les commandes suivantes pour créer le SDK :

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

Considérations

Exigences réseau

Compatibilité avec le SDK

Tests et validation

Avant de déployer des applications IPv6-enabled Kinesis Video Streams en production :

Clients mis à niveau pour inclure IPv6

Lorsque vous activez IPv6 pour Kinesis Video Streams, vous devrez peut-être mettre à jour vos configurations et politiques existantes dans plusieurs domaines afin de garantir le fonctionnement continu.

Politiques IAM et filtrage des adresses IP

Si vous utilisez le filtrage des adresses IP source dans vos politiques utilisateur IAM, vos politiques de rôle ou vos politiques basées sur les ressources, vous devez mettre à jour ces politiques pour inclure les plages d'adresses IPv6.

Exemple de mise à jour de la politique IAM pour 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"
          ]
        }
      }
    }
  ]
}

Journalisation et surveillance

Les adresses IPv6 ont un format différent de celui des adresses IPv4, ce qui peut avoir un impact sur vos systèmes de journalisation, de surveillance et d'analyse.

journaux

les journaux contiendront les adresses IPv6 dans le sourceIPAddress champ lorsque les demandes sont effectuées via IPv6. Mettez à jour vos outils et scripts d'analyse des journaux pour gérer les formats d'adresse IPv6.

Exemple d'adresse IPv6 dans les journaux :

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

Résolution des problèmes

Problèmes courants

Étapes de vérification

Validation de configuration

Vous pouvez vérifier la configuration de votre point de terminaison à double pile en vérifiant :