****************************************************************************************************
*      ______                                                  _                       _           *
*     |  ____|                                           /\   (_)                     | |          *
*     | |__  _   _ _ __ ___  _ __   ___  __ _ _ __      /  \   _ _ __ _ __   ___  _ __| |_ ___     *
*     |  __|| | | | '__/ _ \| '_ \ / _ \/ _` | '_ \    / /\ \ | | '__| '_ \ / _ \| '__| __/ __|    *
*     | |___| |_| | | | (_) | |_) |  __/ (_| | | | |  / ____ \| | |  | |_) | (_) | |  | |_\__ \    *
*     |______\__,_|_|  \___/| .__/ \___|\__,_|_| |_| /_/    \_\_|_|  | .__/ \___/|_|   \__|___/    *
*                           | |                                      | |                           *
*                           |_|                                      |_|                           *
*                                                                                                  *
****************************************************************************************************

This file is part of the European Airports Project, a free, collaborative platform of airport data 
extending beyond the official AIPs.

Copyright (C) 2023

Florian Meissner <florianmeissner@gmx.de>

This program is free software: you can redistribute it and/or modify it under the 
terms of the GNU General Public License as published by the Free Software Foundation, either 
version 3 of the License, or (at your option) any later version. This program is distributed in the 
hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
details. You should have received a copy of the GNU General Public License along with this program. 
(license.md in the root folder of this project) If not, see <http://www.gnu.org/licenses/>.


# MariaDB Secrets folder

This folder contains the secrets files with the user credentials for the MariaDB server.

You can rename the *.txt.example files into just *.txt and place your user name or password directly 
into them. Each file must only hold one data entry and nothing else! The hole content of the file 
will be interpreted as user name / password.


## What files are there?

For each user there are up to four files in this folder. Each file starts with a common base string, 
followed by an underscore and the kind of value it holds. All files with the same base are assumed 
to belonging to the same user.

The following file must/might exist:

- `*_name.txt`          The user name (required)
- `*_pw.txt`            The user's password (required)
- `*_grantTable.txt`    The tables on which privileges should be granted. If missing or empty, it 
                        defaults to `*.*`. (Optional)
- `*_privileges.txt`    The privileges that should be granted on the table. If missing or empty, it
                        defaults to `ALL PRIVILEGES`. (Optional)


## Additonal steps

For each user, remember to mount the secrets in the `docker-compose.yml` and at a line to the bottom 
of `init/01-mysql_user.sql`. See that file for details.