Registrieren Ihres Diensts beim Entwicklerdashboard für Nachrichten mit Aktionen

Integrationen, die nicht aktualisiert wurden, um Microsoft Entra ID Token zu verwenden, funktionieren nicht mehr. Partner müssen Entra ID-basierte Tokenauthentifizierung für alle Integrationen von Aktionen erfordernden Nachrichten verwenden. Weitere Informationen finden Sie unter Aktivieren Microsoft Entra ID Tokens für Aktionen erfordernde Nachrichten.

Stellen Sie Microsoft bestimmte Informationen zur Aktivierung dieser Funktionalität für E-Mails von Ihrem Dienst zur Verfügung, um aktionenfähige Nachrichten von Ihrem Dienst zu testen und zu veröffentlichen. Die Entwickler-Dashboard hilft Ihnen, die status Ihrer Übermittlung über das Webportal zu übermitteln und nachzuverfolgen.

Wenn Sie ein Entwickler sind, der mit nachrichtenverwertbaren Nachrichten per E-Mail arbeitet, verwenden Sie das Portal für die folgenden Fälle:

• So testen Sie Nachrichten mit Aktionen von Ihrem Dienst in Ihrem eigenen Postfach
• Um Aktionen erfordernde Nachrichten von Ihrem Dienst zu veröffentlichen, damit jeder E-Mail-Benutzer in Ihrem organization, der Microsoft 365 verwendet, diese speziell formatierten Nachrichten empfangen kann. Diese Option ermöglicht in der Regel Aktionen erfordernde Nachrichten von einem Dienst, der für Ihre organization spezifisch ist, z. B. eine branchenspezifische App.
• So veröffentlichen Sie Nachrichten mit Aktionen von Ihrem Dienst, damit jeder E-Mail-Benutzer in Microsoft 365, der Ihren Dienst verwendet, diese speziell formatierten Nachrichten empfangen kann

Übermitteln Sie für alle diese Fälle Details an Microsoft. Nach der Überprüfung und Genehmigung aktiviert Microsoft Aktionen erfordernde Nachrichten für Ihren Dienst.

Dashboardbereiche

Die Entwickler-Dashboard ist in einige logische Abschnitte unterteilt, die Sie basierend auf dem Bereich ausfüllen müssen, den Sie von Microsoft anfordern möchten, um Aktionen erfordernde Nachrichten von Ihrem Dienst zu aktivieren.

Details zu Ihrem Anbieter

In diesem Abschnitt geben Sie wichtige Details an, mit denen Microsoft 365 E-Mails mit Markup von Ihrem Dienst akzeptieren kann, sowie URLs, die die Aktionsschaltflächen in diesen E-Mails aufrufen können.

Die wichtigsten Felder sind:

• Absender-E-Mail-Adresse: Geben Sie mindestens eine statische E-Mail-Adresse ein, die dem Dienst entspricht, der E-Mails mit Aktionsmarkup sendet. Beispiel: myservice@contoso.com.

• Ziel-URLs: Geben Sie eine oder mehrere Domänen ein, die URLs entsprechen, die die Aktionen verarbeiten. Ihre Ziel-URL kann der Domäne der obersten Ebene oder der Unterdomäne der TLD entsprechen. Sie müssen HTTPS-fähige URLs sein. Beispiel: https://api.myservice.com.

• Öffentlicher Schlüssel: Wenn Sie Aktionen erfordernde Nachrichten als signierte Karte senden möchten, geben Sie den öffentlichen Schlüssel an, der dem privaten Schlüssel entspricht, den Sie zum Signieren des Karte verwenden. Das Format für dieses Feld ist ein RSAKeyValue-Element.

  <RSAKeyValue>
    <Modulus>xA7SEU+e0yQ...</Modulus>
    <Exponent>AQAB</Exponent>
  </RSAKeyValue>
  

Sie können mithilfe von PowerShell (7.3 oder höher) ein RSA-Schlüsselpaar im richtigen Format generieren und exportieren.

# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();

# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)

## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)

Ein Beispiel zum Abrufen von XML mit öffentlichem Schlüssel aus einer CERT-Datei finden Sie unter PublicKey-Klasse.

Adaptive card signature validation failed - Failed to validate signature

Umfang Ihrer Übermittlung

Geben Sie den Bereich an, in dem Sie aktionenfähige Nachrichten für Ihren Dienst aktivieren möchten. Die anwendbaren Bereiche sind:

• Testbenutzer: Dieser Bereich ermöglicht aktionenfähige E-Mails von Ihrem Dienst an einige der Microsoft 365-E-Mail-Benutzer in Ihrer organization. Verwenden Sie diesen Bereich, um die Integration von Nachrichten mit Aktionen mit einigen von Ihnen angegebenen Testbenutzern zu testen.
• Organisation: Dieser Bereich ermöglicht aktionenfähige Nachrichten von Ihrem Dienst an jeden Microsoft 365-E-Mail-Benutzer in Ihrem organization. Verwenden Sie diesen Bereich, um Aktionen erfordernde Nachrichten von einem Dienst zu aktivieren, der für Ihre organization spezifisch ist, z. B. eine branchenspezifische Anwendung.
• Global: Dieser Bereich ermöglicht Aktionen erfordernde Nachrichten von Ihrem Dienst für jeden E-Mail-Benutzer in Microsoft 365.

Jeder Bereich ist unabhängig. Sie können pro Anforderung nur einen Bereich übermitteln und müssen die Genehmigung von Microsoft einholen.

Self-Service-Registrierung

Die Self-Service-Registrierung ist für die folgenden Bereiche verfügbar.

• Testbenutzer: Die Registrierungsanforderung genehmigt ihre von Ihnen angegebenen Testbenutzer automatisch. Diese Registrierung ermöglicht aktionenfähige E-Mails von Ihrem Dienst, die an Testbenutzer gesendet werden.
• Organisation: Diese Registrierungsanforderung wird zur Überprüfung und Genehmigung an den Exchange- oder globaler Admin Ihres organization weitergeleitet.

Nachdem die Übermittlung genehmigt wurde , ob automatisch genehmigt oder von Ihrem Administrator, kann es bis zu 24 Stunden dauern, bis die Registrierung wirksam wird.

Überprüfen Sie nach 24 Stunden, ob die Registrierung aktiv ist, indem Sie eine Nachricht mit Aktionen von Ihrem Dienst an Ihr Postfach oder an angegebene Testbenutzer (für Testbenutzerbereich) oder einen beliebigen Benutzer in Ihrem organization (für den Organisationsbereich) senden. Wenn 24 Stunden vergangen sind und die Registrierung immer noch nicht aktiv ist, kontaktieren Sie uns über den Feedback-Link oben in der Registrierung Dashboard mit der Bezeichnung Registrierung funktioniert nicht?.

E-Mail-Adressen der Testbenutzer

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Testbenutzer lautet.

Stellen Sie eine Liste der Microsoft 365-E-Mail-Benutzer in Ihrem organization bereit, getrennt durch ein Semikolon (;). Diese Liste hilft Ihnen, Die Integration von Nachrichten mit Aktionen mit einigen Benutzern zu testen, bevor Sie eine Übermittlung des Organisations- oder globalen Bereichs erstellen.

Kontaktinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Kontaktdetails angeben, damit wir uns an Sie wenden können, wenn wir weitere Fragen zu Ihrer Übermittlung haben. Alle Angaben müssen gültig und korrekt sein.

Herausgeberinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Informationen zu Ihrem Dienst angeben, der Nachrichten mit Aktionen und damit im Zusammenhang stehende Supportinformationen senden wird, damit wir uns an Sie wenden oder Kunden zu Ihrer Supportwebsite weiterleiten können. Diese Informationen werden auch im Rahmen des Genehmigungsprozesses von Microsoft für Ihren Anbieter verwendet.

Szenarioinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Abschnitt müssen Sie Details zu dem Szenario angeben, in dem Benutzer Aktionen erfordernde Nachrichten von Ihrem Dienst verwenden. Dies hilft Microsoft dabei, die Gültigkeit und Nützlichkeit Ihrer Lösung zu bestimmen.

Überprüfungsinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Details für Microsoft zum Überprüfen der Nachrichten mit Aktionen und der entsprechenden Aktionen angeben, die von der an Ihren Anbieter/Dienst gesendeten E-Mail aufgerufen werden.

Senden Sie außerdem eine gültige E-Mail von Ihren Produktionsservern (oder einem Server mit ähnlichen DKIM/SPF/From:/Return-Path: Headern), einschließlich des Markups an onboardoam@microsoft.com. Mit diesem Verfahren kann Microsoft feststellen, dass die Lösung alle unter Registrierungskriterien aufgeführten Richtlinien und Anforderungen erfüllt.

• Stellen Sie vor dem Senden der Nachricht sicher, dass das Markup korrekt ist.
• Microsoft 365 entfernt das gesamte Markup beim Weiterleiten einer E-Mail. Leiten Sie keine E-Mails weiter, sondern senden Sie sie direkt.

Registrierungskriterien

Berücksichtigen Sie diese Kriterien, wenn Sie Ihre Lösung zur Genehmigung für den globalen Bereich einreichen, da dies weitreichende Auswirkungen auf Benutzer in Microsoft 365 haben kann.

Qualitätsrichtlinien für E-Mail-Absender

• Authentifizieren Sie E-Mails über DKIM oder SPF.
• Die Domäne die obersten Ebene (TLD) der SPF-Prüfung oder die DKIM-Signatur muss der TLD Ihrer From:-E-Mail-Adresse entsprechen. Wenn Sie beispielsweise From: myservice@contoso.com verwenden, muss die DKIM oder SPF für contoso.com oder -.contoso.com sein.
• Senden Sie E-Mails von einer statischen E-Mail-Adresse, z myservice@contoso.com. B. .
• Befolgen Sie die Richtlinien für E-Mail-Absender.
  • Informationen zu Microsoft 365 finden Sie unter Microsoft 365-Dienste für externe E-Mail-Absender.
  • Informationen Outlook.com finden Sie unter Richtlinien, Methoden und Richtlinien.
  • Branchenrichtlinien finden Sie unter Bewährte Methoden für M3AAWG-Absender und Bewährte Methoden für das Senden von Rückgabepfaden.
• Verwalten Sie einen konsistenten Verlauf des Sendens einer großen Anzahl von E-Mails aus Ihrer Domäne (eine Reihenfolge von hundert E-Mails pro Tag an Microsoft 365) für mindestens einige Wochen.
• Halten Sie eine sehr geringe Anzahl von Spam-Beschwerden von Benutzern.
• Verwenden Sie hochwertige, routinemäßige und einfache Aktionen für Ihren Dienst. Für komplexere Interaktionen verwenden Sie Action.OpenUrl Aktionen.
• Verwenden Sie Aktionen für Transaktions-E-Mails, bei denen eine hohe Interaktionsrate erwartet wird. Verwenden Sie sie nicht für Werbe-Massensendungen.

Aktionsrichtlinien

• Die Bezeichnung der Schaltfläche muss die zu ergreifende Aktion deutlich widerspiegeln.
• Action.OpenUrl Action muss einen Deep-Link zu der spezifischen Seite erstellen, die der Entität oder den Informationen zugeordnet ist, die in der Nachricht mit Aktionen angezeigt werden.
• Sorgen Sie für eine niedrige Fehlerrate und schnelle Reaktion für Dienste, die Aktionsanforderungen behandeln.
• Weitere Richtlinien zum Entwerfen von Nachrichten mit Aktionen finden Sie unter Entwerfen von Outlook-Nachrichtenkarten mit Aktionen im Format adaptiver Karten.

Genehmigung Ihrer Übermittlung

Sie erhalten eine Benachrichtigung unter der E-Mail-Adresse, die Sie während Der Übermittlung angeben. Stellen Sie daher sicher, dass Sie die richtigen Kontaktinformationen angeben.