ajout du readme.md

This commit is contained in:
Administration 2025-12-08 11:18:56 +01:00
parent 8699e89d9e
commit f3149ed421

77
readme.md Normal file
View File

@ -0,0 +1,77 @@
# Sans titre
# AdToBrevo PowerShell Scripts
## Description
Scripts PowerShell pour synchroniser les groupes et utilisateurs d'Active Directory avec Brevo via l'API.
Inclut un service de logging avec rotation automatique des fichiers de log.
---
## Structure du projet
AdToBrevo/
├─ modules/
│ ├─ AdService.ps1 # Fonctions pour récupérer les utilisateurs et emails depuis AD
│ ├─ ApiService.ps1 # Fonctions pour interagir avec l'API Brevo
│ └─ LogService.ps1 # Service de logging avec rotation des fichiers
├─ logs/ # Dossier de logs (ignoré par Git)
├─ groups.json # Configuration des groupes à synchroniser
├─ app.ps1 # Script principal de synchronisation
└─ .gitignore # Ignorer fichiers temporaires et logs
---
## Prérequis
- PowerShell 5.1 ou supérieur
- Module **ActiveDirectory**
- Clé API Brevo valide
---
## Configuration
1. Définir la clé API dans un fichier config.env à la racine du projet:
```powershell
API_KEY=xxxxx
```
2. Mettre à jour `groups.json` avec vos groupes AD et leurs correspondances Brevo :
```json
[
{ "Nom": "groupe_1", "Id": "1" },
{ "Nom": "groupe_2", "Id": "2" },
{ "Nom": "...", "Id": ".." }
]
```
Le champ **Nom** doit correspondre à lattribut displayName de lActiveDirectory. Le champ **Id** correspond au champ id de la liste, visible dans linterface de Brevo.
1. Les logs sont créés dans le dossier `logs` avec rotation quotidienne et suppression après 5 jours.
---
## Usage
1. Exécuter le script principal:
```json
.\app.ps1
```