AdToBrevo/readme.md
2025-12-08 11:18:56 +01:00

77 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```