Zum Inhalt

📊 MS Graph Integration

Übersicht

Integration mit Microsoft 365 über MS Graph API.

Features (geplant)

  • 🟡 Kalender-Integration
  • 🟡 OneDrive/SharePoint Dokumente
  • 🟡 E-Mail Versand
  • 🟡 Teams Notifications

Status

OAuth Setup erforderlich

Diese Integration erfordert manuelle OAuth-Konfiguration in Azure.

Setup

1. Azure App Registration

  1. Azure Portal öffnen
  2. "Azure Active Directory" → "App registrations"
  3. "New registration"
  4. Name: ContractPlattform
  5. Redirect URI: http://localhost:3000/auth/callback

2. API Permissions

Folgende Permissions hinzufügen:

Permission Type Description
Calendars.ReadWrite Delegated Kalender lesen/schreiben
Files.ReadWrite.All Delegated Dateien lesen/schreiben
Mail.Send Delegated E-Mails senden

3. Client Secret erstellen

  1. "Certificates & secrets"
  2. "New client secret"
  3. Secret kopieren

4. Environment konfigurieren

MS_CLIENT_ID=your_client_id
MS_CLIENT_SECRET=your_secret
MS_TENANT_ID=your_tenant_id

API Referenz

MSGraphClient

import { MSGraphClient } from '@integrations/msgraph';

const client = new MSGraphClient();

// Mit Access Token initialisieren
client.init(accessToken);

// Verträge aus OneDrive/SharePoint
const contracts = await client.getContracts();

// Termine abrufen
const appointments = await client.getAppointments();

OAuth Flow

[User] → [/auth/login] → [Microsoft Login] → [/auth/callback] → [Access Token]

TODO

  • [ ] OAuth Token Flow implementieren
  • [ ] Token Refresh Logic
  • [ ] SharePoint Site Connection
  • [ ] Calendar Sync für Termine