Scripted Actions Azure Runbook: Private Endpoints aktivieren

Diese Scripted Action fügt private Endpoints und Dienst-Endpoints hinzu. So kann Nerdio Manager App Service über ein privates Netzwerk auf die SQL-Datenbank, Key Vault und die Automatisierungskonten zugreifen. Der Datenverkehr wird nicht über das öffentliche Internet weitergeleitet. Anschließend wird der öffentliche Zugriff auf die Datenbank, den Key Vault und die anderen abgedeckten Komponenten eingeschränkt.

Sie können das Skript jederzeit erneut ausführen, um neu aktivierte Komponenten in dasselbe private Netzwerk aufzunehmen. Das Skript aktiviert den öffentlichen Zugriff nicht erneut für Komponenten, bei denen er bei einer früheren Ausführung eingeschränkt wurde.

Vom Skript abgedeckte Komponenten

Das Skript deckt die folgenden Komponenten ab, sofern sie in Ihrer Umgebung bereitgestellt sind:

  • Nerdio Manager: der Key Vault, SQL Server, das Nerdio Manager-Automatisierungskonto, das Scripted Actions-Automatisierungskonto, App Service, das DPS-Storage-Konto und das Scripted Actions-Storage-Konto.

  • Kostenrechner: der Key Vault, das Storage-Konto und die Web-App.

  • Intune Insights: der Key Vault, SQL Server und die Web-App.

  • Real-Time Insights: der Key Vault, SQL Server, die Web-App und das Storage-Konto.

Wenn Sie eine Komponente aktivieren, nachdem Sie das Skript ausgeführt haben, führen Sie das Skript erneut aus, um sie in dasselbe private Netzwerk aufzunehmen. Das Skript unterstützt Azure Monitor, Log Analytics oder Application Insights nicht. Siehe Was das Skript nicht privat macht.

Bevor Sie das Skript ausführen

Wichtig

Mit dem Standardwert CssaStorageAccount (Restricted) oder mit Private schränkt das Skript den öffentlichen Zugriff auf das Scripted Actions-Storage-Konto ein. Wenn Ihre Azure Runbooks im Download-Modus ausgeführt werden, kann Azure Automation danach das Skript für keine weiteren Scripted Actions mehr herunterladen. Alle späteren Scripted Actions bleiben ohne Fehlermeldung wirkungslos. Dies schließt eine spätere Ausführung dieses Skripts ein. Stellen Sie den Azure Runbook-Ausführungsmodus auf Inline Script um, bevor Sie das Skript ausführen. Weitere Informationen finden Sie unter Scripted Actions für Azure Runbooks.

  • Verlinken Sie die virtuellen Netzwerke, deren Hosts Zugriff auf das Storage-Konto für Scripted Actions oder auf den App Service von Real-Time Insights benötigen, mit Nerdio Manager. Die Einstellungen Restricted erlauben den Zugriff nur von den Subnetzen verlinkter Netzwerke aus. Siehe Azure-Umgebung: verlinkte Netzwerke und Ressourcengruppen.

  • Stellen Sie sicher, dass die folgenden PowerShell-Module im Automatisierungskonto für Scripted Actions verfügbar sind: Az.Accounts, Az.Resources, Az.KeyVault, Az.Sql, Az.Storage, Az.Websites, Az.Network, Az.PrivateDns und Az.Automation. Wenn ein Modul fehlt, beendet das Skript die Ausführung, bevor es etwas ändert, und nennt das fehlende Modul.

Was das Skript tut

Wenn Sie das Skript ausführen, geschieht Folgendes:

  • Erstellt das VNet für den privaten Endpoint und dessen Subnetze oder verwendet die bereits vorhandenen. Das Skript sucht zuerst in der Ressourcengruppe Nerdio Manager nach dem VNet und dann im Rest des Abonnements.

  • Erstellt private DNS-Zonen und verlinkt sie mit dem VNet oder verwendet Ihre vorhandenen Zonen (siehe ExistingDNSZonesRG und SkipDNS). Das Skript durchsucht das Abonnement nach vorhandenen privaten Endpoints.

  • Erstellt die privaten Endpoints, stellt für die App Services eine Verbindung zum App Service-Subnetz her und richtet ein Peering zwischen den angegebenen VNets ein.

  • Führt vom VNet-integrierten App Service-Worker aus eine Konnektivitätsprüfung zum Key Vault (Port 443), zum SQL Server (Port 1433) und zum DPS-Storage-Konto (Blob, Port 443) aus. Wenn ein Ziel fehlschlägt, beendet das Skript die Ausführung mit einem Fehler, und bei dieser Ausführung wird nichts auf privat umgestellt.

  • Deaktiviert den öffentlichen Netzwerkzugriff auf die betroffenen Komponenten, abhängig von den folgenden Parametern. Wenn die Erstellung eines privaten Endpoints oder einer DNS-Zonengruppe fehlschlägt, stellt das Skript nichts auf privat um und listet die Komponenten auf, bei denen die Erstellung fehlgeschlagen ist.

  • Setzt den Mindestwert für die TLS-Version der Storage-Konten und SQL Server auf 1,2 und untersagt den anonymen öffentlichen Blob-Zugriff auf die Storage-Konten.

  • Gibt Warnungen zu NSGs und Routentabellen aus, die dem Subnetz des privaten Endpoints oder dem App Service-Subnetz zugeordnet sind. Das Skript meldet sie nur. Es ändert sie nicht.

  • Startet den Nerdio Manager App Service neu.

Wenn dasselbe Skript in den letzten 10 Minuten ausgeführt wurde, gibt das Skript den Output dieser früheren Ausführung erneut aus, anstatt erneut ausgeführt zu werden.

Um die Namen der Ressourcen anzupassen, die das Skript erstellt, wie z. B. Namen privater Endpoints, klonen Sie das Skript und bearbeiten Sie die Variablen am Anfang des Skripts.

Laufzeitparameter

Die folgenden Parameter können zur Laufzeit angegeben werden:

Parameter

Standard

Beschreibung

PrivateLinkVnetName

nmw-private-vnet

Subnetz für private Endpoints Wenn das VNet nicht existiert, wird es erstellt. Wenn Sie ein existierendes VNet angeben, müssen das VNet oder seine Ressourcengruppe mit Nerdio Manager unter System > Einstellungen > Azure verlinkt sein.

VnetAddressRange

10.250.250.0/23

Adressbereich für das VNet des privaten Endpoints. Wird ignoriert, wenn das VNet bereits existiert.

PrivateEndpointSubnetName

nmw-privateendpoints-subnet

Name des Subnetzes für den privaten Endpoint. Wenn das Subnetz nicht existiert, wird es erstellt.

PrivateEndpointSubnetRange

10.250.250.0/24

Adressbereich für das Subnetz des privaten Endpoints. Wird ignoriert, wenn das Subnetz bereits existiert.

AppServiceSubnetName

nmw-app-subnet

Name des App Service-Subnetzes. Wenn das Subnetz nicht existiert, wird es erstellt.

AppServiceSubnetRange

10.250.251.0/26

Adressbereich für das App Service-Subnetz. Wird ignoriert, wenn das Subnetz bereits existiert. Informationen dazu, wie Sie die Größe eines vorhandenen Subnetzes anpassen, finden Sie unter Größe des App Service-Subnetzes anpassen.

ExistingDNSZonesRG

Keine

Wenn Sie bereits private DNS-Zonen für die Verwendung mit den neuen privaten Endpoints konfiguriert haben, geben Sie hier deren Ressourcengruppe an. Das Skript findet und verwendet die vorhandenen DNS-Zonen. Siehe Private DNS-Zonen für die Zonennamen.

Anmerkung

Diese Ressourcengruppe muss mit Nerdio Manager unter System > Einstellungen > Azure verlinkt sein, oder Nerdio Manager muss die Rolle „Private DNS Zone Contributor“ für die Zonen erhalten.

ExistingDNSZonesSubId

Keine

Die Abonnement-ID von ExistingDNSZonesRG, falls sich die Ressourcengruppe in einem anderen Abonnement als Nerdio Manager befindet. Verwenden Sie diesen Parameter nur zusammen mit ExistingDNSZonesRG.

CssaStorageAccount

(Eingeschränkt)

Steuert den Netzwerkzugriff auf das Storage-Konto für Scripted Actions. Gültige Werte sind:

  • (Eingeschränkt) Erstellt einen privaten Endpoint und schränkt den öffentlichen Endpoint des Storage-Kontos auf die Subnetze verlinkter Netzwerke ein, für die der Dienst-Endpoint Microsoft.Storage aktiviert ist. Verwenden Sie Microsoft.Storage.Global für ein Subnetz in einer anderen Region als das Storage-Konto.

  • Öffentlich Belässt das Storage-Konto unverändert.

  • Private: Erstellt einen privaten Endpoint und deaktiviert den öffentlichen Netzwerkzugriff vollständig, ohne Positivliste.

Das Skript aktiviert keine Dienst-Endpoints für Subnetze, die es nicht selbst erstellt hat. Es meldet die Subnetze, die über keinen verfügen, und überspringt diese. Wenn kein verlinktes Netzwerk über ein Subnetz mit dem Dienst-Endpoint verfügt, ändert Restricted nichts, da die Einschränkung des Storage-Kontos mit einer leeren Positivliste denselben Effekt hätte wie Private.

Eine restriktivere Einstellung wird bei einer späteren Ausführung niemals gelockert. Um den öffentlichen Zugriff wieder zu ermöglichen, ändern Sie die Einstellung im Azure-Portal.

Anmerkung

Mit Private verliert jeder Client ohne Netzwerkzugriff auf den privaten Endpoint, einschließlich AVD-Sitzungshosts, den Zugriff auf das Storage-Konto, und die Scripted Actions, die diesen Zugriff benötigen, schlagen auf diesen Hosts fehl. Verwenden Sie PeerVnetIds, um ein Peering zwischen dem VNet der Sitzungshosts und dem VNet des privaten Endpoints einzurichten. Stellen Sie sicher, dass DNS den FQDN des Storage-Kontos zum privaten Endpoint auflöst. Alternativ verwenden Sie Restricted.

PeerVnetIds

Keine

Optional. Gültige Werte sind All oder eine durch Kommas getrennte Liste von Azure-Ressourcen-IDs der VNets, für die Peering mit dem VNet des privaten Endpoints eingerichtet werden soll. Wenn Sie All angeben, wird für alle verlinkten VNets im selben Abonnement Peering eingerichtet. Die VNets oder deren Ressourcengruppen müssen unter Nerdio Manager in System > Einstellungen > Azure verlinkt sein. Die VNets müssen sich im selben Abonnement wie Nerdio Manager befinden. Richten Sie für VNets in anderen Abonnements manuell Peering ein.

Wenn MakeAppServicePrivate auf true gesetzt ist oder RtiAppService nicht Public ist, verlinkt das Skript auch die private DNS-Zone von App Service mit den per Peering verbundenen VNets.

MakeAppServicePrivate

falsch

Begrenzt den Zugriff auf den Nerdio Manager App Service und die Intune Insights-Web-App. Wenn Sie den Wert auf true setzen, können nur Hosts im VNet, das dieses Skript erstellt, oder in per Peering verbundenen VNets darauf zugreifen. Die Intune Insights-Web-App wird innerhalb von Nerdio Manager angezeigt, daher müssen beide von denselben Clients erreichbar sein.

Warnung

Möglicherweise können Sie nach Aktivierung dieser Option nicht mehr auf Nerdio Manager zugreifen. Das Zurücksetzen des Parameters auf false aktiviert den öffentlichen Zugriff nicht wieder. Um den öffentlichen Zugriff wieder zu ermöglichen, ändern Sie dies im Azure-Portal.

RtiAppService

Öffentlich

Steuert den Netzwerkzugriff auf den App Service von Real-Time Insights. Gültige Werte sind:

  • Öffentlich Lässt den App Service unverändert.

  • (Eingeschränkt) Schränkt den öffentlichen Endpoint auf die Subnetze verlinkter Netzwerke ein, für die der Dienst-Endpoint Microsoft.Web aktiviert ist.

  • Private: Deaktiviert den öffentlichen Netzwerkzugriff vollständig.

Warnung

Restricted und Private können Geräte ohne Netzwerkzugriff auf das private VNet unbemerkt vom Zugriff abschneiden, darunter Windows 365 Cloud-PCs und Intune-verwaltete Geräte, die zwischen Netzwerken wechseln. Sie können deren Zugriff weder durch Peering noch durch Firewall-Regeln wiederherstellen. Das einzige Symptom ist ein fehlender Verlauf von Real-Time Insights.

Real-Time Insights wird in Nerdio Manager angezeigt. Deshalb benötigt auch der Browser jedes Users, der es aufruft, Netzwerkzugriff auf den App Service von Real-Time Insights. Der Zugriff von Nerdio Manager allein reicht nicht aus. Wenn der Browser eines Users den App Service nicht erreichen kann, wird Real-Time Insights für diesen User nicht angezeigt, obwohl der App Service in Betrieb ist.

SkipDNS

falsch

Überspringt das Erstellen, Suchen und Verlinken sämtlicher DNS-Zonen, einschließlich der Zonengruppen, die die A-Datensätze für die privaten Endpoints schreiben. Verwenden Sie dies nur, wenn Sie DNS selbst verwalten. Das Skript beendet die Ausführung mit einem Fehler, wenn Sie sowohl SkipDNS als auch ExistingDNSZonesRG festlegen.

Warnung

Das Skript kann in derselben Ausführung weiterhin den öffentlichen Zugriff auf Key Vault und SQL Server deaktivieren. Bis Ihre DNS-Datensätze in die privaten Endpoints aufgelöst werden, kann Nerdio Manager diese nicht erreichen.

Zugriff auf App Service

Die folgende Tabelle zeigt, wie das Skript den öffentlichen Zugriff auf jeden App Service steuert.

App Service: ()

Gesteuert durch

Verhalten

App Service: Nerdio Manager)

MakeAppServicePrivate

Wenn Sie den Wert auf true setzen, deaktiviert das Skript den öffentlichen Netzwerkzugriff. Andernfalls bleibt der öffentliche Zugriff unverändert.

Intune Insights-Web-App

MakeAppServicePrivate

Für die Intune Insights-Web-App gelten dieselben Zugriffseinstellungen wie für den Nerdio Manager App Service, da sie in Nerdio Manager angezeigt wird.

Cost Calculator-Web-App

Nicht konfigurierbar

Ist unabhängig von MakeAppServicePrivate immer privat. Nur der App Service Nerdio Manager sendet Daten an ihn, und dieser Datenverkehr nutzt das private Netzwerk.

Real-Time Insights-App Service

RtiAppService

Public lässt den Zugriff unverändert, Restricted begrenzt den öffentlichen Endpoint auf verlinkte Netzwerke und Private deaktiviert den öffentlichen Zugriff.

Real-Time Insights wird innerhalb von Nerdio Manager angezeigt, daher muss auch der Browser jedes Users, der es betrachtet, diesen App Service erreichen können.

Was das Skript nicht privat macht

  • Datenverkehr der Azure Resource Manager-Steuerungsebene (management.azure.com oder management.usgovcloudapi.net in US Government-Clouds).

  • Azure Monitor, Log Analytics-Workspaces und Application Insights. Das Skript ändert sie nicht.

  • Die Warteschlangen- und Datei-Unterressourcen von Storage-Konten. Das Skript erstellt für jedes abgedeckte Storage-Konto einen privaten Blob-Endpoint und für das Real-Time Insights-Storage-Konto einen privaten Tabellen-Endpoint, da nichts in Nerdio Manager die anderen verwendet.

Private DNS-Zone

Das Skript erstellt die folgenden privaten DNS-Zonen oder findet sie in ExistingDNSZonesRG:

Dienst

Azure Commercial

Azure US Government

Key Vault

privatelink.vaultcore.azure.net

privatelink.vaultcore.usgovcloudapi.net

SQL-Server

privatelink.database.windows.net

privatelink.database.usgovcloudapi.net

Automatisierung

privatelink.azure-automation.net

privatelink.azure-automation.us

Blob Storage

privatelink.blob.core.windows.net

privatelink.blob.core.usgovcloudapi.net

Tabellenspeicher

privatelink.table.core.windows.net

privatelink.table.core.usgovcloudapi.net

App Service: ()

privatelink.azurewebsites.net

privatelink.azurewebsites.us

Zugriff nach einer Sperrung wiederherstellen

Das Skript deaktiviert immer nur den öffentlichen Netzwerkzugriff. Es aktiviert ihn niemals wieder. Um den öffentlichen Zugriff auf eine Ressource wieder zu ermöglichen, ändern Sie deren Einstellungen für das Netzwerkmanagement im Azure-Portal.

  • Wenn Sie SkipDNS auf true setzen und die DNS-Datensätze für die privaten Endpoints nicht in die privaten IP-Adressen aufgelöst werden, kann Nerdio Manager nicht auf seinen Key Vault und SQL Server zugreifen, und das Laden der App schlägt mit einem 500.30-Fehler fehl. Erstellen Sie die DNS-Datensätze oder erlauben Sie im Azure-Portal den öffentlichen Zugriff auf den Key Vault und SQL Server, bis die DNS-Datensätze aufgelöst werden.

  • Wenn Sie Nerdio Manager nicht erreichen können, nachdem Sie MakeAppServicePrivate auf true gesetzt haben, stellen Sie eine Verbindung von einem Host im privaten VNet oder einem per Peering verbundenen VNet her oder erlauben Sie den öffentlichen Zugriff auf den App Service im Azure-Portal.

  • Wenn Real-Time Insights für einige User nicht in Nerdio Manager angezeigt wird, nachdem Sie RtiAppService auf Restricted oder Private gesetzt haben, können die Browser dieser User den Real-Time Insights-App Service nicht erreichen, obwohl der App Service in Betrieb ist. Lassen Sie diese User eine Verbindung über das private VNet oder ein Peering-VNet herstellen. Wenn Sie RtiAppService auf Restricted festlegen, können sie auch eine Verbindung von einem VNet auf der Zulassungsliste herstellen, bei dem es sich um ein Subnetz eines verlinkten Netzwerks handelt, für das der Dienst-Endpoint Microsoft.Web aktiviert ist. Alternativ können Sie den öffentlichen Zugriff auf den Real-Time Insights App Service im Azure-Portal zulassen.

  • Wenn die Ausführung von Scripted Actions nach dem Einschränken des Storage-Kontos für Scripted Actions beendet wird, stellen Sie den Ausführungsmodus von Azure Runbook auf Inline Script um. Siehe Scripted Actions für Azure Runbooks.

Größe des App Service-Subnetzes anpassen

Das Skript ändert nicht den Adressbereich eines bereits vorhandenen App Service-Subnetzes. Azure erfordert für die regionale VNet-Integration von App Service ein Subnetz mit /28 oder größer. Für die bis zu vier Apps, die in das Subnetz integriert werden, wird ein /26-Subnetz empfohlen: Nerdio Manager App Service, Intune Insights, Cost Calculator und Real-Time Insights. Frühere Versionen des Skripts erstellten ein /28-Subnetz. Der Standardwert ist jetzt ein /26-Subnetz.

Das Skript wird mit einem Fehler beendet, wenn das vorhandene Subnetz kleiner als ein /28-Subnetz ist. Bei einem /27- oder /28-Subnetz gibt es eine Warnung aus. Sie können den Bereich eines Subnetzes nicht erweitern, solange Apps in das Subnetz integriert sind.

Vorhandenes App Service-Subnetz erweitern
  1. Entfernen Sie im Azure-Portal die VNet-Integration von jeder App, die das Subnetz verwendet.

  2. Ändern Sie den Adressbereich des Subnetzes auf /26 oder größer.

  3. Führen Sie das Skript erneut aus. Das Skript integriert die Apps erneut in das Subnetz.

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich
Haben Sie Fragen? Anfrage einreichen

Kommentare (0 Kommentare)

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.