.. 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
######################

.. raw:: html

   <style>
     #tranquilit_logo {
       width: 50% !important;
       height: auto !important;
       display: block;
       margin: 0 auto;
     }
   </style>

   <div id="tranquilit_logo_container">
     <a href="https://www.tranquil.it/" target="_blank" rel="noopener noreferrer">
       <img id="tranquilit_logo" src="_static/images/Logo_TranquilIT_RVB.svg" alt="Logo TranquilIT">
     </a>
   </div>

   <script>
     // Fonction pour basculer le logo
     function updateLogoBasedOnTheme() {
       const logo = document.getElementById('tranquilit_logo');
       const theme = document.body.getAttribute('data-theme');
       if (theme === 'dark' || theme === 'auto') {
         logo.src = '_static/images/Logo_TranquilIT_BLANC.svg';
       } else {
         logo.src = '_static/images/Logo_TranquilIT_RVB.svg';
       }
     }

     // Exécute au chargement
     updateLogoBasedOnTheme();

     // Surveille les changements de l'attribut data-theme
     const observer = new MutationObserver(function(mutations) {
       mutations.forEach(function(mutation) {
         if (mutation.type === 'attributes' && mutation.attributeName === 'data-theme') {
           updateLogoBasedOnTheme();
         }
       });
     });

     // Configure l'observateur
     observer.observe(document.body, {
       attributes: true
     });
   </script>

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

 
| 

*************
Main benefits
*************

|

Samba-AD is a GPLv3 licensed opensource software that reproduces the behavior of Microsoft Active Directory (2022 schemas and 2016 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.

|

**********************
Table Of Contents Tree
**********************

|

.. 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-advanced_features_of_Samba_Active_Directory.rst
  samba_advanced_methods-samba-AD_and_MS-AD.rst
  samba_advanced_methods-samba_raise_fl2016.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

.. toctree::
  :maxdepth: 1
  :caption: Additional ressources

  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
  samba_config_server-server_install_binddlz.rst

.. toctree:: 
  :maxdepth: 1
  :caption: Appendix

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