issue-21: actualisation de l'env de dev et maj dépendances
This commit is contained in:
129
readme.md
129
readme.md
@ -3,33 +3,20 @@
|
||||
Une [LoginApp](https://www.ory.sh/docs/hydra/concepts/login) pour le serveur OpenID Connect [Ory/Hydra](https://github.com/ory/hydra).
|
||||
Elle permet de se connecter à une base de donnée et de vérifier un mot de passe donné sur une mire locale puis d'aller chercher des données demandées
|
||||
|
||||
## Usage
|
||||
|
||||
Dans le cas d'utilsation du thème pour personaliser la page de login
|
||||
|
||||
### Développement
|
||||
|
||||
Un environnement Docker Compose est proposé comme support de développement.
|
||||
|
||||
Afin de démarrer celui-ci:
|
||||
|
||||
```bash
|
||||
|
||||
# Démarrer l'environnement docker-compose
|
||||
make up
|
||||
|
||||
# fermer l'environnement
|
||||
make down
|
||||
## Configuration
|
||||
|
||||
### Variables d'environnement
|
||||
```
|
||||
# Configuration symfony containers
|
||||
PHP_FPM_MEMORY_LIMIT=128m
|
||||
APP_ENV=dev
|
||||
DATABASE_URL=postgresql://lasql:lasql@postgres:5432/lasql?serverVersion=15&chartset=utf8
|
||||
|
||||
## Variables d'environnement
|
||||
```
|
||||
DB_USER="lasql"
|
||||
DB_PASSWORD="lasql"
|
||||
|
||||
ISSUER_URL="http://localhost:8000"
|
||||
BASE_URL='http://localhost:8080'
|
||||
BASE_URL='http://localhost:8082'
|
||||
# connexion hydra
|
||||
HYDRA_ADMIN_BASE_URL='http://hydra:4445'
|
||||
DSN_REMOTE_DATABASE="pgsql:host='postgres';port=5432;dbname=lasql"
|
||||
@ -39,81 +26,19 @@ SECURITY_PATTERN="password,salt,pepper"
|
||||
REDIS_DSN="redis://redis:6379
|
||||
PEPPER=
|
||||
```
|
||||
## Tests password
|
||||
### Algorithmes de hashage compatibles
|
||||
|
||||
Dans le cas où plusieurs méthodes de hashage cohabitent (migration de méthode par exemple dans l'application principale), toutes les méthodes indiquées dans `HASH_ALGO_LEGACY` seront testées pour comparer les hashs jusqu'à un succès
|
||||
La login app est compatible par défaut avec toutes les méthodes de hashage de PHP et avec SSHA. Aucune configuration supplémentaire n'est nécessaire.
|
||||
|
||||
## Pattern de hashage
|
||||
### Pattern de hashage
|
||||
Définir dans la variable `SECURITY_PATTERN` le pattern utilisé avec les mots clés: password | salt | pepper séparé par des virgules pour représenter la séquence à employer pour le hashage du mot de passe.
|
||||
Exemple : `SECURITY_PATTERN="salt,password,pepper"`
|
||||
|
||||
```
|
||||
Définir le pattern utilisé avec les mots clés autorisé: password | salt | pepper dans un string, séparé par des virgules pour représenter la séquence à employer pour le hashage du mot de passe.
|
||||
```
|
||||
### Postgres
|
||||
Pour choisir la base de donnée à utiliser, modifier la variable d'environnement `DSN_REMOTE_DATABASE`
|
||||
|
||||
```
|
||||
Les mot de passe inscrits en bdd sont hachés en tenant compte du salt si non vide (cf données de la bdd plus bas) et du pepper inscrit en variable d'environnement (généré avec : bin2hex(random_bytes(32)) pour l'exemple), le pepper peut être vide
|
||||
Indiquer le nom de la colonne contenant le salt:
|
||||
Il faut inscrire dans slq_login_configuration salt_column_name: salt
|
||||
Indiquer le pepper utilisé:
|
||||
et conserver le pepper dans service.yaml
|
||||
env(PEPPER): "257d62c24cd352c21b51c26dba678c8ff05011a89022aec106185bf67c69aa8b"
|
||||
|
||||
```
|
||||
|
||||
### Redis
|
||||
|
||||
La variable `REDIS_DSN` est obligatoire. Hydra-sql utilise dorénavant Redis pour le stockage du cache et des session. Compatible Redis Sentinel
|
||||
ex : `'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'`
|
||||
|
||||
### mariadb
|
||||
```
|
||||
En plus de tester la connexion à une différente base de donnée, on teste le hashage de password sans salt ni pepper
|
||||
Il faut mettre dans sql_login_configuration salt_column_name: ~
|
||||
et dans service.yaml
|
||||
env(PEPPER): ~
|
||||
|
||||
```
|
||||
### test connexion mariadb
|
||||
```
|
||||
Modifier la variable d'environnement avec cette valeur
|
||||
DSN_REMOTE_DATABASE="mysql:host=mariadb;port=3306;dbname=lasql;"
|
||||
|
||||
```
|
||||
|
||||
## Données de test
|
||||
|
||||
Des données de test sont chargées au lancement de l'environnement.
|
||||
Le mot de passe est `123456` dans tous les cas, mais il est hashé différemment.
|
||||
|
||||
Pour utiliser ces données de test avec postgres, vérifier la configuration de salt et de pepper
|
||||
pepper doit être configuré avec l'exemple mis ci-dessus env(PEPPER)
|
||||
il faut aussi indique la sql_login.yaml à salt la valeur salt (qui correspond au nom de colonne contenant le salt dans la bdd postgres)
|
||||
### postgres
|
||||
```
|
||||
|email|password|salt|lastname|firstname
|
||||
|test1@test.com| 8ad4025044b77ae6a5e3fcf99e53e44b15db9a4ecf468be21cbc6b9fbdae6d9f| cesaltestunexemple| Locke|John|
|
||||
|test2@test.com| 50626fa21f45a275cea0efff13ff78fd02234cade322da08b7191c7e9150141d| NULL| Dubois| Angela|
|
||||
|test3@test.com| 504ae1c3e2f5fdaf41f868164dabcef21e17059f5f388b452718a1ce92692c67| cesaltestunautreexemple| Dupont| Henri|
|
||||
|test4@test.com| $2a$12$91AHN7WFXieeadvUfZ88mO.9N7oS5adeXbdERnRno9oLAbqqDW4IG| NULL| Durand|Isabelle|
|
||||
|
||||
A noter que le hash de test4 est hashé avec l'algo bcrypt
|
||||
```
|
||||
|
||||
### mariadb (sans salt)
|
||||
```
|
||||
|email|password|lastname|firstname
|
||||
|test1@test.com| 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92| Sassot|Charles|
|
||||
|test2@test.com| 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92| Dubois| Angela|
|
||||
|test3@test.com| 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92| Dupont| Henri|
|
||||
|test4@test.com| 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92| Durand|Isabelle|
|
||||
```
|
||||
|
||||
## configuration
|
||||
### Schéma de base de donnée
|
||||
Permet d'adapter les requetes SQL à la base de donnée utilisée en indiquant les noms de colonnes de celle-ci.
|
||||
|
||||
pdo_configuration/pdo.yaml
|
||||
```
|
||||
```yaml
|
||||
# config/sql_login_configuration/sql_login.yaml
|
||||
sql_login:
|
||||
login_column_name: email
|
||||
password_column_name: password
|
||||
@ -125,7 +50,29 @@ sql_login:
|
||||
- firstname
|
||||
```
|
||||
|
||||
#### Conteneurs
|
||||
## Environnement de développement
|
||||
|
||||
### Tester
|
||||
Se rendre sur [http://localhost:8000/](http://localhost:8000/) et cliquer `Login` pour commencer une nouvelle connexion.
|
||||
3 utilisateurs d'exemple sont disponible pour les tests:
|
||||
| Login | Mot de passe | Algorithme |
|
||||
|-------|--------------|------------|
|
||||
| test1@test.com | 123456 | Bcrypt |
|
||||
| test2@test.com | 123456 | SHA256 |
|
||||
| test3@test.com | 123456 | SSHA |
|
||||
|
||||
### Base de donnée
|
||||
2 bases de données différentes sont disponible pour les tests.
|
||||
Pour choisir la base de donnée à utiliser, modifier les d'environnement relatives à la base de donnée.
|
||||
- **URL Postgres**: `postgresql://lasql:lasql@mariadb:3306/lasql?serverVersion=15&chartset=utf8`
|
||||
- **URL Mariadb**: `mysql://lasql:lasql@postgres:5432/lasql`
|
||||
|
||||
### Redis
|
||||
|
||||
La variable `REDIS_DSN` est obligatoire. Hydra-sql utilise dorénavant Redis pour le stockage du cache et des session. Compatible Redis Sentinel
|
||||
ex : `'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'`
|
||||
|
||||
### Liste des ports
|
||||
|
||||
|Nom|Description|Port(s) hôte utilisé(s)|
|
||||
|---|-----------|------------------|
|
||||
|
||||
Reference in New Issue
Block a user