diff --git a/doc/certificates.md b/doc/certificates.md new file mode 100644 index 0000000..6bcf049 --- /dev/null +++ b/doc/certificates.md @@ -0,0 +1,68 @@ +# Généré des certificats via la PKI interne de mini_risotto + +## Génération des certificates sur le serveur + +Création la variable contenant la chain : + +``` + + +``` + +Création d'une autorité avec le nom "AuthorityName" (le nom est un terme en CamelCase) : + +``` + + server_name + server_name + AuthorityName + service_chain + +``` + +La création du fichier de CA est simple, il suffit d'utiliser la variable "service_ca_chain". + +Puis il faut créer le certificat avec un template qui contient : + +``` +%%get_certificate(%%domain_name_eth0, authority_name="AuthorityName") +``` + +Si l'autorité n'est pas gérer par le serveur courant, il faut précicer le nom du serveur responsable de l'autorité : + +``` +%%get_certificate(%%domain_name_eth0, authority_cn=%%server, authority_name="AuthorityName") +``` + +Enfin, le certificat peut avoir plusieurs nom de domaine, dans ce cas on peut le gérer par exemple en faisant : + +``` +%set %%extra_domainnames = [] +%for %%idx in %%range(1, %%number_of_interfaces) + %%extra_domainnames.append(%%getVar('domain_name_eth' + %%str(%%idx))) +%end for +%%get_certificate(%%domain_name_eth0, 'LDAP', extra_domainnames=%%extra_domainnames) +``` + +Enfin on peut récupérer la clef privée (attention APRÉS avoir récupérer le certificat) : + +``` +%get_private_key(%%domain_name_eth0, %%server) +``` + +Comme le certificat, l'autorité peut ne pas être de la responsabilité du serveur courant : + +``` +%get_private_key(%%domain_name_eth0, authority_cn=%%server, authority_name="ReverseProxy") +``` + +## PKI sous Fedora + +Création des fichiers pour l'autorité "AuthorityName" pour le service "service" : + +``` +/etc/pki/ca-trust/source/anchors/ca_AuthorityName.crt +/etc/pki/tls/certs/service.crt +/etc/pki/tls/private/service.key +``` diff --git a/doc/format.txt b/doc/format.txt new file mode 100644 index 0000000..80369c4 --- /dev/null +++ b/doc/format.txt @@ -0,0 +1,21 @@ +Modèle de serveur +================= + +name : nom du serveur modèle +description : description du serveur modèle +applicationservice : application service spécifique à ce serveur modèle +os_name : nom de l'image +os_version : version de l'image +iso : URL de téléchargement de l'image + +Service applicatif +================== + +format : numéro du format +name : nom du service applicatif +description: description du service applicatifs +depends : liste de dépendances vers d'autres service applicatifs +packages : liste de paquets logiciel a installé dans l'image +os : liste des "os_name" et "os_version" compatible avec ce service applicatif + + diff --git a/doc/link.md b/doc/link.md new file mode 100644 index 0000000..98b7d68 --- /dev/null +++ b/doc/link.md @@ -0,0 +1,177 @@ +# Configuration liée + +Une configuration liée est un ensemble d'élément partagé entre deux serveurs différents. + +## Lier un client à un serveur + +``` + + clients + service_variable + service_variable_2 + +``` + +## Lier un client à un serveur avec un nom d'utilisateur issu du nom de domaine + +Il faut commencer de créer une variable côté serveur : + +``` + +``` + +Le nom d'utilisateur sera ici le nom de domaine du serveur avec l'application de la fonction 'normalize_family'. + +Pour lier deux configurations il faut créer deux variables côté client : + +``` + +