From 18653e0506995ec4bbe76aca83632f02db7c8f1d Mon Sep 17 00:00:00 2001
From: Richard Frith-Macdonald
If the EcControlKey user default (treated as a boolean) is true,
- The Control server requires manual entry of a key from the
- terminal and makes the string entered (leading and trailing
- white space stripped) available as EcControlKey in the configuration
- information it gives to other processes.
+
If the EcControlKey NSUserDefault (32 hex digits) is set when the
+ Control server is started, it must also be set to the same value
+ in Control.plist, and on startup the Control server then requires
+ manual entry of a key from the terminal (and makes the string
+ entered (leading and trailing white space stripped) available as
+ EcControlKey in the configuration information it gives to other
+ processes.
This for instance allows all processes in a cluster to use a single
- encryption key never stored on disk.
+ encryption key never stored on disk.
+ The value of EcControlKey in Control.plist must be the MD5 hash of
+ the value entered as the master key, otherwise the Control server
+ will log a warning and shut down.
+ For purposes of automated testing only, Control.plist may contain
+ the master key (64 hex digits) in EcControlKeyTest. In this case
+ EcControlKey need not be defined as an NSUserDefault (because the
+ Control server does not need to read the master key from the
+ terminal).