Freigeben über

Aktivieren der HTTPS-Kommunikation in Azure Cloud Services (erweiterter Support)

  • Artikel

Die Kommunikation mit Microsoft Azure Cloud Services (erweiterter Support) erfolgt mithilfe des HTTPS-Protokolls (Hypertext Transfer Protocol Secure). In diesem Artikel wird erläutert, wie Sie die HTTPS-Kommunikation für Cloud Services (erweiterter Support) aktivieren.

Voraussetzungen

Allgemeine Schritte für die Projektbereitstellung

Die allgemeinen Schritte zum Bereitstellen eines Cloud Services -Projekts (erweiterter Support) in Azure lauten wie folgt:

  1. Bereiten Sie Ihr Zertifikat vor.

  2. Konfigurieren Sie Ihr Projekt.

  3. Packen Sie die Projektdatei in die Dienstdefinitionsdateien (CSDEF), die Dienstkonfiguration (CSCFG) und die Dienstpaketdateien (.cspkg) Ihres Clouddiensts.

  4. Ändern Sie bei Bedarf die Konfiguration der Cloud Services-Ressource (erweiterter Support). Sie können beispielsweise eine der folgenden Änderungen vornehmen:

    1. Aktualisieren Sie die Paket-URL.
    2. Konfigurieren Sie die URL-Einstellung.
    3. Aktualisieren Sie die Einstellung für geheime Betriebssystemschlüssel.

  5. Stellen Sie das neue Projekt in Azure bereit und aktualisieren Sie es.

Notiz

Das Projekt kann über verschiedene Methoden bereitgestellt werden, z. B. mithilfe der folgenden Tools:

Unabhängig von der Bereitstellungsmethode sind die allgemeinen Bereitstellungsschritte identisch.

Die ersten beiden dieser Schritte sind für alle Bereitstellungsmethoden erforderlich. Diese Schritte werden im Abschnitt "Codeänderungen" erläutert. Die verbleibenden Schritte sind ebenfalls wichtig, erfordern jedoch nicht immer manuelle Benutzereingriffe. Die Schritte können z. B. automatisch von einem Tool wie Visual Studio ausgeführt werden. Die letzten drei dieser Schritte werden im Abschnitt "Konfigurationsänderungen " erläutert.

Codeänderungen

Führen Sie die folgenden Schritte aus, um die Codeänderungen vorzunehmen, um Ihr Zertifikat vorzubereiten und Ihr Projekt zu konfigurieren:

  1. Folgen Sie den Anweisungen, um ein Zertifikat bis Schritt 6 in den Schlüsseltresor hochzuladen.

  2. Notieren Sie sich den Fingerabdruck des Zertifikats (eine 40-stellige hexadezimale Zeichenfolge).

  3. Fügen Sie in der Dienstkonfigurationsdatei (.cscfg) Ihres Projekts den Zertifikatfingerabdruck der Rolle hinzu, in der Sie das Zertifikat verwenden möchten. Wenn Sie z. B. das Zertifikat als SSL-Zertifikat für die Kommunikation mit einem WebRole verwenden möchten, können Sie XML-Code hinzufügen, der dem folgenden Codeausschnitt WebRole1 als erstes untergeordnetes Element des Stammelements ServiceConfiguration ähnelt:

    <Role name="WebRole1">
  <Instances count="1" />
  <Certificates>
    <Certificate
      name="Certificate1"
      thumbprint="0123456789ABCDEF0123456789ABCDEF01234567"
      thumbprintAlgorithm="sha1"
    />
  </Certificates>
</Role>

    Sie können den Namen des Zertifikats anpassen, muss aber mit dem Zertifikatnamen übereinstimmen, der in der Dienstdefinitionsdatei (CSDEF) verwendet wird.

  4. Fügen Sie in der Dienstdefinitionsdatei (CSDEF) die folgenden Elemente hinzu.

    Übergeordnetes XPath-Element Hinzuzufügende Elemente Zu verwendende Attribute
    /ServiceDefinition/WebRole/Sites/Site/Bindings Binding name, endpointName
    /ServiceDefinition/WebRole/Endpoints InputEndpoint Name, Protokoll, Port, Zertifikat
    /ServiceDefinition/WebRole Certificates/Certificate name, storeLocation, storeName, permissionLevel

    Das Certificates Element muss direkt nach dem schließenden Endpoints Tag hinzugefügt werden. Es enthält keine Attribute. Sie enthält nur untergeordnete Certificate Elemente.

    Ihre Dienstdefinitionsdatei könnte z. B. dem folgenden XML-Code ähneln:

    <?xml version="1.0" encoding="utf-8"?>
<ServiceDefinition name="CSESOneWebRoleHTTPS" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" schemaVersion="2015-04.2.6">
  <WebRole name="WebRole1" vmsize="Standard_D1_v2">
    <Sites>
      <Site name="Web">
        <Bindings>
          <Binding name="Endpoint1" endpointName="Endpoint1" />
          <Binding name="HttpsIn" endpointName="HttpsIn" />
        </Bindings>
      </Site>
    </Sites>
    <Endpoints>
      <InputEndpoint name="Endpoint1" protocol="http" port="80" />
      <InputEndpoint name="HttpsIn" protocol="https" port="443" certificate="Certificate1" />
    </Endpoints>
    <Certificates>
      <Certificate name="Certificate1" storeLocation="LocalMachine" storeName="My" permissionLevel="limitedOrElevated" />
    </Certificates>
  </WebRole>
</ServiceDefinition>

    In diesem Beispiel wird die Dienstdefinitionsdatei geändert, um einen Eingabeendpunkt für HttpsIn das HTTPS-Protokoll an Port 443 zu binden. Es verwendet das Certificate1 Zertifikat für einen Speicher, der My einen Namen und einen Speicherort LocalMachine für nur eine eingeschränkte oder erhöhte Berechtigungsstufe hat. Die Zertifikatnamen in den InputEndpoint und Certificate die Elemente stimmen einander überein. Sie stimmen auch mit dem Zertifikatnamen überein, der in der Dienstkonfigurationsdatei (.cscfg) aus dem vorherigen Schritt verwendet wurde.

Konfigurationsänderungen

Anweisungen zum Ändern Ihrer Clouddienstkonfiguration unterscheiden sich je nach Bereitstellung Ihres Clouddiensts. Diese Anweisungen werden auf den folgenden Registerkarten angezeigt. Jede Registerkarte stellt eine andere Bereitstellungsmethode dar.

Bevor Sie fortfahren, lesen Sie die Bereitstellung von Azure Cloud Services (erweiterter Support) mithilfe des Azure-Portal. Führen Sie dann die folgenden Schritte aus, um die richtigen Konfigurationsänderungen über die Azure-Portal vorzunehmen:

  1. Wechseln Sie zum Blogeintrag mit dem Titel "Manuelle Migration von klassischem Cloud Service zu erweiterter CloudDienst mit ARM-Vorlage", und führen Sie die Schritte 7 bis 9 aus. In diesen Anweisungen erfahren Sie, wie Sie die folgenden Schritte ausführen:

    • Packe das Projekt.

    • Laden Sie die generierten Dienstpaketdateien (<project-name.cspkg>) und Die Dateien für die Clouddienstkonfiguration (ServiceConfiguration.Cloud.cscfg) in einen Speicherkontocontainer für Ihren Clouddienst hoch.

      Notiz

      Sie müssen auch die Dienstdefinitionsdatei (ServiceDefinition.csdef) hochladen, indem Sie denselben Prozess verwenden, der für die anderen beiden Dateien beschrieben wird.

    • Generieren Sie eine SAS-URL (Shared Access Signature) für jede der hochgeladenen Dateien.

  2. Kehren Sie in der Azure-Portal zur Seite "Übersicht" Ihres Clouddiensts zurück, und wählen Sie dann "Aktualisieren" aus.

  3. Nehmen Sie auf der Seite "Clouddienst aktualisieren " die folgenden Änderungen auf der Registerkarte "Grundlagen " vor:

    1. Wählen Sie im Feld "Paket/Konfiguration/Dienstdefinition" die Option "Von blob" aus.

    2. Führen Sie im Feld "Paket hochladen" (.cspkg, .zip) die folgenden Schritte aus:

      1. Wählen Sie den Link "Durchsuchen" aus .
      2. Wählen Sie das Speicherkonto und den Container aus, in das Sie Dateien hochgeladen haben.
      3. Wählen Sie auf der Containerseite die entsprechende Datei aus (in diesem Fall <project-name.cspkg>), und wählen Sie dann die Schaltfläche "Auswählen" aus.

    3. Wiederholen Sie für das Hochladen eines Konfigurationsfelds (.cscfg) (und der Datei ServiceConfiguration.Cloud.cscfg ) die im vorherigen Schritt beschriebene Unterprozedur.

    4. Wiederholen Sie die Unterprozedur für das Hochladen eines Dienstdefinitionsfelds (CSDEF) (und der Datei ServiceDefinition.csdef ).

  4. Wählen Sie die Registerkarte Konfiguration aus.

  5. Wählen Sie im Feld "Schlüsseltresor" den Schlüsseltresor aus, in den Sie das Zertifikat hochgeladen haben (weiter oben im Abschnitt "Codeänderungen "). Nachdem das Zertifikat im ausgewählten Schlüsseltresor gefunden wurde, zeigt das aufgelistete Zertifikat den Status " Gefunden" an.

  6. Um das neu konfigurierte Projekt bereitzustellen, wählen Sie die Schaltfläche "Aktualisieren " aus.

Nachdem Sie die Konfigurationsänderungen vorgenommen haben, können Kunden mithilfe des HTTPS-Protokolls mit Ihrer Clouddienste-Website kommunizieren. Wenn Ihr Zertifikat selbstsigniert ist, meldet der Browser möglicherweise eine Warnung, dass das Zertifikat nicht sicher ist, aber der Browser blockiert die Verbindung nicht.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.