From e6105df2c1206f20fe055c72dfcd2d5781c2704a Mon Sep 17 00:00:00 2001
From: USAMI Kenta <tadsan@zonu.me>
Date: Fri, 1 Nov 2024 00:17:12 +0900
Subject: [PATCH] Add caution about using the same DH params in
 openssl_dh_compute_key

https://github.com/php/doc-en/commit/296d45da275cca752dd920738fd119e55fbbde97
---
 reference/openssl/functions/openssl-dh-compute-key.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/reference/openssl/functions/openssl-dh-compute-key.xml b/reference/openssl/functions/openssl-dh-compute-key.xml
index 3b80aa9d19..fb484505a6 100644
--- a/reference/openssl/functions/openssl-dh-compute-key.xml
+++ b/reference/openssl/functions/openssl-dh-compute-key.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: satoruyoshida Status: ready -->
+<!-- EN-Revision: 296d45da275cca752dd920738fd119e55fbbde97 Maintainer: satoruyoshida Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.openssl-dh-compute-key" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -20,6 +20,12 @@
    リモート側と秘密の通信をするための暗号鍵としてよく使われます。
    これはディフィー・ヘルマン鍵共有として知られています。
   </para>
+  <caution>
+   <para>
+    リモートとローカルのキーペアに同じ DH パラメータを使用することが重要です。
+    そうしないと、両者の間で生成されたシークレットが一致しなくなります。
+   </para>
+  </caution>
   <note>
    <simpara>
     ECDH は、PHP 8.1.0 以降、<emphasis>かつ</emphasis>