mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2025-02-25 18:55:28 -06:00
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. Reviewed-By: Stanislav Laznicka <slaznick@redhat.com>
This commit is contained in:
parent
9e24918c89
commit
5e0ca17ca0
@ -39,6 +39,7 @@ EXTRA_DIST = .mailmap \
|
||||
API.txt \
|
||||
BUILD.txt \
|
||||
config.rpath \
|
||||
README.md \
|
||||
Contributors.txt \
|
||||
COPYING.openssl \
|
||||
contrib \
|
||||
|
92
README
92
README
@ -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
|
73
README.md
Normal file
73
README.md
Normal file
@ -0,0 +1,73 @@
|
||||
# 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>
|
@ -1099,7 +1099,7 @@ fi
|
||||
|
||||
%files server
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{_sbindir}/ipa-backup
|
||||
%{_sbindir}/ipa-restore
|
||||
@ -1187,7 +1187,7 @@ fi
|
||||
|
||||
%files -n python2-ipaserver
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{python2_sitelib}/ipaserver
|
||||
%{python2_sitelib}/ipaserver-*.egg-info
|
||||
@ -1197,7 +1197,7 @@ fi
|
||||
|
||||
%files -n python3-ipaserver
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{python3_sitelib}/ipaserver
|
||||
%{python3_sitelib}/ipaserver-*.egg-info
|
||||
@ -1207,7 +1207,7 @@ fi
|
||||
|
||||
%files server-common
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%ghost %verify(not owner group) %dir %{_sharedstatedir}/kdcproxy
|
||||
%dir %attr(0755,root,root) %{_sysconfdir}/ipa/kdcproxy
|
||||
@ -1309,7 +1309,7 @@ fi
|
||||
|
||||
%files server-dns
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{_sbindir}/ipa-dns-install
|
||||
%{_mandir}/man1/ipa-dns-install.1*
|
||||
@ -1317,7 +1317,7 @@ fi
|
||||
|
||||
%files server-trust-ad
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{_sbindir}/ipa-adtrust-install
|
||||
%{_usr}/share/ipa/smb.conf.empty
|
||||
@ -1333,7 +1333,7 @@ fi
|
||||
|
||||
%files client
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{_sbindir}/ipa-client-install
|
||||
%{_sbindir}/ipa-client-automount
|
||||
@ -1354,7 +1354,7 @@ fi
|
||||
|
||||
%files -n python2-ipaclient
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%dir %{python_sitelib}/ipaclient
|
||||
%{python_sitelib}/ipaclient/*.py*
|
||||
@ -1369,7 +1369,7 @@ fi
|
||||
|
||||
%files -n python3-ipaclient
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%dir %{python3_sitelib}/ipaclient
|
||||
%{python3_sitelib}/ipaclient/*.py
|
||||
@ -1389,7 +1389,7 @@ fi
|
||||
|
||||
%files client-common
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%dir %attr(0755,root,root) %{_sysconfdir}/ipa/
|
||||
%ghost %attr(0644,root,apache) %config(noreplace) %{_sysconfdir}/ipa/default.conf
|
||||
@ -1408,13 +1408,13 @@ fi
|
||||
|
||||
%files python-compat
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
|
||||
|
||||
%files -n python2-ipalib
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%dir %{python_sitelib}/ipapython
|
||||
%{python_sitelib}/ipapython/*.py*
|
||||
@ -1433,7 +1433,7 @@ fi
|
||||
|
||||
%files common -f %{gettext_domain}.lang
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
|
||||
|
||||
@ -1441,7 +1441,7 @@ fi
|
||||
|
||||
%files -n python3-ipalib
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
|
||||
%{python3_sitelib}/ipapython/
|
||||
@ -1458,7 +1458,7 @@ fi
|
||||
|
||||
%files -n python2-ipatests
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{python_sitelib}/ipatests
|
||||
%{python_sitelib}/ipatests-*.egg-info
|
||||
@ -1479,7 +1479,7 @@ fi
|
||||
|
||||
%files -n python3-ipatests
|
||||
%defattr(-,root,root,-)
|
||||
%doc README Contributors.txt
|
||||
%doc README.md Contributors.txt
|
||||
%license COPYING
|
||||
%{python3_sitelib}/ipatests
|
||||
%{python3_sitelib}/ipatests-*.egg-info
|
||||
|
Loading…
Reference in New Issue
Block a user