Skip to contentSkip to conversation

Document man agent-external-key

PATCH In review Arne Schwabe 2 participants 2 messages Oct 1, 2012 – Oct 15, 2012

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Document man agent-external-key

Adapt commit message from cf69617bbea45a15423c4188daa9386debcbe1ec for man page and management documentation.

---
 doc/management-notes.txt |   28 ++++++++++++++++++++++++++++
 doc/openvpn.8            |    5 +++++
 2 files changed, 33 insertions(+)
doc/management-notes.txt +28 -0
index a07a514..0d718e7 100644
@@ -750,6 +750,34 @@ To accept connecting to the host and port directly, use this command:
 
   proxy NONE
 
+COMMAND -- rsa-sig (OpenVPN 2.3 or higher)
+------------------------------------------
+Provides support for external storage of the private key. Requires the
+--management-external-key option. This option can be used instead of "key"
+in client mode, and allows the client to run without the need to load the
+actual private key. When the SSL protocol needs to perform an RSA sign 
+operation, the data to be signed will be sent to the management interface 
+via a notification as follows:
+
+>RSA_SIGN:[BASE64_DATA]
+
+The management interface client should then sign BASE64_DATA
+using the private key and return the SSL signature as follows:
+
+rsa-sig
+[BASE64_SIG_LINE]
+.
+.
+.
+END
+
+Base64 encoded output of RSA_sign(NID_md5_sha1,... will provide a 
+correct signature.
+
+This capability is intended to allow the use of arbitrarycryptographic 
+service providers with OpenVPN via the management interface.
+
+
 OUTPUT FORMAT
 -------------
 
doc/openvpn.8 +5 -0
index da1c0f9..6a408ed 100644
@@ -2464,6 +2464,11 @@ Allow management interface to override
 .B \-\-remote
 directives (client-only).
 .\"*********************************************************
+.B \-\-management-external-key
+Allows usage for external private key file instead of 
+.B \-\-key
+option (client-only).
+.\"*********************************************************
 .TP
 .B \-\-management-forget-disconnect
 Make OpenVPN forget passwords when management session
Signature · 1 line
1.7.9.5
#1 lore raw
Quoted 7 lines · Arne Schwabe

Adapt commit message from cf69617bbea45a15423c4188daa9386debcbe1ec for man page and management documentation.

---
 doc/management-notes.txt |   28 ++++++++++++++++++++++++++++
 doc/openvpn.8            |    5 +++++
 2 files changed, 33 insertions(+)

ACK. Applied to master and beta/2.3 branches.

commit 75b6f4bd84302d225a301f4ed87e2bb27908b972 (master) commit 7ab52ad0011f7ff3502d30abc718a9257d5f3916 (beta/2.3)

Author: Arne Schwabe <[email protected]...>
Date:   Mon Oct 1 11:05:18 2012 +0200
    Document man agent-external-key

    Signed-off-by: Arne Schwabe <[email protected]...>
    Acked-by: David Sommerseth <[email protected]...>
    Message-Id: [email protected]...
    URL: http://article.gmane.org/gmane.network.openvpn.devel/7081
    Signed-off-by: David Sommerseth <[email protected]...>

kind regards,

David Sommerseth