Integratie Gids

Overzicht

Deze gids beschrijft de beschikbare integratiemogelijkheden van het Noveu platform.

Integratie Methoden

1. Inloggen en identiteit

Iedereen logt in met één Noveu-login voor de portal en de werkplek. Die login loopt via onze eigen identiteitsdienst (Zitadel) met OpenID Connect (OIDC). MFA met een authenticator-app of een passkey hoort erbij.

Inloggen via je eigen identiteitsdienst (gepland)

Inloggen via de identiteitsdienst van je eigen organisatie, zoals Microsoft Entra ID of Okta, is nog niet beschikbaar. Een SAML-koppeling per klant is er dus nog niet. Die koppeling staat gepland als module in het beheercentrum, zonder datum. Tot dan maak je accounts aan in Noveu zelf.

OIDC / OAuth 2.0

Ondersteunde flows:

• Authorization Code + PKCE (aanbevolen)
• Implicit (legacy)

Endpoints:

Authorization: https://auth.noveu.eu/{tenant}/authorize
Token:         https://auth.noveu.eu/{tenant}/token
UserInfo:      https://auth.noveu.eu/{tenant}/userinfo
JWKS:          https://auth.noveu.eu/{tenant}/.well-known/jwks

Scopes:

Scope	Beschrijving
openid	Required voor OIDC
profile	Naam, avatar
email	E-mailadres
groups	Groepslidmaatschappen
offline_access	Refresh tokens

2. Directory Sync

Directorysynchronisatie is niet beschikbaar. Er is geen koppeling die gebruikers, groepen of rechten uit Active Directory overneemt, en er is geen SCIM-endpoint. Gebruikers worden in Noveu zelf beheerd.

3. API Integratie

REST API

Base URL: https://api.noveu.eu/v1

Authenticatie:

• Bearer token (OAuth 2.0)
• API Key + Secret (service accounts)

Rate Limits:

Tier	Requests/min	Burst
Basis	60	100
Pro	300	500
Enterprise	1000+	Custom

Voorbeeld Request:

curl -X GET "https://api.noveu.eu/v1/users" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json"

Response Format:

{
  "data": [...],
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 150
  },
  "links": {
    "next": "https://api.../users?page=2"
  }
}

Webhooks

Beschikbare Events:

Event	Beschrijving
user.created	Nieuwe gebruiker
user.updated	Gebruiker gewijzigd
user.deleted	Gebruiker verwijderd
message.received	Mail ontvangen
file.shared	Bestand gedeeld
incident.created	Security incident

Webhook Payload:

{
  "event": "user.created",
  "timestamp": "2026-01-15T10:30:00Z",
  "data": {
    "id": "user-uuid",
    "email": "user@example.com",
    "name": "Example User"
  },
  "signature": "sha256=..."
}

4. Log Forwarding

Log forwarding naar een SIEM bestaat nog niet. Het auditlog per organisatie is te exporteren als CSV (Instellingen, Auditlog); centrale logging is gepland.

5. Email Integratie

IMAP/SMTP

Instellingen:

Protocol	Server	Port	Encryptie
IMAP	mail.noveu.eu	993	TLS
SMTP	mail.noveu.eu	587	STARTTLS

Automatische clientinstellingen

Er is een autodiscover-endpoint dat IMAP- en SMTP-instellingen teruggeeft:

Autodiscover: https://autodiscover.noveu.eu/autodiscover/autodiscover.xml

Dit dekt niet elke client automatisch. In de praktijk: iOS/iPadOS gebruikt geen autodiscover (voeg het account daar handmatig toe als IMAP-account), macOS Mail detecteert de servers vaak automatisch maar niet gegarandeerd, en Outlook (Windows) en Android vragen om de IMAP/SMTP-waarden handmatig in te voeren.

Agenda en contacten

De agenda werkt in de webmail en via CalDAV op mail.noveu.eu (poort 443, TLS), bij Mail Basis en bij de Werkplek. Met de Werkplek werken ook je contacten, in de web-app en via CardDAV op hetzelfde adres. Een agenda-app of adresboek logt in met je e-mailadres en een app-wachtwoord dat toegang heeft tot mail, agenda en contacten. Het adres voor je eigen postvak toont je werkplek bij het aanmaken van dat app-wachtwoord. De stappen per apparaat staan in de help bij Mail instellen.

6. File Storage

Bestanden lopen via de API van het platform. Er is geen WebDAV-endpoint en geen publieke S3-compatibele API.

Voorbeelden

Power Automate / Logic Apps

1. Custom connector aanmaken met OpenAPI spec
2. OAuth 2.0 connection configureren
3. Actions beschikbaar:
   • Get users
   • Create user
   • Send mail
   • Create ticket

SDKs en Libraries

Taal	Package	Status
Python	noveu-sdk	Beschikbaar
JavaScript	@noveu/sdk	Beschikbaar
C# / .NET	Noveu.SDK	In ontwikkeling
Java	noveu-java	In ontwikkeling

Python Voorbeeld:

from noveu import Client

client = Client(
    tenant="example",
    client_id="...",
    client_secret="..."
)

users = client.users.list(limit=100)
for user in users:
    print(user.email)

Troubleshooting

Common Issues

Issue	Oorzaak	Oplossing
Token expired	Short lifetime	Refresh token gebruiken
403 Forbidden	Insufficient scope	Controleer scopes
Rate limited	Te veel requests	Exponential backoff

Debug Mode

Test mode voor integraties:

# Header toevoegen
X-Noveu-Debug: true

# Response bevat extra info:
X-Request-Id: uuid
X-Debug-Info: {...}

Support

• Documentatie: docs.noveu.eu
• API Reference: api.noveu.eu/docs
• Support: integration-support@noveu.eu

---

API versie: v1