Skip to content
Snippets Groups Projects
Commit 983468c6 authored by Elian Loraux's avatar Elian Loraux
Browse files

move issue templates in services desk

parent 591143d7
Branches
No related tags found
No related merge requests found
# Ajout d'une client (royaume au sens technique Keycloak)
On différencie deux type de clients : les clients au sens commercial et les clients au sens Keycloak.
Les clients au sens Keycloak sont des application pouvant authentifier des utilisateurs via Keyclaok (Dolibarr, Nextcloud, ...)
Ici on cherche à ajouter un client au sens commercial qui se traduira par un royaume dans Keycloak
## Étapes préparatoire
- [ ] Determiner le nom du royaume : // TODO Quel est la nomenclature de nommage
- [ ] Determiner un utilisateur administrateur
- [ ] Nom :
- [ ] Prénom :
- [ ] Email :
## Création d'un nouveau royaume
- [ ] Ouvrir la console d'administration Keycloak
- [ ] Cliquez sur le menu déroulant en dessous du logo Keycloak
- [ ] Cliquez sur Create realm
![Add Realm](img/add-realm.png) // TODO image
- [ ] Entrez le nom de royaume
![Name Realm](img/name-realm.png)
## Configuration du Royaume
- [ ] Allez dans "Realm settings" ou "Configuration du Domaine"
- [ ] Cliquez sur l'onglet "Login"
- [ ] Desactivez "User registration" (l'enregistrement de nouvelle utilisateur)
- [ ] Activez "Forgot password" (en cas d'oublie de mot de passe)
- [ ] Cliquez sur l'onglet "Email"
- [ ] Rensaignez les informations lié à l'envoie de mail
- [ ] Aller dans l'onglet "Localization"
- [ ] Activez l'option "Internationalization"
- [ ] Ajoutez les langues souhaitées
- [ ] Sauvegarde
## Création du premier utilisateur
__Création d'utilisateur :__
// TODO on devrait assigner l'utilisateur à un groupe pré existant
- [ ] Cliquez sur "user" dans le menu à gauche
- [ ] Cliquez sur "Add user"
- [ ] Rensaignez les informations de l'utilisateur
- [ ] Cliquez sur Crée
- [ ] Allez dans l'onglet "Credentials"
- [ ] Cliquez sur "Set password"
- [ ] Rensaignez le mot de passe temporaire
__Création d'administrateur local :__
// TODO on devrait assigner l'admin local à un groupe "Admin local"
- [ ] Sur la page d'utilisateur, cliquez sur l'onglet "Role Mapping"
- [ ] Cliquez sur "Assign role"
- [ ] Cliquez sur le menu déroulant de filtre et selectionnez "Filter by clients"
- [ ] Selectionnez le rôle "realm-management: realm-admin"
__Transmission du compte :__
- [ ] Transmettez le nom d'utilisateur et le mot de passe temporaire via [Hemmelig](https://partage-secret.tetras-libre.fr/)
# Ajout d'un thème Keyclaok
- [ ] Aller dans le dossier themes // TODO ou est ce dossier theme ?
- [ ] Vous pouvez vous baser sur "custom-theme-template"
- [ ] Modifier le thème de base afin de coller à la charte graphique que vous voulez
- [ ] Stocker le theme sous forme d'archive dans le dossier client Nextcloud // TODO Quel format d'archive ?
- [ ] Mettre le dossier du thème dans le dossier "themes" // TODO ou est ce dossier theme ?
- [ ] Activer le thème via l'interface Keyclaok ("Realm settings" ou "Configuration du Domaine" -> onglet "Themes")
# Connexion d'une instance Dolibarr sur Keycloak
## Prérequis
- [Dolibarr dockerisé](https://gitlab.tetras-libre.fr/nocloud/docker/dolibarr) en place.
- Avoir un royaume keycloak
- Avoir un client "Dolibarr" dans ce royaume // TODO Comment créer un client Keycloak ?
## Mise en place du SSO sur dolibarr_src
1. [ ] Créer le même utilisateur (avec le même username) dans dolibarr et dans keycloak // TODO Ca dépend si on match sur username ou email
2. [ ] Récupérer les informations suivante
- [ ] Domaine Keycloak (ex : keycloak.tetras-libre.fr)
- [ ] Domaine Dolibarr (ex : dolibarr.tetras-libre.fr)
- [ ] Nom du royaume
- [ ] ClientID
1. Dans keycloak, cliquez sur "Client"
2. Récupérer le ClientID du client dolibarr ![Client ID](img/clientID.png)
3. Récupérer le secret du client ![Client secret](img/secret.png)
3. [ ] Générer les variable dolibarr avec le script `dolibarr_variables.py`
4. [ ] Mettre les variables dans Dolibarr > Setup > Other Setup
5. [ ] Configurer la methode d'authentification dans conf.php (dolibarr_src/htdocs/conf/conf.php) en mettant 'openid_connect' `$dolibarr_main_authentication='openid_connect'`
6. [ ] Configurer le Client keycloak dolibarr
1. [ ] Activer "Always display in UI"
2. [ ] Renseigner "Home URL" avec l'URL de l'instance Dolibarr (ex : dolibarr.tetras-libre.fr)
3. [ ] Renseigner "valid redirect URIs" avec l'URL de l'instance Dolibarr suivit de '\/*' (ex : dolibarr.tetras-libre.fr\/*)
4. [ ] Renseigner "Web origins" avec l'URL de Keyclaok et Dolibarr (ex : keycloak.tetras-libre.fr,dolibarr.tetras-libre.fr)
Pour plus d'information, suivez le [tutoriel dolibarr](https://wiki.dolibarr.org/index.php?title=Authentication,_SSO_and_SSL#Mode_openid_connect)
.gitlab/issue_templates/img/add-realm.png

8.07 KiB

.gitlab/issue_templates/img/clientID.png

39.1 KiB

.gitlab/issue_templates/img/name-realm.png

29.3 KiB

.gitlab/issue_templates/img/secret.png

41.2 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment