Merge pull request #1551 from DOCGroup/plm_jira_333
[ACE_TAO.git] / TAO / orbsvcs / DevGuideExamples / Security / ParticipatingApp / README
blobfdde775fa584866c585bda07e61ef861bc805cfd
3 TAO Security
5 DevGuideExamples/Security/ParticipatingApp/README
7 This directory contains an illustration of a security
8 aware application that accepts secured and unsecured
9 requests and provides access to certain operations
10 only for secured requests.
12 This example uses a single set of service configuration
13 files and takes a single path through the application
14 code.
16 For simplicity, the pass phrases have been stripped from the
17 private keys included with these examples in the 1.2a release.
18 This *should not* be construed as a recommended practice.  Instead,
19 OCI strongly recommends that the security requirements of each
20 real-world application be evaluated carefully and that appropriate
21 procedures and practice be established accordingly.  Private keys
22 without pass phrase protection are easily compromised and may
23 allow an unauthorized party to masquerade as an authorized system
24 user.
26 Prior to running the server in these examples, the SSL_CERT_FILE
27 environment variable must be set, e.g.,
28         # /bin/bash
29         export SSL_CERT_FILE=cacert.pem
31         rem Windows
32         set SSL_CERT_FILE=cacert.pem
34 To run the server:
35         ./MessengerServer -ORBSvcConf server.conf
37 To run the client:
38         ./MessengerClient -ORBSvcConf client.conf
41 -----------------------------------------
42 Files: DevGuideExamples/Security/ParticipatingApp
44 Messenger.idl           - Messenger interface definition.
45 Messenger_i.h           - Messenger servant class definition.
46 Messenger_i.cpp         - Messenger servant implementation.
47 MessengerServer.cpp     - MessengerServer process main.
48 MessengerClient.cpp     - MessengerClient process main.