Einrichten Ihrer Microsoft 365 Azure-App

Um die klassischen Microsoft 365-Aktivitäten zu aktivieren, muss Ihre App in die Microsoft Identity-Plattform integriert sein und die richtigen Microsoft Graph API-Berechtigungen zugewiesen haben.

Führen Sie die folgenden Schritte aus, um Ihre Anwendung zu integrieren, Berechtigungen zuzuweisen und mit der Erstellung Ihres Automatisierungsprojekts zu beginnen:

1. Registrieren Sie Ihre Anwendung.
2. Fügen Sie API-Berechtigungen hinzu.
3. Erstellen Sie Ihr Projekt.

Nach der Registrierung Ihrer Microsoft 365-Anwendung weist Azure Active Directory eine eindeutige Anwendungs-(Client-)ID zu, die Sie in der Aktivität Microsoft 365 Scope zusammen mit den Diensten eingeben, denen Sie Berechtigungen zugewiesen haben (z. B. Dateien, E-Mail, Kalender).

Registrieren Sie Ihre Anwendung

Dieser Prozess wird in der Microsoft-Dokumentation unter Schnellstart: Registrieren einer Anwendung bei der Microsoft Identity-Plattform ausführlich beschrieben.

1. Melden Sie sich mit Ihrem persönlichen, geschäftlichen oder schulischen Microsoft 365-Konto beim Azure-Portal an.
2. Klicken Sie im linken Navigationsbereich auf Azure Active Directory.
3. Nachdem die Seite Azure Active Directory geöffnet wurde, klicken Sie auf App-Registrierungen.

4. Klicken Sie in der oberen Navigationsleiste auf + Neue Registrierung .

   
   

   

   
   
5. Geben Sie einen Namen für Ihre Anwendung ein (z. B. „Office365App“).

6. Wählen Sie unter UnterstützteKontotypen die für Sie zutreffende Option aus. Weitere Informationen zur Auswahl der Option finden Sie unten in den Empfehlungen von Microsoft:

   • Nur Konten in diesem Organisationsverzeichnis – Verwenden Sie diese Option, wenn sich Ihre Zielgruppe intern in Ihrer Organisation befindet.
   • Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Azure AD-Verzeichnis – Mehrfachmandant) – Verwenden Sie diese Option, wenn Ihre Zielgruppe Geschäfts- oder Bildungskunden sind, und um Mehrmandantenfähigkeit zu aktivieren.
   • Konten in beliebigen Organisationsverzeichnissen und persönlichen Microsoft-Konten (z. B Skype, XBox) – Verwenden Sie diese Option, um eine Vielzahl von Microsoft-Identitäten auszuwählen und die Mehrmandantenfähigkeit zu aktivieren.

7. Geben Sie unter Umleitungs-URI (optional)eine URI-Adresse ein (falls zutreffend).

   Die Microsoft-Authentifizierungsbibliothek (MSAL.NET) verwendet einen Standard-Umleitungs-URI: https://login.microsoftonline.com/common/oauth2/nativeclient. Dieser Wert wird wahrscheinlich funktionieren, wenn Sie den Authentifizierungstyp „Interaktives Token“ verwenden.
   • Ihre Auswahl hängt von Ihrem Authentifizierungstyp ab. Weitere Informationen zu diesem Thema finden Sie im Abschnitt Unattended- und Attended-Automatisierung auf der Seite mit den Details zur Aktivität Microsoft 365 Scope .
   • In unserem Beispiel unterstützt die Organisation die mandantenfähige Authentifizierung und kann nur den Authentifizierungstyp Interactive Token verwenden, der einen Umleitungs-URI erfordert.
   • Wenn Sie ein interaktives Token und den standardmäßigen Microsoft-Umleitungs-URI verwenden, müssen Sie eine Plattform vom Typ Mobile und Desktop-Anwendung hinzufügen. Weitere Informationen finden Sie in der Microsoft-Dokumentation.
   • Wenn Ihr Authentifizierungstyp Integrierte Windows-Authentifizierung oder Benutzername und Kennwort ist, müssen Sie keinen Umleitungs-URI für Ihre Anwendung registrieren. Diese Flows führen einen Roundtrip zum Microsoft Identity Platform v2.0-Endpunkt durch, und Ihre Anwendung wird nicht für einen bestimmten URI zurückgerufen.
   • Bei der Arbeit mit Microsoft 365 in einem UiPath Studio-Projekt, das auf .NET 5.0 abzielt, sollten die Clients http://localhost zum Umleitungs-URI ihrer benutzerdefinierten Anwendungen hinzufügen.

     Weitere Informationen finden Sie unter Desktop-App-Registrierung in der Dokumentation zur Microsoft Identity Platform.

8. Klicken Sie auf Registrieren. Eine Beispielkonfiguration ist im Screenshot unten verfügbar.

   Hinweis: Diese Einrichtung ist nur ein Beispiel. Führen Sie die in der Dokumentation beschriebenen Schritte aus, und treffen Sie eine Auswahl basierend auf den Richtlinien Ihrer Organisation.
   
   

   

   
   

Fertig! Jetzt fügen wir Ihrer registrierten Anwendung API-Berechtigungen hinzu.

API-Berechtigungen hinzufügen

1. Wählen Sie auf der Seite Ihrer registrierten Anwendung (Azure Portal > Azure Active Directory > App-Registrierungen > Office365App) im linken Navigationsbereich API-Berechtigungen aus.
2. Nachdem die Seite API-Berechtigung geöffnet wurde, klicken Sie auf + Berechtigung hinzufügen (dadurch wird das Fenster API -Berechtigungen anfordern geöffnet).
3. Klicken Sie unter APIauswählen auf Microsoft-APIs (kann standardmäßig geöffnet sein).

4. Klicken Sie unter Häufig verwendete Microsoft-APIsauf Microsoft Graph.

5. Wählen Sie unter Welcher Berechtigungstyp erfordert Ihre Anwendung? klicken Sie auf Delegierte Berechtigungen oder Anwendungsberechtigungen , um die Liste der Berechtigungen anzuzeigen. Anwendungsberechtigungen müssen festgelegt werden, wenn der Wert von AuthenticationType in der Aktivität Microsoft 365 Scope auf ApplicationIdAndSecret oder ApplicationIdAndCertificate festgelegt ist. Die anderen Authentifizierungstypen, die in der Aktivität Microsoft 365 Scope verfügbar sind, erfordern delegierte Berechtigungen.

   Weitere Informationen zu Berechtigungstypen finden Sie unter Konfigurieren einer Clientanwendung für den Zugriff auf Web-APIs in der Microsoft Azure-Dokumentation.

   Wichtig:

   Einige Aktivitäten unterstützen den Authentifizierungstyp ApplicationIdAndSecret oder ApplicationIdAndCertificate nicht (z. B Besprechungszeiten finden).

   Bei E-Mail-Aktivitäten muss ein Wert für den Parameter Account angegeben werden (d. h. welches Postfach aller Mandantenpostfächer Sie verwenden möchten).

   Bei Verwendung dieses Authentifizierungstyps hat die Anwendung Zugriff auf alle Postfächer Ihres Mandanten. Der Grund dafür ist, dass die Anwendungs-API-Berechtigung Mail.Read E-Mails in allen Postfächern lesen und Mail.ReadWrite E-Mails in allen Postfächern lesen und schreibenbedeutet.

   Eine Lösung besteht darin, Anwendungsberechtigungen auf bestimmte Postfächer zu beschränken, sodass die Anwendung nur Zugriff auf die angegebenen Postfächer hat.

   Weitere Informationen finden Sie unter Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer festlegen.

   Verwenden Sie die Anwendungsberechtigung Sites.Selected , um der Anwendung den Zugriff nur auf die bestimmten SharePoint-Websitesammlungen und nicht auf alle zu ermöglichen.

6. Verwenden Sie die Suchleiste oder scrollen Sie in der alphabetischen Liste nach unten und wählen Sie die folgenden Berechtigungen aus:

   • Kalender

     • Kalender.Lesen
     • Calendars.ReadWrite

   • Dateien

     • Files.Read
     • Files.Read.All
     • Files.ReadWrite
     • Files.ReadWrite.All

   • Websites

     • Sites.Read.All
     • Sites.ReadWrite.All

   • E-Mail (Mail)

     • Mail.Read
     • Mail.ReadWrite
     • Mail.Send
   • Benutzer
     • User.Read

   • Freigegeben\*

     • Mail.Read.Shared
     • Mail.ReadWrite.Shared
     • Mail.Send.Shared
     • Calendars.Read.Shared

     • Calendars.ReadWrite.Shared

       \* Bereiche, die für den Zugriff auf Ressourcen erforderlich sind, die für den Benutzer freigegeben sind, aber nicht in dessen Besitz sind.

   • Klicken Sie auf Berechtigungen hinzufügen (Sie kehren zu Ihrer Liste der API-Berechtigungenzurück).

     
     

     

     
     

7. Überprüfen Sie, ob Ihre API-Berechtigungen die hinzugefügten Berechtigungen für Kalender, Dateien, Benutzer und E- Mail- Berechtigungen enthalten.

   
   

   

   
   

Erstellen Sie Ihr Projekt in Studio Desktop

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.

   2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).

   3. Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.

   4. Wählen Sie die Kompatibilität aus. Windows ist standardmäßig ausgewählt.

   5. Klicken Sie auf Erstellen.

      

2. Installieren Sie das Paket UiPath.MicrosoftOffice365.Activities .

   1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
   2. Geben Sie unter Alle Paketein der Suchleiste Office 365 oder Microsoftein.
   3. Wählen Sie die gewünschte Paketversion aus und klicken Sie dann auf Installieren.
   4. Klicken Sie auf die Schaltfläche Speichern.
   Weitere Informationen zu UiPath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

Alles erledigt! Nachdem Sie das Setup abgeschlossen haben, können Sie mit dem Hinzufügen der Microsoft 365-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Für eine praxisbezogene Lernerfahrung und für einen schnellen Einstieg in die Verwendung der Aktivitäten, sehen Sie sich die Schnellstartanleitungen an. Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, mit denen Sie Arbeitsbeispiele für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung mit Ihrer registrierten App überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu Microsoft 365-Aktivitäten (einschließlich Beispiele für die Ein- und Ausgabe von Eigenschaften), finden Sie unter Klassische Aktivitäten mit einer vollständigen Aktivitätenliste und Links zu den Detailseiten der Aktivitäten.