Atlassian Forge • Microsoft Graph

M365 JSM Mail Bridge

Turn Microsoft 365 Shared Mailboxes into a controlled Jira Service Management workflow — with bidirectional email, rule-based routing, monitoring, recovery tools and a guided setup experience.

Verwandelt Microsoft 365 Shared Mailboxes in einen kontrollierten Jira-Service-Management-Workflow – mit bidirektionaler E-Mail-Kommunikation, Regelwerk, Monitoring, Wiederherstellung und geführter Einrichtung.

Microsoft 365 Shared MailboxesJira Service ManagementMicrosoft GraphAtlassian Forge
Core capabilitiesKernfunktionen

Everything needed for mailbox-driven service workflows.

Alles für mailboxbasierte Serviceprozesse.

✉

Inbound mail to JSM

E-Mail zu JSM

Create JSM requests from Shared Mailbox messages and map them to the right Service Desk and Request Type.

Erstellt JSM-Vorgänge aus Shared-Mailbox-Nachrichten und ordnet sie dem passenden Service Desk und Request Type zu.

↔

Bidirectional replies

Bidirektionale Antworten

Public agent replies are sent through the configured Shared Mailbox; customer replies return to the correct Jira request.

Öffentliche Agentenantworten werden über die konfigurierte Shared Mailbox versendet; Kundenantworten landen wieder im richtigen Jira-Vorgang.

⛓

Safe threading

Sicheres Threading

Uses verified reply headers and Jira references while protecting against forwarded Sent Items being attached to the wrong request.

Nutzt verifizierte Reply-Header und Jira-Referenzen und verhindert gleichzeitig, dass Weiterleitungen aus „Gesendet“ im falschen Vorgang landen.

▣

Attachments & inline images

Anhänge & Inline-Bilder

Transfers files and CID-based inline images, including Unicode filenames and configurable attachment filtering.

Überträgt Dateien und CID-basierte Inline-Bilder – inklusive Unicode-Dateinamen und konfigurierbarer Anhangsfilter.

✂

Reply cleanup

Antwortbereinigung

Conservatively removes quoted Outlook history so Jira comments focus on the newly written reply.

Entfernt konservativ zitierte Outlook-Verläufe, damit Jira-Kommentare auf den neu geschriebenen Antworttext fokussiert bleiben.

◫

Multiple Connections

Mehrere Connections

Operate multiple Shared Mailboxes independently, each with its own authentication, processing and routing configuration.

Betreibt mehrere Shared Mailboxes unabhängig voneinander – jeweils mit eigener Authentifizierung, Verarbeitung und Routing-Konfiguration.

Guided onboardingGeführtes Onboarding

A 10-step setup wizard instead of guesswork.

10 Schritte statt Konfiguration nach Gefühl.

The wizard guides administrators through the complete connection lifecycle. Safety checks cannot be bypassed by jumping between steps, and newly created Connections remain disabled until the required tests have passed.

Der Assistent führt Administratoren durch den vollständigen Verbindungsaufbau. Sicherheitsprüfungen lassen sich durch direkte Navigation nicht umgehen und neue Connections bleiben deaktiviert, bis die erforderlichen Tests bestanden sind.

1PrerequisitesVoraussetzungenRequired roles, mailbox and tenant access.Benötigte Rollen, Mailbox und Tenant-Zugriff.
2Shared MailboxDefine the mailbox the bridge may process.Festlegen der zu verarbeitenden Shared Mailbox.
3Entra AppApplication and service-principal identifiers.Application- und Service-Principal-IDs.
4CredentialsAnmeldedatenClient secret or X.509 certificate.Client Secret oder X.509-Zertifikat.
5Exchange RBACReview-only PowerShell guidance for mailbox scoping.Review-only PowerShell-Anleitung für Mailbox-Scoping.
6Jira targetChoose Service Desk and Request Type.Service Desk und Request Type auswählen.
7Save draftEntwurf speichernConnection is created disabled.Connection wird deaktiviert angelegt.
8Security testsSicherheitstestsPositive and negative Graph Mail.Read validation.Positive und negative Graph-Mail.Read-Prüfung.
9ActivationAktivierungEnable only after successful checks.Erst nach erfolgreichen Prüfungen aktivieren.
10End-to-end testEnd-to-End-TestImport a real test mail and verify Jira.Testmail importieren und Jira-Ergebnis prüfen.
The wizard does not silently create Entra apps, grant tenant permissions or modify Exchange RBAC. Potentially destructive PowerShell commands are intentionally presented for administrator review.
Der Assistent erstellt nicht heimlich Entra-Apps, vergibt keine Tenant-Berechtigungen und ändert Exchange RBAC nicht automatisch. Potenziell verändernde PowerShell-Befehle werden bewusst zur Prüfung durch den Administrator bereitgestellt.
Routing engineRegelwerk

Route mail with nested AND / OR rules.

E-Mails mit verschachtelten UND-/ODER-Regeln routen.

Build structured routing policies instead of hard-coded mailbox logic. Rules can target Jira destinations, be simulated safely and moved between Connections for review.

Erstellt strukturierte Routing-Regeln statt fest verdrahteter Mailboxlogik. Regeln können Jira-Ziele bestimmen, sicher simuliert und zwischen Connections zur Prüfung übertragen werden.

Rule: VIP Customer Routing

AND
Sender domain
example.com
OR
Subject contains
Critical
OR
Recipient
vip@…
→
Request Type
Priority Support
Rule simulation
Preview the result against real mailbox examples before activation.
Safe JSON import/export
Imported rules remain disabled until reviewed.
Revision history
Per-Connection rule history supports controlled changes.
Bulk templates
Copy rule templates to selected Connections; destination rules stay disabled for review.
AdministrationAdministration

Built for more than one mailbox.

Für mehr als nur eine Mailbox gebaut.

  • Clone an existing Connection as a safe starting point.Bestehende Connection als sicheren Ausgangspunkt klonen.
  • Rotate one Shared Secret across selected Connections using the same Entra application.Ein gemeinsames Shared Secret für ausgewählte Connections derselben Entra-App rotieren.
  • Bulk preview/apply for up to 30 Connections with revision checks.Bulk-Preview/Apply für bis zu 30 Connections mit Revisionsprüfung.
  • Bulk enable/disable, polling interval, webhooks and daily reconciliation.Aktivierung, Polling-Intervall, Webhooks und tägliche Abstimmung gesammelt verwalten.
  • Secret-free configuration backup and safe rule export/import.Secret-freie Konfigurationssicherung und sicherer Regel-Export/-Import.
  • Search across settings for Client Secret, Routing, Logs and more.Globale Einstellungssuche für Client Secret, Routing, Logs und mehr.
Security & authenticationSicherheit & Authentifizierung

Scope mailbox access instead of granting broad mail access.

Mailbox-Zugriff eingrenzen statt pauschal freigeben.

Exchange Application RBAC

The setup flow is designed around Exchange Application RBAC so Microsoft Graph access can be scoped to explicitly approved mailboxes.

Der Einrichtungsprozess ist auf Exchange Application RBAC ausgelegt, damit Microsoft-Graph-Zugriff auf ausdrücklich freigegebene Mailboxen begrenzt werden kann.

Positive / negative access test

Positive / negative Zugriffstests

Test one allowed mailbox and optionally one intentionally excluded mailbox. Expected 200 / 403 results are shown separately.

Testet eine erlaubte und optional eine bewusst ausgeschlossene Mailbox. Erwartete 200-/403-Ergebnisse werden getrennt dargestellt.

X.509 certificate auth

Use PS256 client assertions with an RSA certificate instead of a client secret. The private key is stored using encrypted Forge secret storage.

Optional PS256 Client Assertions mit RSA-Zertifikat statt Client Secret. Der private Schlüssel wird verschlüsselt im Forge Secret Storage gespeichert.

Credential expiry monitoring

Credential-Ablaufüberwachung

Track client-secret or certificate validity so expiring credentials are visible before they break mail processing.

Überwacht Client-Secret- bzw. Zertifikatsgültigkeit, damit ablaufende Anmeldedaten vor einem Ausfall sichtbar werden.

Monitoring & Recovery

Operational visibility instead of a black box.

Operative Transparenz statt Blackbox.

Q

Serialized queue

Serialisierte Queue

Work is serialized per Connection to reduce race conditions and duplicate processing.

Verarbeitung wird je Connection serialisiert, um Race Conditions und Doppelverarbeitung zu reduzieren.

↻

Failure retries

Fehler-Retries

Automatic retry with exponential backoff. Messages exceeding the retry limit can be moved to an Outlook error folder and handled manually.

Automatische Wiederholungen mit exponentiellem Backoff. Nachrichten über dem Retry-Limit können in einen Outlook-Fehlerordner verschoben und manuell behandelt werden.

⚡

Graph Webhooks

Optional Microsoft Graph change notifications with renewal and lifecycle visibility, combined with reconciliation polling.

Optionale Microsoft-Graph-Change-Notifications inklusive Verlängerung und Lifecycle-Status, kombiniert mit Reconciliation-Polling.

H

Historical import

Historischer Import

Preview Inbox messages by UTC date range and explicitly enqueue only missing messages. Existing processed markers prevent routine reimport.

Inbox-Nachrichten nach UTC-Zeitraum vorab prüfen und nur fehlende Nachrichten gezielt erneut einreihen. Processed-Marker verhindern normalen Reimport.

✓

Daily reconciliation

Tägliche Abstimmung

Optional Inbox-to-processed-marker-to-Jira visibility report with bounded scans and reviewable examples.

Optionaler Bericht zwischen Inbox, Processed-Markern und Jira-Sichtbarkeit mit begrenzten Scans und prüfbaren Beispielen.

!

Alerts & backlog visibility

Alerts & Backlog

Monitor queue health, webhook lifecycle, retries, quarantined messages and alert conditions from the administration UI.

Queue-Zustand, Webhook-Lifecycle, Retries, quarantänisierte Nachrichten und Alarmzustände direkt in der Administration überwachen.

ResilienceResilienz

Retries where safe. No blind replay of ticket creation or mail sending.

Retries dort, wo sie sicher sind. Kein blindes Wiederholen von Ticket-Erstellung oder Mailversand.

Replay-safe Graph/Jira reads and idempotent updates can retry 429/503/504 responses using Retry-After, bounded exponential backoff and jitter. Non-idempotent POST operations that could create duplicate tickets or duplicate outgoing email are deliberately not automatically replayed.

Replay-sichere Graph-/Jira-Reads und idempotente Updates können 429/503/504-Antworten unter Berücksichtigung von Retry-After, begrenztem exponentiellem Backoff und Jitter wiederholen. Nicht-idempotente POST-Operationen, die doppelte Tickets oder E-Mails erzeugen könnten, werden bewusst nicht automatisch erneut ausgeführt.

Mail fidelityMail-Inhalte

Keep the information users actually send.

Die Informationen erhalten, die Nutzer tatsächlich senden.

  • Configurable attachment size handling.Konfigurierbare Behandlung von Anhangsgrößen.
  • Extension allowlists and blocklists.Dateiendungs-Allow- und Blocklists.
  • Inline CID image rendering in Jira.Darstellung von CID-Inline-Bildern in Jira.
  • Unicode and special-character filenames.Unicode- und Sonderzeichen in Dateinamen.
  • Internal JSM notes stay internal and are never sent as customer email.Interne JSM-Notizen bleiben intern und werden nicht als Kundenmail versendet.
  • Public agent comments are delivered through the configured Shared Mailbox.Öffentliche Agenten-Kommentare werden über die konfigurierte Shared Mailbox versendet.
International Administration

21 locale variants with Jira-aware language selection.

21 Sprachvarianten mit Jira-basierter Sprachauswahl.

The administration UI can automatically follow the Atlassian/Jira user locale, supports a manual override and falls back to English. Marketplace-facing administration strings are maintained through a central i18n layer rather than hard-coded per screen.

Die Administrationsoberfläche kann automatisch der Atlassian-/Jira-Sprache des Benutzers folgen, unterstützt eine manuelle Auswahl und fällt auf Englisch zurück. UI-Texte werden zentral über die i18n-Schicht verwaltet statt pro Bildschirm hart codiert.

ArchitectureArchitektur

Microsoft 365 ↔ Forge ↔ Jira Service Management

Microsoft 365 ↔ Forge ↔ Jira Service Management

Mailbox access and sending use Microsoft Graph with customer-supplied Entra credentials. Jira-side logic runs as an Atlassian Forge app. Optional Graph webhooks and the optional Azure scheduler can provide additional trigger paths; they do not replace the app's queue and reconciliation safeguards.

Mailbox-Zugriff und Versand erfolgen über Microsoft Graph mit vom Kunden bereitgestellten Entra-Anmeldedaten. Die Jira-seitige Logik läuft als Atlassian-Forge-App. Optionale Graph-Webhooks und ein optionaler Azure-Scheduler können zusätzliche Triggerpfade bereitstellen; Queue- und Reconciliation-Schutzmechanismen bleiben bestehen.

Designed for administratorsFür Administratoren entwickelt

Safety before convenience.

Sicherheit vor Bequemlichkeit.

Configuration changes are designed to be reviewable: cloned Connections start safely, imported/copied routing rules are disabled pending review, bulk updates use preview and revision checks, and Graph access tests explicitly distinguish allowed from excluded mailboxes.

Konfigurationsänderungen sind bewusst prüfbar gestaltet: geklonte Connections starten sicher, importierte oder kopierte Routing-Regeln bleiben bis zur Prüfung deaktiviert, Bulk-Änderungen nutzen Vorschau und Revisionskontrolle und Graph-Zugriffstests unterscheiden ausdrücklich erlaubte von ausgeschlossenen Mailboxen.