aboutsummaryrefslogtreecommitdiffstats
path: root/src/frontends/osx
diff options
context:
space:
mode:
authorMartin Willi <martin@revosec.ch>2014-12-16 17:14:38 +0100
committerMartin Willi <martin@revosec.ch>2014-12-17 16:54:28 +0100
commit7f82a8f34b4eecf8011716a3e57dee30227293fb (patch)
treece225fdd004fcd057eb139d2c221544c0c9b8bc0 /src/frontends/osx
parentdacd667c84525cf335e61c8000922ca68686a4b6 (diff)
downloadstrongswan-7f82a8f34b4eecf8011716a3e57dee30227293fb.tar.bz2
strongswan-7f82a8f34b4eecf8011716a3e57dee30227293fb.tar.xz
osx: Update the README with App related bits
Diffstat (limited to 'src/frontends/osx')
-rw-r--r--src/frontends/osx/README.md24
1 files changed, 15 insertions, 9 deletions
diff --git a/src/frontends/osx/README.md b/src/frontends/osx/README.md
index 8ad7e439f..9dfdeb224 100644
--- a/src/frontends/osx/README.md
+++ b/src/frontends/osx/README.md
@@ -4,8 +4,8 @@
The strongSwan OS X App consists of two components:
-* A frontend to configure and control connections
-* A privileged helper daemon, controlled using XPC, called charon-xpc
+* A frontend App to configure and control connections (under strongSwan)
+* A privileged helper daemon, controlled using XPC (under charon-xpc)
The privileged helper daemon gets installed automatically using SMJobBless
functionality on its first use, and gets started automatically by Launchd when
@@ -13,10 +13,10 @@ needed.
charon-xpc is a special build linking statically against strongSwan components.
-charon-xpc sources are not part of the official strongSwan distribution. Build
-the charon-xpc tarball with:
+charon-xpc and the App sources are currently not part of the official strongSwan
+distribution. Build the charon-xpc tarball with:
- git archive -o charon-xpc-$(grep AC_INIT configure.ac | \
+ git archive -o osx-sources-$(grep AC_INIT configure.ac | \
cut -d '[' -f3 | cut -d ']' -f1).tar.bz2 \
HEAD src/frontends/osx
@@ -25,7 +25,7 @@ the charon-xpc tarball with:
Before building the Xcode project, the strongSwan base tree must be built using
a monolithic and static build. This can be achieved on OS X by using:
- CFLAGS="-O2 -Wall -Wno-format -Wno-pointer-sign -Wno-deprecated-declarations" \
+ CFLAGS="-O2 -g -Wall -Wno-format -Wno-pointer-sign -Wno-deprecated-declarations" \
./configure --enable-monolithic --disable-shared --enable-static \
--disable-defaults \
--enable-openssl --enable-kernel-libipsec --enable-kernel-pfroute \
@@ -38,11 +38,17 @@ a monolithic and static build. This can be achieved on OS X by using:
followed by calling make (no need to make install).
Building charon-xpc using the Xcode project yields a single binary without
-any non OS X dependencies.
+any non OS X dependencies. The strongSwan target in the same project builds
+the App and integrates charon-xpc for the deployment.
Both charon-xpc and the App must be code-signed to allow the installation of
-the privileged helper. git-grep for "Joe Developer" to change the signing
-identity.
+the privileged helper. By default both targets use the _Developer ID: *_
+wildcard to use the first usable code signing identity. Both the App and
+charon-xpc require a hardcoded certificate subject under
+_strongSwan/strongSwan-Info.plist_ respectively
+_charon-xpc/charon-xpc-Info.plist_. Update the _org.strongswan.charon-xpc_
+_SMPrivilegedExecutables_ in the App and _SMAuthorizedClients_ in charon-xpc
+with your code signing certificate identity.
## XPC application protocol ##