Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice IPv6 con Kinesis Video Streams

Puede configurar Kinesis Video Streams para que utilice IPv6 tanto en las operaciones del plano de control como en el plano de datos. Esto permite que sus aplicaciones se comuniquen con los servicios de Kinesis Video Streams mediante direcciones IPv6 a través de puntos de conexión de doble pila.

Kinesis Video Streams admite IPv6 a través de terminales de doble pila para aplicaciones de productores y consumidores. Puede configurar sus aplicaciones para que usen IPv6 para las llamadas a la API del plano de control y las operaciones de transmisión del plano de datos.

Configure el AWS SDK para IPv6

Si utiliza el AWS SDK para llamar a las API del plano de control de Kinesis Video Streams en su configuración de producción, puede habilitar IPv6 configurando puntos finales de doble pila. El AWS SDK proporciona varios métodos estandarizados para habilitar los puntos finales de doble pila.

Utilización de variables de entorno

Establezca la siguiente variable de entorno para habilitar los puntos de conexión IPv6 de doble pila:

export AWS_USE_DUALSTACK_ENDPOINT=true

Use la AWS Archivo de configuración de la de

Añada la siguiente configuración a su archivo de AWS configuración (): ~/.aws/config

[default]
use_dualstack_endpoint = true

Utilice las propiedades del sistema JVM (solo los SDK de Java y Kotlin)

Para las aplicaciones Java y Kotlin, defina la siguiente propiedad del sistema JVM:

-Daws.useDualstackEndpoint=true

O mediante programación en tu código Java:

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

Soporte para SDK

Los siguientes AWS SDK admiten la configuración de terminales de doble pila:

Tras configurar los puntos de enlace de doble pila, el AWS SDK utiliza automáticamente los puntos de enlace IPv6 al llamar a las API del plano de control de Kinesis Video Streams.

Configurar el SDK de Kinesis Video Streams Producer para IPv6

El SDK para productores de Kinesis Video Streams proporciona opciones de configuración de IPv6 para las operaciones del plano de control y del plano de datos. Estos ajustes funcionan con la configuración de puntos finales de doble pila del AWS SDK.

Configure el SDK de C/C ++ Producer

La versión 1.6.0 del Producer-C SDK de KVS implementa los puntos finales predeterminados y la cadena de resolución de DNS. Comprueba secuencialmente cada lugar en el que puede establecer la configuración de estos parámetros y, a continuación, selecciona el primero que establezca. La secuencia predefinida es la siguiente:

Para obtener más información sobre los SDK de productor, consulte los temas relacionados con el SDK de productor para C, el SDK de productor para C++ y el SDK de productor.

Configuración de terminales

Con 2, 3 y 4, el punto final se construirá en función de la región a la que se haya proporcionadocreateAbstractDefaultCallbacksProvider.

Filtrado de DNS

El SDK de KVS Producer establecerá el CURLOPT_IPRESOLVE parámetro apropiado en función de la configuración:

La versión 3.5.0 del SDK de C++ Producer usa el Producer-C SDK 1.6.0 para las llamadas a la API de KVS.

Configura el complemento GStreamer

El complemento GStreamer utiliza el SDK de C Producer subyacente, por lo que la configuración de IPv6 se gestiona automáticamente al configurar el SDK de C para IPv6, tal y como se ha descrito anteriormente.

No es necesario modificar el código, basta con compilar el SDK con los parámetros de CMake o configurar las variables de entorno adecuadas, tal y como se describe en la sección anterior.

Resolución del punto final del plano de datos

Para las operaciones del plano de datos, utilice la GetDataEndpoint API para recuperar el punto final del plano de datos de doble pila adecuado. El servicio devuelve el punto final correspondiente en función de la URL de la solicitud.

Ejemplo:

Configure el AWS CLI para IPv6

Si utiliza las AWS CLI operaciones de Kinesis Video Streams (normalmente para trabajos de prueba de concepto), puede habilitar IPv6 configurando puntos finales de doble pila.

Uso de una variable de entorno

export AWS_USE_DUALSTACK_ENDPOINT=true

Use la AWS Archivo de configuración de la de

Añada lo siguiente a su archivo de configuración (): AWS CLI ~/.aws/config

[default]
use_dualstack_endpoint = true

Ejemplos de configuraciones

Ejemplo de SDK en C

Para compilar el Producer-C SDK de KVS en IPV6-only modo e ignorar la configuración de las variables de entorno, utilice los siguientes comandos para compilar el SDK:

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

Consideraciones

Requisitos de red

Compatibilidad con el SDK

Pruebas y validación

Antes de implementar las aplicaciones de IPv6-enabled Kinesis Video Streams en producción:

Clientes afectados por la actualización para incluir IPv6

Al habilitar IPv6 para Kinesis Video Streams, hay varias áreas en las que puede que necesite actualizar las configuraciones y políticas existentes para garantizar una funcionalidad continua.

Políticas de IAM y filtrado de direcciones IP

Si utilizas el filtrado de direcciones IP de origen en tus políticas de usuario, políticas de roles o políticas basadas en recursos de IAM, debes actualizar estas políticas para incluir los rangos de direcciones IPv6.

Ejemplo de actualización de la política de IAM para 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"
          ]
        }
      }
    }
  ]
}

Registro y supervisión

Las direcciones IPv6 tienen un formato diferente al de las direcciones IPv4, lo que puede afectar a sus sistemas de registro, supervisión y análisis.

registros

Los registros contendrán las direcciones IPv6 en el sourceIPAddress campo cuando las solicitudes se realicen a través de IPv6. Actualice las herramientas y los scripts de análisis de registros para gestionar los formatos de direcciones IPv6.

Ejemplo de dirección IPv6 en los registros:

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

Resolución de problemas

Problemas comunes

Pasos de verificación

Validación de la configuración

Puede verificar la configuración de sus terminales de doble pila comprobando lo siguiente: