Général:FAQ GestionUtilisateurs : Différence entre versions

De WikiFr_dbSQWare
Aller à : navigation, rechercher
m (Ajout des utilisateurs sur l'interface web dbsqware)
m (Identification du contrôleur de domaine)
 
(66 révisions intermédiaires par le même utilisateur non affichées)
Ligne 6 : Ligne 6 :
  
 
===Limites de cette section===
 
===Limites de cette section===
Ce chapitre ne traite que de la configuration de l'authentification d'utilisateurs Active Directory sur un socle déjà paramétré et fonctionnel.<br>
+
Ce chapitre ne traite que de la gestion des utilisateurs de l'interface web de dbsqware, et que le module SQWareWeb est sur un socle déjà paramétré et fonctionnel.<br>
  
===MODOP général connexions LDAP à votre contrôleur de domaine===
+
==MODOP général Ajout d'un utilisateur==
Il y aura quelques informations et configurations nécessaires à cette configuration :
+
<br>
* votre machine dbsqware doit pouvoir identifier les DC (Domain Controler) de votre domaine
+
===Explication des différents type d'utilisateurs===
** soit en utilisant 1 DC ou plus en tant que server DNS
+
 
** soit en utilisant comme serveur DNS un DNS ayant les enregistrements SRV pointant sur vos DC
+
Dans dbsqware vous pouvez créer et ajouter des utilisateurs de différents types :
* votre machine dbsqware et vos DC doivent avoir une connectivité réseau sur les ports ldap utilisés dans votre infra (389 par défaut)
+
* des utilisateurs locaux
* les utilisateurs doivent exister sur votre domaine
+
* des utilisateurs de votre Active Directory
 +
* des utilisateurs API
 +
* des utilisateurs API Maj
 
<br>
 
<br>
 +
 
{{Note| Pensez à vous connecter sur l'interface web dbsqware avec un compte ayant les privilèges admin pour faire les manipulations proposées}}
 
{{Note| Pensez à vous connecter sur l'interface web dbsqware avec un compte ayant les privilèges admin pour faire les manipulations proposées}}
  
==Identification du contrôleur de domaine==
+
Pour Ajouter ou Créer un utilisateur à se connecter : il faut aller sur l'interface web de dbsqware dans Administration (menu 1) Access (menu 2) Logins (menu 3).
  
Sur la machine dbsqware avec le compte dbsqware modifier le fichier /home/dbsqware/dbSQWare/SQWareWeb/custom/authentication_custom.php pour modifier si besoin les variables $lvsqw_ldaphost et $lvsqw_ldapport.<br>
+
En haut à droite vous cliquez sur le bouton Add.<br>
 
<br>
 
<br>
<span style="color: green">dbsqware@vmsqwarebox</span><br>
 
<pre>
 
dbsqware@vmsqwarebox:/home/dbsqware/dbSQWare/SQWareWeb/custom $ vi authentication_custom.php
 
  
...
+
[[Fichier:LOGINS FAQ.png|1400px|Add_button]]
function gfsqw_connection_external_ad($lasqw_parameters)
 
{
 
        $lvsqw_error = false;
 
        $lvsqw_errorMSG = "";
 
        $lvsqw_userName = $lasqw_parameters[0];
 
        $lvsqw_password = $lasqw_parameters[1];
 
  
        // Server connection
+
<br>
  
        // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\
+
===Création d'un utilisateur en local===
        //          Variables : $lvsqw_ldaphost
+
Ce sont les utilisateurs standards de dbsqware, ils sont stocké au niveau du serveur MariaDB ou MySQL local de vmsqwarebox.
        //                              $lvsqw_ldapport
 
        //      To be adapted according to the company    /  Fr: A adapter selon l'entreprise
 
        // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\
 
  
        $lvsqw_ldaphost = "srvaddsw01.domain.tld";          // /!\ EXAMPLE /!\
+
<br>
        $lvsqw_ldapport = 389;                  // /!\ EXAMPLE /!\
 
  
 +
===Ajout d'un utilisateurs Active Directory===
 +
Il y aura quelques informations et configurations nécessaires à cette configuration :
 +
* votre machine dbsqware doit pouvoir identifier les DC (Domain Controler) de votre domaine
 +
** soit en utilisant 1 DC ou plus en tant que server DNS
 +
** soit en utilisant comme serveur DNS un DNS ayant les enregistrements SRV pointant sur vos DC
 +
* votre machine dbsqware et vos DC doivent avoir une connectivité réseau sur les ports ldap utilisés dans votre infra (389 par défaut)
 +
* les utilisateurs doivent exister sur votre domaine
 +
<br>
  
        $lvsqw_ldapconnect = ldap_connect($lvsqw_ldaphost, $lvsqw_ldapport);
+
====Identification du contrôleur de domaine====
        ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_PROTOCOL_VERSION, 3);
 
        ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_REFERRALS, 0);
 
  
...
+
Sur la machine dbsqware avec le compte dbsqware modifier le fichier /home/dbsqware/dbSQWare/SQWareWeb/custom/authentication_custom.php pour modifier si besoin les variables $lvsqw_ldaphost, $lvsqw_ldapport et  $lvsqw_ldapbind.<br>
</pre>
+
<br>
 +
<p span style="border: 1px solid silver; padding: 10px; background-color: #E8E8E8;">
 +
<span style="color: green">#From dbsqware@vmsqwarebox</span><br>
 +
<br>
 +
dbsqware@vmsqwarebox:/home/dbsqware/dbSQWare/SQWareWeb/custom $ vi authentication_custom.php<br>
 +
...<br>
 +
function gfsqw_connection_external_ad($lasqw_parameters)<br>
 +
{<br>
 +
        $lvsqw_error = false;<br>
 +
        $lvsqw_errorMSG = "";<br>
 +
        $lvsqw_userName = $lasqw_parameters[0];<br>
 +
        $lvsqw_password = $lasqw_parameters[1];<br></span>
 +
<br>
 +
        // Server connection<br>
 +
<br>
 +
        // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\<br>
 +
        //          Variables : $lvsqw_ldaphost<br>
 +
        //                              $lvsqw_ldapport<br>
 +
        //      To be adapted according to the company    /  Fr: A adapter selon l'entreprise<br>
 +
        // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\<br>
 +
<br>
 +
        $lvsqw_ldaphost = <span style="color: blue;">"srvaddsw01.domain.tld"</span>;          // /!\ EXAMPLE /!\<br>
 +
        $lvsqw_ldapport = <span style="color: blue;">389</span>;                  // /!\ EXAMPLE /!\<br>
 +
<br>
 +
<br>
 +
        $lvsqw_ldapconnect = ldap_connect($lvsqw_ldaphost, $lvsqw_ldapport);<br>
 +
        ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_PROTOCOL_VERSION, 3);<br>
 +
        ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_REFERRALS, 0);<br>
 +
<br>
 +
        if($lvsqw_ldapconnect){<br>
 +
<br>
 +
                // Authentication<br>
 +
<br>
 +
                // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\<br>
 +
                //          Example with '@dbsqware.ad'              /  Fr: Exemple avec '@dbsqware.ad'<br>
 +
                //      To be adapted according to the company    /  Fr: A adapter selon l'entreprise<br>
 +
                // /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\      /!\<br>
 +
<br>
 +
                $lvsqw_ldapbind = ldap_bind($lvsqw_ldapconnect, $lvsqw_userName.<span style="color: blue;">'@domain.tld'</span>, $lvsqw_password);      // /!\ EXAMPLE /!\<br>
 +
<br>
 +
...<br>
 +
</p></span>
 
<br>
 
<br>
==Ajout des utilisateurs sur l'interface web dbsqware==
+
 
 +
====Ajout des utilisateurs sur l'interface web dbsqware====
  
 
Pour autoriser l'utilisateur à se connecter : il faut aller sur l'interface web de dbsqware dans Administratation (menu 1) Access (menu 2) Logins (menu 3).
 
Pour autoriser l'utilisateur à se connecter : il faut aller sur l'interface web de dbsqware dans Administratation (menu 1) Access (menu 2) Logins (menu 3).
Ligne 71 : Ligne 109 :
  
 
<br>
 
<br>
 +
 +
===Cas d'un utilisateur API===
 +
 +
<br>
 +
===Cas d'un utilisateur API MAJ===
 +
 +
<br>
 +
 +
===Utilisateur créé===
 
A partir de là votre utilisateur peut se connecter mais il n'a pas encore de privilèges.<br>
 
A partir de là votre utilisateur peut se connecter mais il n'a pas encore de privilèges.<br>
[[Fichier:LOGIN FAQ.png|300px|new_user]] [[Fichier:NO PRIV FAQ.png|1400px|no_priv]]
+
[[Fichier:LOGIN FAQ.png|300px|new_user]]  
 +
 
 +
<br>
 +
Si on le connecte l'interface n'a aucune option disponible, ni aucun lien.
 +
[[Fichier:NO PRIV FAQ.png|1400px|no_priv]]
 
<br>
 
<br>
  
==Ajout de droits à l'utilisateur==
+
==MODOP général ajout de privilèges à utilisateur==
  
Enfin pour donner des droits à l'utilisateur : il faut aller sur l'interface IHM de dbsqware dans Administratation (menu 1) Access (menu 2) LoginsPrivs (menu 3).
+
Pour donner des droits à l'utilisateur : il faut aller sur l'interface web de dbsqware dans Administratation (menu 1) Access (menu 2) LoginsPrivs (menu 3).
  
 
En haut à droite vous cliquez sur le bouton Add.
 
En haut à droite vous cliquez sur le bouton Add.
dans Grantee User Name : choisir votre nouvel utilisateur
+
 
dans Grantee Group Name : choisir le groupe qui correspond aux privilèges que vous voulez donner à cet utilisateur
+
[[Fichier:LOGINSPRIVS FAQ.png|1400px|Add_button]]
dans comments : commentaires optionnels
+
<br>
 +
 
 +
<br>
 +
Lors de l'ajout de privilèges :
 +
*dans Grantee User Name : choisir votre nouvel utilisateur
 +
*dans Grantee Group Name : choisir le groupe qui correspond aux privilèges que vous voulez donner à cet utilisateur
 +
*dans comments : commentaires optionnels
 +
 
 +
[[Fichier:PRIVS FAQ.png|1400px|LOGINSPRIVS]]
 +
<br>
 +
 
 +
<br>
 +
Une fois connecté votre utilisateur aura les droits sélectionnés
 +
 
 +
[[Fichier:PRIV FAQ.png|1400px|PRIVS_TRUE]]

Version actuelle datée du 16 août 2024 à 09:36

Généralités


Attention.png
Warning:
Avant toutes choses, n'allez pas plus loin si vous n'avez pas lu la section "Concepts dbSQWare" !.


Dans ce chapitre, on considèrera que SQWareWeb a été installé sur dbsqware@sqwarebox ...

Limites de cette section

Ce chapitre ne traite que de la gestion des utilisateurs de l'interface web de dbsqware, et que le module SQWareWeb est sur un socle déjà paramétré et fonctionnel.

MODOP général Ajout d'un utilisateur


Explication des différents type d'utilisateurs

Dans dbsqware vous pouvez créer et ajouter des utilisateurs de différents types :

  • des utilisateurs locaux
  • des utilisateurs de votre Active Directory
  • des utilisateurs API
  • des utilisateurs API Maj


Note.png
Note:
Pensez à vous connecter sur l'interface web dbsqware avec un compte ayant les privilèges admin pour faire les manipulations proposées.


Pour Ajouter ou Créer un utilisateur à se connecter : il faut aller sur l'interface web de dbsqware dans Administration (menu 1) Access (menu 2) Logins (menu 3).

En haut à droite vous cliquez sur le bouton Add.

Add_button


Création d'un utilisateur en local

Ce sont les utilisateurs standards de dbsqware, ils sont stocké au niveau du serveur MariaDB ou MySQL local de vmsqwarebox.


Ajout d'un utilisateurs Active Directory

Il y aura quelques informations et configurations nécessaires à cette configuration :

  • votre machine dbsqware doit pouvoir identifier les DC (Domain Controler) de votre domaine
    • soit en utilisant 1 DC ou plus en tant que server DNS
    • soit en utilisant comme serveur DNS un DNS ayant les enregistrements SRV pointant sur vos DC
  • votre machine dbsqware et vos DC doivent avoir une connectivité réseau sur les ports ldap utilisés dans votre infra (389 par défaut)
  • les utilisateurs doivent exister sur votre domaine


Identification du contrôleur de domaine

Sur la machine dbsqware avec le compte dbsqware modifier le fichier /home/dbsqware/dbSQWare/SQWareWeb/custom/authentication_custom.php pour modifier si besoin les variables $lvsqw_ldaphost, $lvsqw_ldapport et $lvsqw_ldapbind.

#From dbsqware@vmsqwarebox

dbsqware@vmsqwarebox:/home/dbsqware/dbSQWare/SQWareWeb/custom $ vi authentication_custom.php
...
function gfsqw_connection_external_ad($lasqw_parameters)
{
$lvsqw_error = false;
$lvsqw_errorMSG = "";
$lvsqw_userName = $lasqw_parameters[0];
$lvsqw_password = $lasqw_parameters[1];

// Server connection

// /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\
// Variables : $lvsqw_ldaphost
// $lvsqw_ldapport
// To be adapted according to the company / Fr: A adapter selon l'entreprise
// /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\

$lvsqw_ldaphost = "srvaddsw01.domain.tld"; // /!\ EXAMPLE /!\
$lvsqw_ldapport = 389; // /!\ EXAMPLE /!\


$lvsqw_ldapconnect = ldap_connect($lvsqw_ldaphost, $lvsqw_ldapport);
ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_PROTOCOL_VERSION, 3);
ldap_set_option($lvsqw_ldapconnect, LDAP_OPT_REFERRALS, 0);

if($lvsqw_ldapconnect){

// Authentication

// /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\
// Example with '@dbsqware.ad' / Fr: Exemple avec '@dbsqware.ad'
// To be adapted according to the company / Fr: A adapter selon l'entreprise
// /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\ /!\

$lvsqw_ldapbind = ldap_bind($lvsqw_ldapconnect, $lvsqw_userName.'@domain.tld', $lvsqw_password); // /!\ EXAMPLE /!\

...


Ajout des utilisateurs sur l'interface web dbsqware

Pour autoriser l'utilisateur à se connecter : il faut aller sur l'interface web de dbsqware dans Administratation (menu 1) Access (menu 2) Logins (menu 3).

En haut à droite vous cliquez sur le bouton Add.

Add_button


Lors de la création de l'utilisateurs :

  • dans Authentification : choisir external_ad
  • dans User Name : mettre le login AD de votre utilisateur
  • dans surname et firstname : mettre les informations nécessaires pour différencier les utilisateurs.
  • dans comments : commentaires optionnels

add_user_faq


Cas d'un utilisateur API


Cas d'un utilisateur API MAJ


Utilisateur créé

A partir de là votre utilisateur peut se connecter mais il n'a pas encore de privilèges.
new_user


Si on le connecte l'interface n'a aucune option disponible, ni aucun lien. no_priv

MODOP général ajout de privilèges à utilisateur

Pour donner des droits à l'utilisateur : il faut aller sur l'interface web de dbsqware dans Administratation (menu 1) Access (menu 2) LoginsPrivs (menu 3).

En haut à droite vous cliquez sur le bouton Add.

Add_button


Lors de l'ajout de privilèges :

  • dans Grantee User Name : choisir votre nouvel utilisateur
  • dans Grantee Group Name : choisir le groupe qui correspond aux privilèges que vous voulez donner à cet utilisateur
  • dans comments : commentaires optionnels

LOGINSPRIVS


Une fois connecté votre utilisateur aura les droits sélectionnés

PRIVS_TRUE