URL: https://github.com/freeipa/freeipa/pull/520 Author: pvoborni Title: #520: Change README to use Markdown Action: opened
PR body: """ So that it will be nicely formatted on FreeIPA Pagure landing page. https://pagure.io/freeipa Some links were updated as other projects also moved to Pagure.io. Temporary preview on: https://pagure.io/pvoborni-test """ To pull the PR as Git branch: git remote add ghfreeipa https://github.com/freeipa/freeipa git fetch ghfreeipa pull/520/head:pr520 git checkout pr520
From 773512bcacfac3b2847d952de81ede915eba841d Mon Sep 17 00:00:00 2001 From: Petr Vobornik <pvobo...@redhat.com> Date: Tue, 28 Feb 2017 19:04:03 +0100 Subject: [PATCH] Change README to use Markdown So that it will be nicely formatted on FreeIPA Pagure landing page. https://pagure.io/freeipa Some links were updated as other projects also moved to Pagure.io. --- README | 92 --------------------------------------------------------------- README.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 74 insertions(+), 92 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index ad5b081..0000000 --- a/README +++ /dev/null @@ -1,92 +0,0 @@ - - IPA Server - - 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 - - * PKI based on Dogtag project - http://pki.fedoraproject.org/wiki/PKI_Main_Page - - * Samba libraries for Active Directory integration - http://www.samba.org/ - - * DNS Server based on BIND and the Bind-DynDB-LDAP plugin - https://www.isc.org/software/bind - https://fedorahosted.org/bind-dyndb-ldap - - - Project Website - --------------- - - 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>. - - Quick Start - ----------- - - To get started quickly, start here: - <http://www.freeipa.org/page/Quick_Start_Guide> - - Licensing - --------- - - Please see the file called COPYING. - - Contacts - -------- - - * If you want to be informed about new code releases, bug fixes, - security fixes, general news and information about the IPA server - subscribe to the freeipa-announce mailing list at - <https://www.redhat.com/mailman/listinfo/freeipa-interest/>. - - * If you have a bug report please submit it at: - <https://bugzilla.redhat.com> - - * If you want to participate in actively developing IPA please - subscribe to the freeipa-devel mailing list at - <https://www.redhat.com/mailman/listinfo/freeipa-devel/> or join - us in IRC at irc://irc.freenode.net/freeipa diff --git a/README.md b/README.md new file mode 100644 index 0000000..1cbb49e --- /dev/null +++ b/README.md @@ -0,0 +1,74 @@ +FreeIPA Server +============== + +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](http://www.port389.org/) +* KDC - based on [MIT Kerberos](http://k5wiki.kerberos.org/wiki/Main_Page) + implementation +* PKI based on [Dogtag project](http://pki.fedoraproject.org/wiki/PKI_Main_Page) +* [Samba](http://www.samba.org/) libraries for Active Directory integration +* DNS Server based on [BIND](https://www.isc.org/software/bind) and the + [Bind-DynDB-LDAP plugin](https://pagure.io/bind-dyndb-ldap) + +## Project Website + +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 . + +## Quick Start + +To get started quickly, start here: +http://www.freeipa.org/page/Quick_Start_Guide + +## Licensing + +Please see the file called COPYING. + +## Contacts + +* If you want to be informed about new code releases, bug fixes, + security fixes, general news and information about the IPA server + subscribe to the freeipa-announce mailing list at + https://www.redhat.com/mailman/listinfo/freeipa-interest/ . +* If you have a bug report please submit it at: + https://pagure.io/freeipa/issues +* If you want to participate in actively developing IPA please + subscribe to the freeipa-devel mailing list at + https://www.redhat.com/mailman/listinfo/freeipa-devel/ or join + us in IRC at <irc://irc.freenode.net/freeipa>
-- Manage your subscription for the Freeipa-devel mailing list: https://www.redhat.com/mailman/listinfo/freeipa-devel Contribute to FreeIPA: http://www.freeipa.org/page/Contribute/Code