summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPetr Viktorin <pviktori@redhat.com>2014-02-11 13:47:16 +0100
committerPetr Viktorin <pviktori@redhat.com>2014-02-12 14:04:07 +0100
commit70a495c58bc922468ad3844e4a0eae00a4aa6e7e (patch)
tree3208fef70f72f0600d70f19eee9430e072ec6f6f
parentbf7efaef9303820ebbc31c36adfdc9d2c08e89b1 (diff)
downloadfreeipa.git-70a495c58bc922468ad3844e4a0eae00a4aa6e7e.tar.gz
freeipa.git-70a495c58bc922468ad3844e4a0eae00a4aa6e7e.tar.xz
freeipa.git-70a495c58bc922468ad3844e4a0eae00a4aa6e7e.zip
Update README and BUILD
Update README with information from http://www.freeipa.org/page/Leaflet and fixed links. Update the list of dependencies in BUILD, and link to the Testing wiki page Reviewed-By: Martin Košek <mkosek@redhat.com>
-rw-r--r--BUILD.txt24
-rw-r--r--README78
2 files changed, 68 insertions, 34 deletions
diff --git a/BUILD.txt b/BUILD.txt
index a5a04ebc..62cbbd95 100644
--- a/BUILD.txt
+++ b/BUILD.txt
@@ -7,13 +7,19 @@ The quickest way to get the dependencies needed for building is:
# yum install rpm-build `grep "^BuildRequires" freeipa.spec.in | awk '{ print $2 }' | grep -v "^/"`
-This is currently (01/05/11):
-
-yum install 389-ds-base-devel mozldap-devel svrcore-devel nspr-devel \
-openssl-devel openldap-devel e2fsprogs-devel krb5-devel nss-devel \
-libcap-devel python-devel autoconf automake libtool popt-devel m4 \
-policycoreutils python-setuptools python-krbV xmlrpc-c-devel \
-libcurl-devel gettext authconfig libuuid-devel
+This is currently (2014-02-11):
+
+yum install rpm-build 389-ds-base-devel svrcore-devel policycoreutils \
+systemd-units samba-devel samba-python libwbclient-devel samba4-devel \
+samba4-python libtalloc-devel libtevent-devel nspr-devel nss-devel \
+openssl-devel openldap-devel krb5-devel krb5-workstation libuuid-devel \
+libcurl-devel xmlrpc-c-devel popt-devel autoconf automake m4 libtool gettext \
+python-devel python-ldap python-setuptools python-krbV python-nss \
+python-netaddr python-kerberos python-rhsm pyOpenSSL pylint python-polib \
+libipa_hbac-python python-memcached sssd python-lxml python-pyasn1 \
+python-qrcode python-dns m2crypto check libsss_idmap-devel \
+libsss_nss_idmap-devel java-1.7.0-openjdk libverto-devel systemd \
+libunistring-devel python-lesscpy
Building
--------
@@ -53,8 +59,10 @@ changes are required.
Testing
-------
+For more information, see http://www.freeipa.org/page/Testing
+
We use python nosetests to test for regressions in the management framework
-and plugins. You'll need the python-nose package installed to run the tests.
+and plugins. All test dependencies are required by the freeipa-tests package.
To run all of the tests you will need 2 sessions, one to run the lite-server
and the other to execute the tests. You'll also need a TGT before starting
diff --git a/README b/README
index 37614485..ad5b0811 100644
--- a/README
+++ b/README
@@ -1,48 +1,74 @@
IPA Server
- What is it?
- -----------
+ Overview
+ --------
+
+ FreeIPA allows Linux administrators to centrally manage identity,
+ authentication and access control aspects of Linux and UNIX systems
+ by providing simple to install and use command line and web based
+ managment tools.
+ FreeIPA is built on top of well known Open Source components and standard
+ protocols with a very strong focus on ease of management and automation
+ of installation and configuration tasks.
+ FreeIPA can seamlessly integrate into an Active Directory environment via
+ cross-realm Kerberos trust or user synchronization.
+
+ Benefits
+ --------
+
+ FreeIPA:
+ * Allows all your users to access all the machines with the same credentials
+ and security settings
+ * Allows users to access personal files transparently from any machine in
+ an authenticated and secure way
+ * Uses an advanced grouping mechanism to restrict network access to services
+ and files only to specific users
+ * Allows central management of security mechanisms like passwords,
+ SSH Public Keys, SUDO rules, Keytabs, Access Control Rules
+ * Enables delegation of selected administrative tasks to other power users
+ * Integrates into Active Directory environments
+
+ Components
+ ----------
+
+ The FreeIPA project provides unified installation and management
+ tools for the following components:
+
+ * LDAP Server - based on the 389 project (LDAP)
+ http://directory.fedoraproject.org/wiki/Main_Page
+
+ * KDC - based on MIT Kerberos implementation
+ http://k5wiki.kerberos.org/wiki/Main_Page
- For efficiency, compliance and risk mitigation, organizations need to
- centrally manage and correlate vital security information including:
+ * PKI based on Dogtag project
+ http://pki.fedoraproject.org/wiki/PKI_Main_Page
- * Identity (machine, user, virtual machines, groups, authentication
- credentials)
- * Policy (configuration settings, access control information)
- * Audit (events, logs, analysis thereof)
+ * Samba libraries for Active Directory integration
+ http://www.samba.org/
- Since these are not new problems. there exist many approaches and
- products focused on addressing them. However, these tend to have the
- following weaknesses:
+ * DNS Server based on BIND and the Bind-DynDB-LDAP plugin
+ https://www.isc.org/software/bind
+ https://fedorahosted.org/bind-dyndb-ldap
- * Focus on solving identity management across the enterprise has meant
- less focus on policy and audit.
- * Vendor focus on Web identity management problems has meant less well
- developed solutions for central management of the Linux and Unix
- world's vital security info. Organizations are forced to maintain
- a hodgepodge of internal and proprietary solutions at high TCO.
- * Proprietary security products don't easily provide access to the
- vital security information they collect or manage. This makes it
- difficult to synchronize and analyze effectively.
- The Latest Version
- ------------------
+ Project Website
+ ---------------
- Details of the latest version can be found on the IPA server project
- page under <http://www.freeipa.org/>.
+ Releases, announcements and other information can be found on the IPA
+ server project page at <http://www.freeipa.org/>.
Documentation
-------------
The most up-to-date documentation can be found at
- <http://freeipa.org/page/Documentation/>.
+ <http://freeipa.org/page/Documentation>.
Quick Start
-----------
To get started quickly, start here:
- <https://fedorahosted.org/freeipa/wiki/QuickStartGuide>
+ <http://www.freeipa.org/page/Quick_Start_Guide>
Licensing
---------