etude envole 9

This commit is contained in:
afornerot 2023-11-17 11:17:28 +01:00
parent a6f4949e1e
commit 1ce4847113
27 changed files with 815 additions and 25 deletions

View File

@ -1,13 +1,13 @@
{ {
"markdown-pdf.stylesRelativePathFile": true, "markdown-pdf.stylesRelativePathFile": true,
"markdown-pdf.styles": [ "markdown-pdf.styles": [
"./misc/tools/cadoles_theme.css" "tools/cadoles_theme.css"
], ],
"markdown-pdf.breaks": true, "markdown-pdf.breaks": true,
"markdown-pdf.outputDirectory": "./", "markdown-pdf.outputDirectory": "./",
"markdown.extension.toc.levels": "2..6", "markdown.extension.toc.levels": "2..6",
"markdown-pdf.outputDirectoryRelativePathFile": true, "markdown-pdf.outputDirectoryRelativePathFile": true,
"markdown-pdf.headerTemplate": "<div style=\"font-size: 9px; margin-left: 1cm;\">SHELA</div> <div style=\"font-size: 9px; margin-left: auto; margin-right: 1cm; \"> Cadoles - <span class='date'></span></div>", "markdown-pdf.headerTemplate": "<div style=\"font-size: 9px; margin-left: 1cm;\">Envole</div> <div style=\"font-size: 9px; margin-left: auto; margin-right: 1cm; \"> Cadoles - <span class='date'></span></div>",
"esbonio.sphinx.confDir": "", "esbonio.sphinx.confDir": "",
"markdown-pdf.convertOnSave": true, "markdown-pdf.convertOnSave": true,
"markdown-pdf.type": ["pdf","html"], "markdown-pdf.type": ["pdf","html"],

View File

@ -353,7 +353,7 @@ code {
} }
</style> </style>
<link rel="stylesheet" href="file:///run/user/1000/gvfs/sftp%3Ahost%3Deolebase.ac-test.fr%2Cuser%3Droot/root/git/envole/src/envole-1.0/doc/misc/tools/cadoles_theme.css" type="text/css"> <link rel="stylesheet" href="file:///home/afornerot/cadoles/envole-project/doc/tools/cadoles_theme.css" type="text/css">
<script src="https://unpkg.com/mermaid/dist/mermaid.min.js"></script> <script src="https://unpkg.com/mermaid/dist/mermaid.min.js"></script>
</head> </head>
<body> <body>
@ -365,8 +365,13 @@ code {
: 'default' : 'default'
}); });
</script> </script>
<h1 id="envole">Envole</h1> <div class="title">
<h2 id="introduction">Introduction</h2> <p><img src="./tools/logo.png" alt="logo"></p>
</div>
<div class="title">
<p>POC Envole</p>
</div>
<h1 id="introduction">Introduction</h1>
<p>Envole est une solution qui propose un ensemble d'applicatifs web fédérés autour d'un annaire afin de gérer l'identité ainsi qu'un SSO afin de gérer l'authentification.</p> <p>Envole est une solution qui propose un ensemble d'applicatifs web fédérés autour d'un annaire afin de gérer l'identité ainsi qu'un SSO afin de gérer l'authentification.</p>
<p>Il s'appuit sur la distrution EOLE pour déployer ses différents composants.</p> <p>Il s'appuit sur la distrution EOLE pour déployer ses différents composants.</p>
<p>Envole rencontre depuis des années des problèmatiques :</p> <p>Envole rencontre depuis des années des problèmatiques :</p>
@ -377,8 +382,8 @@ code {
<li>Ou qui empéche le passage d'une application de fonctionner dans une version x d'eole car cette dernière propose une version trop résente de php pour l'application</li> <li>Ou qui empéche le passage d'une application de fonctionner dans une version x d'eole car cette dernière propose une version trop résente de php pour l'application</li>
</ul> </ul>
<p>Ce document va chercher à évaluer la possibilité de conteneriser les applications Envole, afin qu'elles puissent fonctionner le moins possible en contrainte avec la version d'Eole</p> <p>Ce document va chercher à évaluer la possibilité de conteneriser les applications Envole, afin qu'elles puissent fonctionner le moins possible en contrainte avec la version d'Eole</p>
<h2 id="architecture">Architecture</h2> <h1 id="architecture">Architecture</h1>
<h3 id="eolebase">EoleBase</h3> <h2 id="eolebase">EoleBase</h2>
<p>La présente étude part du principe qu'Envole ne serait plus installé sur une instance Scribe mais sur une installation EoleBase d'Eole</p> <p>La présente étude part du principe qu'Envole ne serait plus installé sur une instance Scribe mais sur une installation EoleBase d'Eole</p>
<p><strong>Avantages</strong></p> <p><strong>Avantages</strong></p>
<ul> <ul>
@ -399,7 +404,9 @@ code {
<li>Connaitre et renseigner les hosts/ports des service SSO et Annuaire</li> <li>Connaitre et renseigner les hosts/ports des service SSO et Annuaire</li>
<li>Avoir un second nom de domaine pour l'accès aux applications Envole</li> <li>Avoir un second nom de domaine pour l'accès aux applications Envole</li>
</ul> </ul>
<h3 id="paquet-debian">Paquet Debian</h3> <div class="page-break">
</div>
<h2 id="paquet-debian">Paquet Debian</h2>
<p>Contrairement à la précédente logique Envole, il n'y aurait qu'un seul paquet Debian pour Envole. Il n'installerait pas les sources des applications, mais uniquement</p> <p>Contrairement à la précédente logique Envole, il n'y aurait qu'un seul paquet Debian pour Envole. Il n'installerait pas les sources des applications, mais uniquement</p>
<ul> <ul>
<li>le dictionnaire eole de configuration</li> <li>le dictionnaire eole de configuration</li>
@ -407,9 +414,9 @@ code {
<li>le dossier de définitions de l'ensemble des conteneurs possible pour Envole</li> <li>le dossier de définitions de l'ensemble des conteneurs possible pour Envole</li>
<li>un script qui viendrait monter ou non les conteneurs souhaités par l'administateur</li> <li>un script qui viendrait monter ou non les conteneurs souhaités par l'administateur</li>
</ul> </ul>
<h3 id="poc">POC</h3> <h2 id="poc">POC</h2>
<p>Afin de s'assurer de la faisabilité d'un tel changement, un POC a été initié, dans le cadre des éléments précédents cités. La première question fut de savoir quelle technologie de conteneurisation serait à utiliser PODMAN ou DOCKER, et dans leur logique de composer PODMAN-COMPOSE ou DOCKER-COMPOSER.</p> <p>Afin de s'assurer de la faisabilité d'un tel changement, un POC a été initié, dans le cadre des éléments précédents cités. La première question fut de savoir quelle technologie de conteneurisation serait à utiliser PODMAN ou DOCKER, et dans leur logique de composer PODMAN-COMPOSE ou DOCKER-COMPOSER.</p>
<h3 id="podman-vs-docker-sur-eole">PODMAN vs DOCKER sur Eole</h3> <h2 id="podman-vs-docker-sur-eole">PODMAN vs DOCKER sur Eole</h2>
<p><strong>PODMAN</strong></p> <p><strong>PODMAN</strong></p>
<p>Eole a intégré à partir de la 2.9 dans sa distribution podman. Ce qui de prime abord devrait-être la technologie à utiliser, sauf que</p> <p>Eole a intégré à partir de la 2.9 dans sa distribution podman. Ce qui de prime abord devrait-être la technologie à utiliser, sauf que</p>
<ul> <ul>
@ -428,6 +435,8 @@ code {
<li>Par la suite docker se comporte bien mieux que podman. Il est plus souple d'usage, moins verbeux</li> <li>Par la suite docker se comporte bien mieux que podman. Il est plus souple d'usage, moins verbeux</li>
<li>Mais tout comme podman, un reconfigure vient rendre totalement inopérant le reseau des conteneurs. Il est nécessaire de réinitialiser docker-ce pour rétablir le reseau.</li> <li>Mais tout comme podman, un reconfigure vient rendre totalement inopérant le reseau des conteneurs. Il est nécessaire de réinitialiser docker-ce pour rétablir le reseau.</li>
</ul> </ul>
<div class="page-break">
</div>
<p><strong>CONCLUSION</strong></p> <p><strong>CONCLUSION</strong></p>
<p>Quoi qu'il arrive, une intégration compléte que cela soit avec Podman ou avec Docker, demandera un travail d'intégration d'Eole</p> <p>Quoi qu'il arrive, une intégration compléte que cela soit avec Podman ou avec Docker, demandera un travail d'intégration d'Eole</p>
<ul> <ul>
@ -435,15 +444,15 @@ code {
<li>que l'un ou l'autre ne détruit pas le réseau associé au composer de conteneur</li> <li>que l'un ou l'autre ne détruit pas le réseau associé au composer de conteneur</li>
</ul> </ul>
<p>Ma préférence va malgrés tout sur Docker, il est plus souple moins verbeux et me semble plus fiable à long terme. Il serait possible de maitenir les deux solutions en parrallèle avec un effort supplémentaire d'intégration et de maintenance.</p> <p>Ma préférence va malgrés tout sur Docker, il est plus souple moins verbeux et me semble plus fiable à long terme. Il serait possible de maitenir les deux solutions en parrallèle avec un effort supplémentaire d'intégration et de maintenance.</p>
<h2 id="poc">POC</h2> <h1 id="poc">POC</h1>
<h3 id="sources">Sources</h3> <h2 id="sources">Sources</h2>
<p>Les sources du POC sont disponible ici<br> <p>Les sources du POC sont disponible ici<br>
https://forge.cadoles.com/Envole/envole</p> https://forge.cadoles.com/Envole/envole</p>
<p>Elles sont pour l'instant hébergé à Cadoles pour des raisons de simplicité de mise en oeuvre, mais à terme elles seront bien stockées chez Eole</p> <p>Elles sont pour l'instant hébergé à Cadoles pour des raisons de simplicité de mise en oeuvre, mais à terme elles seront bien stockées chez Eole</p>
<h3 id="repository">Repository</h3> <h2 id="repository">Repository</h2>
<p>Certaines images sont hébergées elles aussi sur un repository public de Cadoles. Là aussi pour des raisons de simplicité de mise en oevre, mais à terme Eole devra fournir un repository propre aux images Envole.</p> <p>Certaines images sont hébergées elles aussi sur un repository public de Cadoles. Là aussi pour des raisons de simplicité de mise en oevre, mais à terme Eole devra fournir un repository propre aux images Envole.</p>
<p>Les images en questions sont celles des applications maintenues par Envole, en l'occurence pour l'instant uniquement Ninegate. Mais à terme pourra aussi y figurer des images d'applications tiers sur lesquelles nous aurions besion d'altérer légèrement le comportement.</p> <p>Les images en questions sont celles des applications maintenues par Envole, en l'occurence pour l'instant uniquement Ninegate. Mais à terme pourra aussi y figurer des images d'applications tiers sur lesquelles nous aurions besion d'altérer légèrement le comportement.</p>
<h3 id="installation-du-poc">Installation du POC</h3> <h2 id="installation-du-poc">Installation du POC</h2>
<p>1- Instancier un eolebase 2.9</p> <p>1- Instancier un eolebase 2.9</p>
<p>2- Installer eole-web</p> <p>2- Installer eole-web</p>
<pre class="hljs"><code><div>apt-get install eole-web <pre class="hljs"><code><div>apt-get install eole-web
@ -455,6 +464,8 @@ Applications Web &gt; Nom de domaine des applications web = mondomaine.fr
save &amp; quit save &amp; quit
Reconfigure Reconfigure
</div></code></pre> </div></code></pre>
<div class="page-break">
</div>
<p>3- Installer docker &amp; docker-compose</p> <p>3- Installer docker &amp; docker-compose</p>
<pre class="hljs"><code><div>apt install git make apt-transport-https ca-certificates curl gnupg-agent software-properties-common <pre class="hljs"><code><div>apt install git make apt-transport-https ca-certificates curl gnupg-agent software-properties-common
mkdir -p /etc/apt/keyrings mkdir -p /etc/apt/keyrings
@ -474,6 +485,68 @@ cd /root/git/envole
make install make install
</div></code></pre> </div></code></pre>
<p>5- Configurer Envole</p> <p>5- Configurer Envole</p>
<p>Le dictionnaire d'Envole dans genconfig est initalisé pour que l'on y indique un scribe distant.</p>
<p>6- Reconfigure</p>
<div class="page-break">
</div>
<h1 id="compl%C3%A9ment-sur-variables-genconfig">Complément sur variables Genconfig</h1>
<div class="img60">
<p><img src="./img/genconfig.png" alt="genconfig"></p>
</div>
<div class="page-break">
</div>
<p><strong>Maître de l'identité</strong></p>
<ul>
<li><strong>SQL</strong> = c'est un cas bien particulier qui devrait pas vous concerner. C'est le cas où c'est Ninegate qui gére les utilisateurs et les groupes et qui va pousser ces informations dans un annuaire qui doit-être forcement local</li>
<li><strong>LDAP</strong> = c'est le cas classique d'un établissement scolaire. Ninegate synchronisera les utilisateurs et les groupes en fonction d'un annuaire distant. Cela pourrait-être aussi le cas d'usage d'un PIA qui a son propre annuaire. Tout dépendra du modèle d'annuaire déclaré dans le genconfig</li>
<li><strong>SSO</strong> = c'est le cas où il n'y a pas de synchronisation annuaire, mais que les applications se basent sur les attributs SSO pour autocreate et autoupdate les utilisateurs qui se connectent</li>
</ul>
<p><strong>Mode d'Authentification</strong><br>
Il n'y a que Ninegate qui pour l'instant peut faire varier son mode d'authentification<br>
A l'avenir on pourrait implémeter d'autre méthode d'authenfication, l'OPENID ou le SAML par exemple.</p>
<ul>
<li><strong>SQL</strong> = l'authentification se fait par le mécanisme interne à l'application. Pas de SSO dans ce cas.</li>
<li><strong>LDAP</strong> = l'authentification se fait via un bind sur l'annuaire. Pas de SSO dans ce cas.</li>
<li><strong>CAS</strong> = l'authentification se fait via le protocole CAS. Déclarer un serveur CAS dans ce cas est obligatoire. C'est le cas classique d'Envole à l'heure actuelle</li>
</ul>
<p><strong>Server CAS local</strong><br>
Si oui un conteneur Keycloak sera instancié qui sera préparamétré pour utiliser le procotole CAS en lien avec l'annuaire soit local soit distant déclaré dans le genconfig</p>
<p>ATTENTION = une foi instancié le serveur Keycloak ne prendra pas en compte des changement de paramétrage lié à l'annuaire</p>
<p><strong>Base de Données</strong><br>
Si désactivé, l'ensemble des applications nécessitant une base de données ne pourront être activée.</p>
<p>Si distant, Envole ne fera pas le travail de créer les utilisateurs de base de données ainsi que les bases de données applicatives en elles-même. Cela sera à la charge d'un administrateur de réaliser ces tâches.</p>
<p>ATTENTION = une foi instancié les changement de login/password d'accès à la BDD ne seront pas appliqués</p>
<p><strong>Annuaire</strong><br>
Le cas d'un annuaire local n'est utile que si le maître de l'authenfication est local.</p>
<p>ATTENTION = une foi instancié les changement de login/password d'accès à la BDD ne seront pas appliqués</p>
<p><strong>Secrets</strong><br>
L'ensemble des secrets nécessaires. Comme indiqué plus haut un grand nombre d'entre eux ne peuvent être modifié après instanciation du service associé au secret : BDD / Annuaire / Keycloak</p>
<p><strong>Nextcloud</strong><br>
Possiblité d'indiqué un partage Samba pour générer automatiquement un partage externe dans Nextcloud</p>
<div class="page-break">
</div>
<h1 id="conclusion">Conclusion</h1>
<p>Ce POC démontre qu'un modèle conteneriser d'Envole est tout à fait possible. Mais</p>
<p><strong>Ce que le POC à montrer comme problème</strong></p>
<ul>
<li>Des versions trop anciennes que cela soit sur Podman ou Docker</li>
<li>Un problème de variable d'environnement via Podman qui n'accepte pas de surcouche de variables</li>
<li>Des problèmatiques de réseau après reconfigure à résoudre par EOLE</li>
<li>Sur scribe29 : Nextcloud et Roundcube sont préinstallés. Si demain on souhaite mettre Envole sur scribe il faudra enlever cette dépendance.</li>
</ul>
<p><strong>Ce que ne fait pas le POC</strong></p>
<ul>
<li>Changer les secrets après instanciation</li>
<li>Changer la configuration Keycloak après instanciation</li>
</ul>
<p><strong>Ce que le POC n'a pas du tout aborder</strong></p>
<ul>
<li>Comment migrer de la version actuelle d'Envole vers ce modèle</li>
<li>Comment gérer la mise à jour des conteneurs (monté de version des applications)</li>
<li>Comment intégrer les scripts de synchronisation annuaire sur les applications qui n'ont pas de mécanisme interne (poshprofil)</li>
<li>Comment intégrer la sonde statistique</li>
<li>Comment envoyer du mail (service scribe imap/smtp CASsifié sur le scribe et très complexe à utiliser à distance)</li>
</ul>
</body> </body>
</html> </html>

View File

@ -1,6 +1,16 @@
# Envole
## Introduction ::: title
![logo](./tools/logo.png)
:::
::: title
POC Envole
:::
# Introduction
Envole est une solution qui propose un ensemble d'applicatifs web fédérés autour d'un annaire afin de gérer l'identité ainsi qu'un SSO afin de gérer l'authentification. Envole est une solution qui propose un ensemble d'applicatifs web fédérés autour d'un annaire afin de gérer l'identité ainsi qu'un SSO afin de gérer l'authentification.
@ -15,9 +25,9 @@ Envole rencontre depuis des années des problèmatiques :
Ce document va chercher à évaluer la possibilité de conteneriser les applications Envole, afin qu'elles puissent fonctionner le moins possible en contrainte avec la version d'Eole Ce document va chercher à évaluer la possibilité de conteneriser les applications Envole, afin qu'elles puissent fonctionner le moins possible en contrainte avec la version d'Eole
## Architecture # Architecture
### EoleBase ## EoleBase
La présente étude part du principe qu'Envole ne serait plus installé sur une instance Scribe mais sur une installation EoleBase d'Eole La présente étude part du principe qu'Envole ne serait plus installé sur une instance Scribe mais sur une installation EoleBase d'Eole
@ -36,7 +46,11 @@ La présente étude part du principe qu'Envole ne serait plus installé sur une
- Avoir un second nom de domaine pour l'accès aux applications Envole - Avoir un second nom de domaine pour l'accès aux applications Envole
### Paquet Debian ::: page-break
:::
## Paquet Debian
Contrairement à la précédente logique Envole, il n'y aurait qu'un seul paquet Debian pour Envole. Il n'installerait pas les sources des applications, mais uniquement Contrairement à la précédente logique Envole, il n'y aurait qu'un seul paquet Debian pour Envole. Il n'installerait pas les sources des applications, mais uniquement
@ -45,11 +59,11 @@ Contrairement à la précédente logique Envole, il n'y aurait qu'un seul paquet
- le dossier de définitions de l'ensemble des conteneurs possible pour Envole - le dossier de définitions de l'ensemble des conteneurs possible pour Envole
- un script qui viendrait monter ou non les conteneurs souhaités par l'administateur - un script qui viendrait monter ou non les conteneurs souhaités par l'administateur
### POC ## POC
Afin de s'assurer de la faisabilité d'un tel changement, un POC a été initié, dans le cadre des éléments précédents cités. La première question fut de savoir quelle technologie de conteneurisation serait à utiliser PODMAN ou DOCKER, et dans leur logique de composer PODMAN-COMPOSE ou DOCKER-COMPOSER. Afin de s'assurer de la faisabilité d'un tel changement, un POC a été initié, dans le cadre des éléments précédents cités. La première question fut de savoir quelle technologie de conteneurisation serait à utiliser PODMAN ou DOCKER, et dans leur logique de composer PODMAN-COMPOSE ou DOCKER-COMPOSER.
### PODMAN vs DOCKER sur Eole ## PODMAN vs DOCKER sur Eole
**PODMAN** **PODMAN**
@ -70,6 +84,10 @@ Eole n'a pas intégré nativement docker. Mais il est tout à fait possible de l
- Par la suite docker se comporte bien mieux que podman. Il est plus souple d'usage, moins verbeux - Par la suite docker se comporte bien mieux que podman. Il est plus souple d'usage, moins verbeux
- Mais tout comme podman, un reconfigure vient rendre totalement inopérant le reseau des conteneurs. Il est nécessaire de réinitialiser docker-ce pour rétablir le reseau. - Mais tout comme podman, un reconfigure vient rendre totalement inopérant le reseau des conteneurs. Il est nécessaire de réinitialiser docker-ce pour rétablir le reseau.
::: page-break
:::
**CONCLUSION** **CONCLUSION**
Quoi qu'il arrive, une intégration compléte que cela soit avec Podman ou avec Docker, demandera un travail d'intégration d'Eole Quoi qu'il arrive, une intégration compléte que cela soit avec Podman ou avec Docker, demandera un travail d'intégration d'Eole
@ -78,22 +96,22 @@ Quoi qu'il arrive, une intégration compléte que cela soit avec Podman ou avec
Ma préférence va malgrés tout sur Docker, il est plus souple moins verbeux et me semble plus fiable à long terme. Il serait possible de maitenir les deux solutions en parrallèle avec un effort supplémentaire d'intégration et de maintenance. Ma préférence va malgrés tout sur Docker, il est plus souple moins verbeux et me semble plus fiable à long terme. Il serait possible de maitenir les deux solutions en parrallèle avec un effort supplémentaire d'intégration et de maintenance.
## POC # POC
### Sources ## Sources
Les sources du POC sont disponible ici Les sources du POC sont disponible ici
https://forge.cadoles.com/Envole/envole https://forge.cadoles.com/Envole/envole
Elles sont pour l'instant hébergé à Cadoles pour des raisons de simplicité de mise en oeuvre, mais à terme elles seront bien stockées chez Eole Elles sont pour l'instant hébergé à Cadoles pour des raisons de simplicité de mise en oeuvre, mais à terme elles seront bien stockées chez Eole
### Repository ## Repository
Certaines images sont hébergées elles aussi sur un repository public de Cadoles. Là aussi pour des raisons de simplicité de mise en oevre, mais à terme Eole devra fournir un repository propre aux images Envole. Certaines images sont hébergées elles aussi sur un repository public de Cadoles. Là aussi pour des raisons de simplicité de mise en oevre, mais à terme Eole devra fournir un repository propre aux images Envole.
Les images en questions sont celles des applications maintenues par Envole, en l'occurence pour l'instant uniquement Ninegate. Mais à terme pourra aussi y figurer des images d'applications tiers sur lesquelles nous aurions besion d'altérer légèrement le comportement. Les images en questions sont celles des applications maintenues par Envole, en l'occurence pour l'instant uniquement Ninegate. Mais à terme pourra aussi y figurer des images d'applications tiers sur lesquelles nous aurions besion d'altérer légèrement le comportement.
### Installation du POC ## Installation du POC
1- Instancier un eolebase 2.9 1- Instancier un eolebase 2.9
@ -109,6 +127,10 @@ save & quit
Reconfigure Reconfigure
``` ```
::: page-break
:::
3- Installer docker & docker-compose 3- Installer docker & docker-compose
``` ```
apt install git make apt-transport-https ca-certificates curl gnupg-agent software-properties-common apt install git make apt-transport-https ca-certificates curl gnupg-agent software-properties-common
@ -134,6 +156,100 @@ make install
5- Configurer Envole 5- Configurer Envole
Le dictionnaire d'Envole dans genconfig est initalisé pour que l'on y indique un scribe distant.
6- Reconfigure
::: page-break
:::
# Complément sur variables Genconfig
::: img60
![genconfig](./img/genconfig.png)
:::
::: page-break
:::
**Maître de l'identité**
- **SQL** = c'est un cas bien particulier qui devrait pas vous concerner. C'est le cas où c'est Ninegate qui gére les utilisateurs et les groupes et qui va pousser ces informations dans un annuaire qui doit-être forcement local
- **LDAP** = c'est le cas classique d'un établissement scolaire. Ninegate synchronisera les utilisateurs et les groupes en fonction d'un annuaire distant. Cela pourrait-être aussi le cas d'usage d'un PIA qui a son propre annuaire. Tout dépendra du modèle d'annuaire déclaré dans le genconfig
- **SSO** = c'est le cas où il n'y a pas de synchronisation annuaire, mais que les applications se basent sur les attributs SSO pour autocreate et autoupdate les utilisateurs qui se connectent
**Mode d'Authentification**
Il n'y a que Ninegate qui pour l'instant peut faire varier son mode d'authentification
A l'avenir on pourrait implémeter d'autre méthode d'authenfication, l'OPENID ou le SAML par exemple.
- **SQL** = l'authentification se fait par le mécanisme interne à l'application. Pas de SSO dans ce cas.
- **LDAP** = l'authentification se fait via un bind sur l'annuaire. Pas de SSO dans ce cas.
- **CAS** = l'authentification se fait via le protocole CAS. Déclarer un serveur CAS dans ce cas est obligatoire. C'est le cas classique d'Envole à l'heure actuelle
**Server CAS local**
Si oui un conteneur Keycloak sera instancié qui sera préparamétré pour utiliser le procotole CAS en lien avec l'annuaire soit local soit distant déclaré dans le genconfig
ATTENTION = une foi instancié le serveur Keycloak ne prendra pas en compte des changement de paramétrage lié à l'annuaire
**Base de Données**
Si désactivé, l'ensemble des applications nécessitant une base de données ne pourront être activée.
Si distant, Envole ne fera pas le travail de créer les utilisateurs de base de données ainsi que les bases de données applicatives en elles-même. Cela sera à la charge d'un administrateur de réaliser ces tâches.
ATTENTION = une foi instancié les changement de login/password d'accès à la BDD ne seront pas appliqués
**Annuaire**
Le cas d'un annuaire local n'est utile que si le maître de l'authenfication est local.
ATTENTION = une foi instancié les changement de login/password d'accès à la BDD ne seront pas appliqués
**Secrets**
L'ensemble des secrets nécessaires. Comme indiqué plus haut un grand nombre d'entre eux ne peuvent être modifié après instanciation du service associé au secret : BDD / Annuaire / Keycloak
**Nextcloud**
Possiblité d'indiqué un partage Samba pour générer automatiquement un partage externe dans Nextcloud
::: page-break
:::
# Conclusion
Ce POC démontre qu'un modèle conteneriser d'Envole est tout à fait possible. Mais
**Ce que le POC à montrer comme problème**
- Des versions trop anciennes que cela soit sur Podman ou Docker
- Un problème de variable d'environnement via Podman qui n'accepte pas de surcouche de variables
- Des problèmatiques de réseau après reconfigure à résoudre par EOLE
- Sur scribe29 : Nextcloud et Roundcube sont préinstallés. Si demain on souhaite mettre Envole sur scribe il faudra enlever cette dépendance.
**Ce que ne fait pas le POC**
- Changer les secrets après instanciation
- Changer la configuration Keycloak après instanciation
**Ce que le POC n'a pas du tout aborder**
- Comment migrer de la version actuelle d'Envole vers ce modèle
- Comment gérer la mise à jour des conteneurs (monté de version des applications)
- Comment intégrer les scripts de synchronisation annuaire sur les applications qui n'ont pas de mécanisme interne (poshprofil)
- Comment intégrer la sonde statistique
- Comment envoyer du mail (service scribe imap/smtp CASsifié sur le scribe et très complexe à utiliser à distance)

Binary file not shown.

BIN
doc/img/genconfig.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 MiB

143
doc/tools/cadoles_theme.css Normal file
View File

@ -0,0 +1,143 @@
@font-face {
font-family: "Roboto";
src: url("fonts/Roboto/Roboto-Regular.ttf") format('truetype');
}
@font-face {
font-family: "Theboldefont";
src: url("fonts/Theboldfont/THE BOLD FONT - FREE VERSION - 2023.ttf") format('truetype');
}
body {
font-family: "Roboto" !important;
color: #333;
max-width: 1200px;
margin: auto;
}
.title {
color: #078eb5;
text-transform: uppercase;
font-size: 3em;
margin-top:30px;
text-align: center;
line-height: 1em;
font-weight: bold;
font-family: "Theboldefont" !important;
}
.title img {
width: 80%;
}
h1, h2, h3 {
font-family: "Theboldefont" !important;
}
h1 {
text-transform: uppercase;
page-break-before: always;
}
h2 {
text-transform: uppercase;
text-decoration: underline;
}
h3 {
text-decoration: underline;
}
a, a:hover, a:visited , h1, h2, h3, h4, h5, h6 {
color: #078eb5;
font-weight: bold
}
img {
max-width:100%;
margin:auto;
display: block;
text-align:center;
}
.center {
text-align: center;
}
strong {
color: #078eb5;
}
footer img {
width: 32px;
}
.info,
.success,
.warning,
.danger {
padding: 1rem;
margin-bottom: 1rem;
}
.info {
background-color: rgba(41, 128, 185, .1);
border-left: solid 4px rgba(41, 128, 185,1.0);
color: rgba(41, 128, 185,1.0);
}
.success {
background-color: rgba(39, 174, 96, .1);
border-left: solid 4px rgba(39, 174, 96,1.0);
color:rgba(39, 174, 96,1.0);
}
.warning {
padding: 1rem;
background-color: rgba(243, 156, 18, .1);
border-left: solid 4px #f39c12;
color: #f39c12;
}
.danger {
background-color: rgba(231, 76, 60, .1);
border-left: solid 4px rgba(231, 76, 60,1.0);
color: rgba(231, 76, 60,1.0);
}
.page-break {
page-break-after: always;
}
.center {
text-align: center;
}
table {
width:100%;
}
table > thead > tr > th {
border: 1px solid;
text-align:center;
}
table > tbody > tr > td {
border: 1px solid;
}
.matriceresponsabilites {
text-align:center;
font-size: 10px;
}
.matriceresponsabilites td:nth-child(2) {
text-align:left;
}
.matriceresponsabilites td {
padding: 2px;
}
.img50 {margin:auto; width:50%}
.img60 {margin:auto; width:60%}

186
doc/tools/e-ihm.sh Executable file
View File

@ -0,0 +1,186 @@
#!/bin/bash
TPUT=/usr/bin/tput
#test si TPUT est utilisable
if [ ! "$TERM" = "" ] && $TPUT hpa 60 >/dev/null 2>&1 && $TPUT setaf 1 >/dev/null 2>&1; then
FANCYTTY=1
else
FANCYTTY=0
fi
Pause() {
if [ "$ModeTxt" == "yes" ];then
echo
elif [ "$ModeEad" == "yes" ];then
echo "<br>"
else
[ $FANCYTTY = 1 ] && $TPUT setaf 6
echo " Appuyez sur Entrée pour continuer ..."
[ $FANCYTTY = 1 ] && $TPUT sgr0
read BiDon
fi
}
Echo() {
if [ "$ModeEad" != "yes" ];
then
echo "$1"
else
echo "$1<br>"
fi
}
EchoColor() {
if [ "$ModeTxt" = "yes" ];then
echo "$1"
elif [ "$ModeEad" = "yes" ];then
echo "<FONT color=\"$3\"> $1 </FONT><br>"
else
[ "$FANCYTTY" = 1 ] && $TPUT setaf $2
echo "$1"
[ "$FANCYTTY" = 1 ] && $TPUT sgr0
fi
}
EchoRouge() {
EchoColor "$1" "1" "red"
}
EchoVert() {
EchoColor "$1" "2" "green"
}
EchoOrange() {
EchoColor "$1" "3" "orange"
}
EchoBleu() {
EchoColor "$1" "4" "blue"
}
EchoMagenta() {
EchoColor "$1" "5" "magenta"
}
EchoCyan() {
EchoColor "$1" "6" "cyan"
}
EchoBlanc() {
EchoColor "$1" "7" "white"
}
EchoGras() {
if [ "$ModeTxt" == "yes" ];then
echo "$1"
elif [ "$ModeEad" == "yes" ];then
echo "<b> $1 </b><br>"
else
[ $FANCYTTY = 1 ] && $TPUT bold
echo "$1"
[ $FANCYTTY = 1 ] && $TPUT sgr0
fi
}
Clear() {
if [ "$ModeEad" != "yes" -a "$ModeTxt" != "yes" ];then
clear
fi
}
Question_ouinon() {
#attention, il faut synchroniser les modifications avec /usr/share/pyshared/pyeole/ihm.py
question=$1
[ "$2" = "" ] && interactive='True' || interactive=$2
[ "$3" = "" ] && default="non" || default=$3
[ "$4" = "" ] && level="info" || level=$4
[ "$5" = "" ] && default_uninteractive=$default || default_uninteractive=$5
[ ! "$interactive" = "True" ] && [ ! "$interactive" = "False" ] && echo "Question_ouinon : interactive doit être True ou False" && exit 1
[ ! "$default" = "oui" ] && [ ! "$default" = "non" ] && echo "Question_ouinon : default doit etre oui ou non" && exit 1
[ ! "$default_uninteractive" = "oui" ] && [ ! "$default_uninteractive" = "non" ] && echo "Question_ouinon : default_uninteractive doit etre oui ou non" && exit 1
[ ! "$level" = "info" ] && [ ! "$level" = "warn" ] && [ ! "$level" = "err" ] && echo "Question_ouinon : level doit etre info, warn ou err" && exit 1
#non interactive
if [ "$interactive" = "False" ]; then
Rep=default_uninteractive
else
question="$question [oui/non]"
if [ $level = "info" ]; then
echo "$question"
elif [ $level = "warn" ]; then
EchoOrange "$question"
else
EchoRouge "$question"
fi
echo -n "[$default] : "
read Rep
#passe en minuscule
Rep=`echo $Rep | tr A-Z a-z`
fi
if [ "$default" = "non" ]; then
if [ "$Rep" = "oui" -o "$Rep" = "o" -o "$Rep" = "yes" -o "$Rep" = "y" ];then
return 0
else
return 1
fi
else
if [ "$Rep" = "non" -o "$Rep" = "n" -o "$Rep" = "no" ];then
return 1
else
return 0
fi
fi
}
EchoStart() {
for i in $(eval echo "{1..30}")
do
ligne+="="
done
clear
}
BigTitle(){
size=`tput cols`
nb=${#1}
nbchar=$(($size - $nb - 4))
ligne=""
for i in $(eval echo "{1..$size}")
do
ligne+="="
done
finligne=""
for i in $(eval echo "{1..$nbchar}")
do
finligne+="="
done
echo
EchoVert $ligne
EchoVert "== $1 $finligne"
EchoVert $ligne
echo
}
Title(){
size=`tput cols`
nb=${#1}
nbchar=$(($size - $nb - 4))
ligne=""
for i in $(eval echo "{1..$size}")
do
ligne+="="
done
finligne=""
for i in $(eval echo "{1..$nbchar}")
do
finligne+="="
done
echo
EchoCyan "== $1 $finligne"
echo
}

29
doc/tools/e-reconfigure.sh Executable file
View File

@ -0,0 +1,29 @@
#!/bin/bash
. /usr/share/envole/docker/misc/e-ihm.sh
RunCmd=CreoleRun
clear
BigTitle "RECONFIGURE ENVOLE"
container_path_web=$(CreoleGet container_path_web non)
Title "Rafraichissement creoled"
service creoled restart
Title "Generation templates"
FILES="/usr/share/eole/creole/distrib/envole*"
for f in $FILES
do
if [ -f "$f" ]
then
EchoRouge $(basename $f)
CreoleCat -t $(basename $f)
fi
done
Title "Restart apache"
service apache2 restart
chmod +x $container_path_web/usr/share/envole/docker/envole.sh
$RunCmd "cd /usr/share/envole/docker && ./envole.sh" web

View File

@ -0,0 +1,202 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -0,0 +1,41 @@
{\rtf1\ansi\ansicpg1252\cocoartf1504\cocoasubrtf840
{\fonttbl\f0\fswiss\fcharset0 Helvetica;}
{\colortbl;\red255\green255\blue255;\red0\green0\blue0;\red255\green255\blue255;}
{\*\expandedcolortbl;;\csgenericrgb\c0\c0\c0;\cssrgb\c100000\c100000\c100000;}
\paperw11900\paperh16840\margl1440\margr1440\vieww10800\viewh8400\viewkind0
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural\partightenfactor0
\f0\fs24 \cf0 \
Thank you for downloading \
\b\fs28 THE BOLD FONT.
\b0\fs24 \
\
It is a 100% free font so you can use it as much as you like for whatever you like.\
Of course every donation for my effort would be highly appreciated. You can find a donate button on the DaFont page where you downloaded the font.\
\
Did you know that there is also a
\b PRO
\b0 version available. It comes with lowercase characters and has way more glyphs that the free version. You can get it at:\
\
{\field{\*\fldinst{HYPERLINK "https://the-bold-font.com/"}}{\fldrslt
\b\fs28 WWW.THE-BOLD-FONT.COM }}
\b \
\b0 \
Thank you so much and have fun designing with
\b\fs28 THE BOLD FONT
\b0\fs24 !\
\
\
\pard\pardeftab720\sl380\partightenfactor0
\cf2 \cb3 \expnd0\expndtw0\kerning0
Yours sincerely,\
Sven Pels\
\b\fs28 THE BOLD FONT.\
\b0\fs24 \
Copyright \'a9 2023
\b THE BOLD FONT.
\b0 Sven Pels. All rights reserved.}

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

BIN
doc/tools/logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 16 KiB