本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

搭配 Amazon Kinesis Video WebRTC 使用 IPv6/雙堆疊端點

您可以設定 Amazon Kinesis Video WebRTC 為控制平面和資料平面操作使用 IPv6。這可讓您的應用程式透過雙堆疊端點，使用 IPv6 地址與 Kinesis Video WebRTC 服務通訊。

Amazon Kinesis Video WebRTC 透過雙堆疊端點支援主要和檢視器應用程式的 IPv6。您可以設定應用程式使用 IPv6/雙堆疊端點進行控制平面 API 呼叫和資料平面操作。

設定適用於 IPv6-Dual-Stack 端點的 Amazon Web Services SDK

如果您使用 Amazon Web Services SDK 在生產設定中呼叫 Kinesis Video WebRTC 控制平面 APIs，您可以透過設定雙堆疊端點來啟用 IPv6。Amazon Web Services SDK 提供多種標準化方法來啟用雙堆疊端點。

使用環境變數

設定下列環境變數以啟用 IPv6 雙堆疊端點：

export AWS_USE_DUALSTACK_ENDPOINT=true

使用 Amazon Web Services 組態檔案

將下列設定新增至您的 Amazon Web Services 組態檔案 (~/.aws/config)：

[default]
use_dualstack_endpoint = true

使用 JVM 系統屬性 （僅限 Java 和 Kotlin SDKs)

對於 Java 和 Kotlin 應用程式，設定下列 JVM 系統屬性：

-Daws.useDualstackEndpoint=true

或以程式設計方式在您的 Java 程式碼中：

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

開發套件支援

下列 Amazon Web Services SDKs支援雙堆疊端點組態：

設定雙堆疊端點之後，Amazon Web Services SDK 會在呼叫 Kinesis Video WebRTC 控制平面 APIs 時自動使用 IPv6 端點。

設定適用於 IPv6/雙堆疊端點的 Kinesis Video WebRTC 開發套件

Kinesis Video WebRTC SDK 為控制平面和資料平面操作提供雙堆疊組態選項。這些設定適用於 Amazon Web Services SDK 雙堆疊端點組態。

設定 WebRTC C 開發套件

若要使用雙堆疊 AWS KVS 端點並嘗試收集 IPv6 ICE 候選項目，請設定下列環境變數：

export KVS_DUALSTACK_ENDPOINTS=ON

在雙堆疊模式中，ICE 收集會嘗試包含 IPv6 候選項目，但相容性最終取決於本機網路組態和接收對等的功能。

若要停用雙堆疊模式，請取消設定環境變數：

unset KVS_DUALSTACK_ENDPOINTS

資料平面端點解析

對於資料平面操作，Kinesis Video WebRTC SDK 使用 GetSignalingChannelEndpoint API 擷取適當的 IPv6/雙堆疊資料平面端點。設定 IPv6/雙堆疊時，軟體開發套件會自動請求 IPv6/雙堆疊端點。

設定 IPv6/Dual-Stack AWS CLI 的

如果您使用 AWS CLI 進行 Kinesis Video WebRTC 操作 （通常用於proof-of-concept工作），您可以透過設定雙堆疊端點來啟用 IPv6。

使用環境變數

export AWS_USE_DUALSTACK_ENDPOINT=true

使用 Amazon Web Services 組態檔案

將下列項目新增至您的 AWS CLI 組態檔案 (~/.aws/config)：

[default]
use_dualstack_endpoint = true

設定雙堆疊端點之後， AWS CLI 會將 IPv6 雙堆疊端點用於所有 Amazon Web Services 呼叫，包括 Kinesis Video WebRTC 操作。

考量事項

IoT 登入資料供應商

如果您使用 IoT 登入資料進行身分驗證：

網路需求

開發套件相容性

測試和驗證

將IPv6-enabled Kinesis Video WebRTC 應用程式部署到生產環境之前：

受 IPv6 升級影響的客戶

當您為 Amazon Kinesis Video WebRTC 啟用 IPv6 時，可能需要更新現有組態和政策以確保持續功能。本節概述轉換到IPv6-enabled的端點時需要注意的關鍵區域。

IAM 政策和 IP 地址篩選

如果您在 IAM 使用者政策、角色政策或資源型政策中使用來源 IP 地址篩選，則需要更新這些政策以包含 IPv6 地址範圍。

IPv6 的 IAM 政策更新範例：

{
  "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"
          ]
        }
      }
    }
  ]
}

IAM 政策更新的重要考量事項：

網路安全群組和存取控制清單

如果您在 Amazon EC2 執行個體或其他 Amazon Web Services 服務上執行 Kinesis Video WebRTC 應用程式，則需要更新您的安全群組和網路 ACLs以允許 IPv6 流量。

日誌記錄和監控

IPv6 地址的格式與 IPv4 地址不同，這可能會影響您的記錄、監控和分析系統。

AWS CloudTrail 日誌

AWS CloudTrail 當透過 IPv6 提出請求時， 日誌會在 sourceIPAddress 欄位中包含 IPv6 地址。更新您的日誌剖析工具和指令碼，以處理 IPv6 地址格式。

AWS CloudTrail 日誌中 IPv6 地址的範例：

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

應用程式記錄

如果您的應用程式記錄用戶端 IP 地址或執行 IP 型分析，請確定您的記錄基礎設施可以處理 IPv6 地址：

監控和提醒

更新您的監控和提醒系統，以考量 IPv6 流量：

第三方整合

檢閱和更新與 Kinesis Video WebRTC 應用程式整合的第三方服務和工具：

應用程式程式碼更新

檢閱您的應用程式程式碼，了解可能需要更新的 IPv4-specific假設：

測試和驗證

在生產環境中啟用 IPv6 之前，請徹底測試您的應用程式和基礎設施：

遷移策略

考慮實作 IPv6 採用的分階段方法：

疑難排解

常見問題

驗證步驟

組態驗證

您可以檢查以下項目來驗證雙堆疊端點組態：

如需其他支援和故障診斷，請參閱 AWS 文件或聯絡人 AWS。