summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorNathan Kinder <nkinder@redhat.com>2014-05-09 16:12:31 -0700
committerSimo Sorce <simo@redhat.com>2014-05-10 09:56:23 -0400
commit493384f04be7f5615a2344ca896028837bfaa3a4 (patch)
treeb7627f0ff0b0cb0c9aa636c6b445639c93c848b5 /README
parent380b732e853b71d3a682a6189f8833c59b5e78d3 (diff)
downloadipsilon-493384f04be7f5615a2344ca896028837bfaa3a4.tar.gz
ipsilon-493384f04be7f5615a2344ca896028837bfaa3a4.tar.xz
ipsilon-493384f04be7f5615a2344ca896028837bfaa3a4.zip
Add details on using a principal for the admin
When Ipsilon is being installed with IPA, one is most likely going to use Kerberos to login to Ipsilon as the administrator. We should call this out, as the default of 'admin' for the Ipsilon admin user will conflict with the IPA 'admin' user. You will be unable to create a local 'admin' user at this point, requiring you to modify the sqlite database directly to change the admin user to a full principal. I also corrected a typo and wrapped a line that was > 79 chars. Signed-off-by: Nathan Kinder <nkinder@redhat.com> Reviewed-by: Simo Sorce <simo@redhat.com>
Diffstat (limited to 'README')
-rw-r--r--README10
1 files changed, 8 insertions, 2 deletions
diff --git a/README b/README
index ae0c46f..dc4dae8 100644
--- a/README
+++ b/README
@@ -14,7 +14,8 @@ completely agnostic of what authentication infrastructure is being used.
Applications can currently use the SAML2[2] protocol to talk to the Ipsilon
identity provider, an application that uses SAML is called a Service Provider.
-Ipsilon uses the LASSO[3] libraries an Python bindings to implement SAML support.
+Ipsilon uses the LASSO[3] libraries and Python bindings to implement SAML
+support.
Ipsilon Server Installation
===========================
@@ -67,7 +68,12 @@ The install script expects to find the keytab in /etc/httpd/conf/http.keytab
NOTE: If you are installing Ipsilon in a FreeIPA[4] environment you can use the
--ipa switch to simplify the deployment. Using the --ipa switch will allow the
use of your IPA Kerberos administrative credentials to automatically provision
-a keytab for the HTTP service if one is not available yet.
+a keytab for the HTTP service if one is not available yet. You will likely
+want to use the --admin-user option to specify the full principal of the user
+who will administer Ipsilon. For example to use the FreeIPA admin user for
+the EXAMPLE.COM realm, you would use:
+
+ $ ipsilon-server-install --ipa --admin-user admin@EXAMPLE.COM
Once the script has successfully completed the installation, restart the Apache
HTTPD server to activate it.