.. Reminder for header structure:        
  Parts (H1)          : #################### with overline
  Chapters (H2)       : ******************** with overline
  Sections (H3)       : ====================
  Subsections (H4)    : --------------------
  Subsubsections (H5) : ^^^^^^^^^^^^^^^^^^^^
  Paragraphs (H6)     : """""""""""""""""""""

.. |date| date::

.. meta::
  :description: Samba-AD documentation
  :keywords: Documentation, Homepage, Samba-AD, Tranquil IT

.. _samba_documentation_homepage:

.. Samba-AD documentation master file

######################
Samba-AD documentation
######################

.. figure:: images/logo_Tranquil_IT_entete.png
  :align: center 
  :scale: 50 %
  :target: https://www.tranquil.it/
  :alt: Tranquil IT logo

.. figure:: images/Samba.png
  :align: center
  :scale: 8 %
  :target: https://www.samba.org/
  :alt: Samba logo

Samba-AD is a GPLv3 licensed opensource software that reproduces the behavior of Microsoft Active Directory (2012R2 schemas and 2008R2 functional level).

Samba-AD allows to provision and manage an Active Directory domain:

* LDAP directory;

* DNS name service;

* NTP time synchronization service;

* Transparent Kerberos based authentication;

* KDC token distribution service;

* Multi-AD replication;

* Security policies implemented with GPO;

.. note::

  The purpose of this theoretical presentation is not to provide an exhaustive documentation on LDAP, Kerberos or DNS protocols, but rather to provide the necessary clues for understanding and analyzing the working and the behavior of an Active Directory server that is implemented using Samba.

.. toctree::
  :maxdepth: 1
  :caption: Theoretical presentation of Samba-AD

  samba_fundamentals/samba_history.rst
  samba_fundamentals/about_services_index.rst
  samba_fundamentals/samba_release_notes.rst

.. toctree::
  :maxdepth: 2
  :caption: Installing and configuring Samba-AD
  
  samba_fundamentals/samba_server_dimensionning.rst
  samba_config_server/samba_conf_index.rst

.. toctree::
  :maxdepth: 1
  :caption: Securing Samba-AD

  samba_advanced_methods/samba_advanced_methods.rst

.. toctree::
  :maxdepth: 2
  :caption: Configuring AD clients

  samba_advanced_methods/samba_and_msad_integration.rst
  samba_fileserver/fileserver_index.rst
  samba_config_client/conf_client_index.rst

.. toctree::
  :maxdepth: 2
  :caption: Additional readings

  samba_advanced_methods/samba_migrate_from_samba3_to_samba-ad.rst
  samba_advanced_methods/samba_tis_sysvolsync.rst
  samba_advanced_methods/samba_recover_ad_from_crash.rst
  samba_advanced_methods/samba_python_samdb.rst

####################
Additional resources
####################

.. toctree::
  :maxdepth: 1

  samba_config_server/samba_active_directory_conf.rst
  samba_config_server/samba_install_compile.rst
  samba_config_server/samba_common_errors.rst
  samba_config_server/samba_transfer_samba3NT4_to_new_host.rst

.. toctree::
  :maxdepth: 1
  :caption: Additional resources

  samba_glossary.rst
  contact_tranquil_it.rst
  additional_links.rst
  security.rst