Nextcloud-ConnectMail

Bulk-link IMAP/SMTP mailaccounts voor Nextcloud-gebruikers via occ mail:account:create.

Bedoeld voor admins die in één keer mail-accounts willen koppelen voor meerdere users — bijvoorbeeld bij onboarding, migratie, of provisioning op basis van een externe lijst.

Wanneer dit script gebruiken

De Nextcloud Mail-app biedt geen REST-endpoint om als admin een account voor een andere user te koppelen. Wel bestaat occ mail:account:create <userId> ..., maar dat is positioneel en omslachtig voor bulk-werk. Dit script wrapt die call en leest een CSV.

Alternatieven:

• Provisioning-templates (admin-UI in Mail): één template per domein, géén per-user credentials. Werkt alleen als alle users hetzelfde mail-cluster delen.
• Eigen REST-controller: vereist een patch op de Mail-app.

Vereisten

• Shell-toegang tot de Nextcloud-server (rechtstreeks of via SSH/docker exec)
• occ uitvoerbaar als web-user (meestal www-data)
• De Nextcloud Mail-app geïnstalleerd en geactiveerd
• python3 op de host waar het script draait (voor RFC-4180 CSV-parsing)

Gebruik

OCC_CMD="docker exec -u www-data nc-dev php occ" \
  ./mail-bulk-link.sh accounts.csv

Voor classic installs:

OCC_CMD="sudo -u www-data php /var/www/nextcloud/occ" \
  ./mail-bulk-link.sh accounts.csv

Remote via SSH:

OCC_CMD="ssh hetzner-ax42 docker exec -u www-data nc-dev php occ" \
  ./mail-bulk-link.sh accounts.csv

CSV-formaat

Header verplicht, kolomvolgorde vrij. Verplichte kolommen:

userId,name,email,imapHost,imapPort,imapSsl,imapUser,imapPass,smtpHost,smtpPort,smtpSsl,smtpUser,smtpPass

Optionele kolom: authMethod (password of xoauth2, default password).

• imapSsl / smtpSsl: ssl, tls, of none
• Regels die beginnen met # worden overgeslagen
• Quote velden met komma's volgens RFC 4180 ("foo,bar")

Zie accounts.example.csv voor een voorbeeld.

Beperkingen

• Geen connectie-test. De occ-command slaat blind op — foute credentials worden geaccepteerd. De user merkt het pas bij de eerste sync. De REST-route (POST /api/accounts) doet wel een live IMAP/SMTP-test, maar werkt alleen voor de ingelogde user zelf.
• Geen initial mailbox-sync. Wordt door de REST-route wel getriggerd, door occ niet. Eerste sync gebeurt bij de eerstvolgende background-job of bij eerste login van de user.
• Wachtwoorden in CSV. Plaintext op disk tijdens uitvoer. Na de run: shred -u accounts.csv. Nooit committen.

Security

• Voeg accounts.csv (en varianten) toe aan .gitignore van je deploy-repo
• Draai dit alleen vanuit een omgeving waar je sowieso admin-rechten hebt
• Voor productie: overweeg de credentials uit een secrets-store te halen en de CSV on-the-fly te genereren in tmpfs

Licentie

AGPL-3.0-or-later (consistent met Nextcloud Mail).