Bereitstellen von Entwicklungs- Office 365 Websites in Microsoft Azure

Bei der Entwicklung von Webanwendungen erfolgt die meiste Entwicklung lokal mit http://localhost. Einige Projekte verwenden lokale Ressourcen oder eine Mischung aus lokalen und Remoteressourcen. Die Verwendung dieser Projekte aus lokalen Entwicklungsumgebungen umfasst einige Aufgaben, die ausgeführt werden müssen, z. B. das Ändern von Datenbankverbindungszeichenfolgen, URLs und Konfigurationen.

Webprojekte, die die Office 365-APIs nutzen, unterscheiden sich nicht. Diese Projekte nutzen den Microsoft Azure Active Directory-Dienst (Azure AD), um die Anwendungen zu authentifizieren und OAuth 2.0-Zugriffstoken zu erhalten. Diese Token werden von den Webanwendungen verwendet, um sich bei den Office 365-APIs zu authentifizieren.

Auf dieser Seite werden die Schritte erläutert, die beim Erstellen eines Office 365 API-Entwicklungsprojekts und dessen Start in einem funktionierenden Beispiel erforderlich sind, das vollständig in Azure gehostet wird, indem Office 365, Azure AD und das Web-Apps-Feature von Azure App Service verwendet werden.

Für die Bereitstellung einer Office 365-API-Webanwendung in Azure aus einer lokalen Entwicklungsumgebung müssen vier allgemeine Schritte ausgeführt werden, wie auf dieser Seite beschrieben:

• Erstellen und Konfigurieren einer Web-App
• Konfigurieren Sie die Azure AD-Anwendung.
• Konfigurieren Sie das ASP.NET-Projekt.
• Stellen Sie die Office 365-API ASP.NET-Webanwendung bereit.

Erstellen und Konfigurieren einer Web-App

In diesem Schritt erstellen Sie eine Web-App, die zum Hosten der Webanwendung verwendet wird.

1. Wechseln Sie zum Azure-Portal, und melden Sie sich mit Ihrem Organisations-ID-Konto an.

2. Wählen Sie nach der Anmeldung auf der Navigationsseitenleiste WEBSITES aus.

3. Wählen Sie auf der Seite websites den Link NEU in der Fußzeile in der unteren linken Ecke der Seite aus.

4. Wählen Sie im angezeigten Assistenten Schnellerstellung aus, geben Sie einen Namen für die Website in das Feld URL ein, und wählen Sie dann einen Webhostingplan und ein Abonnement aus.

5. Klicken Sie abschließend auf den Link Website erstellen , um die Website zu erstellen.

Geben Sie Azure einen Moment Zeit, um die Website zu erstellen. Nach dem Erstellen der Website können Sie App-Einstellungen über die Weboberfläche angeben. Auf diese Weise können Sie beliebige <appSettings> Elemente innerhalb der web.config Datei des Projekts über die Webverwaltungsoberfläche für die Website außer Kraft setzen, ohne Ihre Websitecodebasis für einfache web.config Änderungen bereitzustellen.

1. Wählen Sie die Website aus, die Sie gerade im Azure-Portal erstellt haben.

2. Wählen Sie im oberen Navigationsbereich den Link KONFIGURIEREN aus.

3. Scrollen Sie nach unten zum Abschnitt App-Einstellungen , und fügen Sie drei neue Einträge hinzu:

• ida:ClientID
• ida:Password
• ida:TenantID

4. Kopieren Sie die entsprechenden Werte aus der web.config-Datei des Arbeitsprojekts in diese Einstellungswerte auf Ihrer Azure-Website, wie in der folgenden Abbildung dargestellt.

5. Wählen Sie in der Fußzeile SPEICHERN aus, um Ihre Änderungen zu speichern.

An diesem Punkt wird die Azure-Website so eingerichtet und konfiguriert, dass das Office 365 API-Webprojekt gehostet wird, das Sie in einem späteren Schritt bereitstellen werden.

Konfigurieren der Azure AD-Anwendung

In diesem Schritt ändern Sie die Azure AD-Anwendung, die beim Entwickeln und Testen der Office 365 Anwendung verwendet wird.

1. Wechseln Sie zum Azure-Portal, und melden Sie sich mit Ihrem Organisations-ID-Konto an.

2. Wählen Sie nach der Anmeldung auf der Navigationsseitenleiste ACTIVE DIRECTORY aus.

3. Wählen Sie auf der Active Directory-Seite das Verzeichnis aus, das mit Ihrem Office 365 Mandanten verknüpft ist.

4. Wählen Sie als Nächstes das Element APPLICATIONS im oberen Navigationsbereich aus.

5. Aktualisieren Sie im Abschnitt Eigenschaften die ANMELDE-URL so, dass sie auf die Standard-URL der azure-Website verweist, die Sie erstellt haben. Beachten Sie, dass Sie den HTTPS-Endpunkt verwenden, der für alle Azure-Websites bereitgestellt wird.

6. Aktualisieren Sie im Abschnitt Einmaliges Anmelden den App-ID-URI, um die Domäne für die Azure-Website zu verwenden (siehe folgende Abbildung).

7. Aktualisieren Sie die ANTWORT-URL , sodass die einzige aufgeführte URL die Startseite der Azure-Website ist:

8. Wählen Sie in der Fußzeile die Schaltfläche SPEICHERN aus, um Ihre Änderungen zu speichern.

An diesem Punkt wurde die azure AD-Anwendung, die vom Office 365-API-Webprojekt verwendet wird, für die Arbeit mit der neuen Azure-Website konfiguriert.

Konfigurieren des ASP.NET-Projekts

In diesem Schritt konfigurieren Sie das ASP.NET-Projekt in Ihrer Anwendung für die Verwendung der neuen Azure-Website.

Für die Beispielanwendung, die im Beispiel für diese Anleitung verwendet wird, ist tatsächlich keine zusätzliche Arbeit erforderlich. Die Webanwendung enthält jedoch die Einstellungen in der web.config-Datei für die Azure AD-Anwendung und den Azure AD-Mandanten, die während der Entwicklung verwendet werden. Einige Entwickler können verschiedene Azure AD-Anwendungen oder sogar unterschiedliche Azure-Abonnements für ihre Entwicklungs- und Produktionsinstanzen verwenden.

In einem vorherigen Schritt, der auf dieser Seite beschrieben ist, haben Sie beim Erstellen der Azure-Website die Add-In-Einstellungen für die Anwendung festgelegt, die sich normalerweise in der web.config-Datei befinden. Um sicherzustellen, dass die Webanwendung diese Werte aus der Azure-Websitekonfiguration empfängt, sollten Sie stattdessen die Werte in der web.config-Datei durch Platzhalterwerte ersetzen.

1. Öffnen Sie die web.config-Datei des Projekts.

2. Suchen Sie die Add-In-Einstellungen für ida:ClientID, ida:Password und ida:TenantId.

3. Ersetzen Sie die Werte dieser Einstellungen durch einen Platzhalterwert:

<add key="ida:TenantId" value="set-in-azure-website-config" />
<add key="ida:ClientID" value="set-in-azure-website-config" />
<add key="ida:Password" value="set-in-azure-website-config" />

4. Speichern Sie Ihre Änderungen.

An diesem Punkt sind die Webanwendung, die Azure-Website und die Anwendung in Azure AD ordnungsgemäß konfiguriert und bereit für die Bereitstellung.

Bereitstellen der Office 365-API ASP.NET-Webanwendung

In diesem Schritt veröffentlichen Sie die Office 365-API-Webanwendung auf der Azure-Website. Nachdem die Website bereitgestellt wurde, testen Sie sie, um sicherzustellen, dass alles wie gewünscht funktioniert.

Bereitstellen der ASP.NET-Webanwendung

1. Öffnen Sie Ihre Office 365-API-Webanwendung in Visual Studio.

2. Klicken Sie im Projektmappen-Explorer Toolfenster mit der rechten Maustaste auf das Projekt, und wählen Sie Veröffentlichen aus, um den Webveröffentlichungs-Assistenten zu starten.

3. Wählen Sie auf der Registerkarte Profil die Option Microsoft Azure-Website aus.

An diesem Punkt werden Sie aufgefordert, sich mit Ihrer Organisations-ID bei Ihrem Azure-Abonnement anzumelden.

4. Wählen Sie nach der Anmeldung auf dieser Seite die Website aus, die Sie in einem vorherigen Schritt erstellt haben, und wählen Sie dann OK aus.

5. Wählen Sie auf der Registerkarte Verbindung die Schaltfläche Verbindung überprüfen aus, um sicherzustellen, dass das Verbindungsprofil erfolgreich heruntergeladen und angewendet wurde.

6. Wählen Sie die Schaltfläche Veröffentlichen aus, um die Webanwendung auf der Azure-Website zu veröffentlichen.

Testen der ASP.NET-Webanwendung

Nachdem die Webanwendung auf der Azure-Website veröffentlicht wurde, öffnet Visual Studio einen Browser und wechselt zur Homepage der Website.

Standardmäßig ist dies der HTTP-Endpunkt. Erinnern Sie sich an den vorherigen Schritt, dass Sie beim Konfigurieren der Azure AD-Anwendung festgelegt haben, dass nur Anmeldungen vom HTTPS-Endpunkt akzeptiert werden. Bevor Sie die Anwendung verwenden, aktualisieren Sie die URL so, dass sie auf den HTTPS-Endpunkt verweist.

1. Aktualisieren Sie im Browser die URL, um zur HTTPS-Startseite für die Azure-Website zu wechseln. Im Beispiel auf dieser Seite ist dies https://o365api-01.azurewebsites.net.

2. Wählen Sie den Link Anmelden in der Kopfzeile oben rechts auf der Seite aus. Dadurch werden Sie zur Azure AD-Anmeldeseite weitergeleitet.

3. Nach der erfolgreichen Anmeldung werden Sie zurück zur Startseite für die Webanwendung der azure-Website weitergeleitet, die Sie erstellt haben.

An diesem Punkt haben Sie Ihr Office 365-API-Webanwendungsprojekt erfolgreich für die Ausführung auf einer Azure-Website bereitgestellt.

Siehe auch

• Bereitstellen von SharePoint-Add-Ins