Skip to content

F5 Distributed Cloud User and Group Sync

Synchronizes users and groups from CSV to F5 Distributed Cloud.

Getting Started

1. Create Virtual Environment

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install

pip install git+https://github.com/robinmordasiewicz/f5-xc-user-group-sync.git

3. Setup Credentials

./scripts/setup_xc_credentials.sh

The script will auto-detect your P12 certificate and configure the environment.

4. Load Environment

source secrets/.env

5. Run

# Preview changes
xc_user_group_sync --csv User-Database.csv --dry-run

# Apply changes
xc_user_group_sync --csv User-Database.csv

# Full reconciliation (includes cleanup)
xc_user_group_sync --csv User-Database.csv --prune

Documentation

CI/CD Examples