Zum Inhalt springen

Installation von Smarter Visitor Registration

Von der Bereitstellung in Azure bis zum ersten Login: welche Ressourcen entstehen, welche Rechte nötig sind und wie Sie die Anwendung in Betrieb nehmen.

So läuft die Installation ab

Smarter Visitor Registration wird direkt aus dem Azure Marketplace in Ihrem eigenen Azure-Abonnement bereitgestellt. Der Assistent legt die Azure-Ressourcen an, installiert das zertifizierte Anwendungspaket und wartet, bis die Anwendung erreichbar ist. Planen Sie bei vorbereiteten Berechtigungen etwa 20 bis 30 Minuten ein.

Nur die Microsoft-Entra-Schritte vor und nach der Bereitstellung werden einmalig mit unseren Skripten ausgeführt. Im normalen Marketplace-Ablauf benötigen Sie weder eine lokale ARM-Vorlage noch einen manuellen ZIP-Upload. Marketplace-Installation im Azure-Portal öffnen.

1

Vorabprüfung: Abonnement, Namen und Provider

Prüfen Sie diese Punkte vor der App-Registrierung und dem ersten Klick auf „Erstellen“. Ein Microsoft-365-Mandant allein ist noch kein Azure-Abonnement. Die folgenden Befehle gehören in Azure Cloud Shell mit Bash.

PrüfungVorgehen
Abonnement und AbrechnungAktives Azure-Abonnement im richtigen Firmenmandanten und geklärte Abrechnung. Free Trial garantiert keine B1-Kapazität. „Azure Plan“ allein beweist nicht, dass alle Einschränkungen aufgehoben sind.
App-Service-QuotaIm Portal nach Quotas suchen, App Service (Public Preview) und die Zielregion wählen – nicht Compute. Für B1 muss mindestens eine zusätzliche Instanz verfügbar sein; auch das regionale Gesamtlimit muss ausreichen. Bei SubscriptionIsOverQuotaForSku mit Limit 0 mindestens Gesamtlimit 1 beantragen. Bei „ineligible“ zuerst Tarif/Abrechnung mit dem Billing-Verantwortlichen klären.
Free-Trial-UpgradeIm betroffenen Abonnement unter Übersicht „Upgrade subscription“ oder das Upgrade-Banner verwenden. Fehlt der Einstieg, den Billing-Verantwortlichen bzw. Azure-Abrechnungssupport einbeziehen; nicht allein deshalb eine neue Subscription anlegen. Pay-as-you-go erlaubt kostenpflichtige Nutzung. Ein Upgrade garantiert weder sofortige Quota noch regionale Kapazität.
Firmenbezogene NamenNicht einfach visitorreg übernehmen. Beispiel: Präfix firma-vr-gwc-01, Web-App firma-visitor-gwc-01, RG rg-firma-vr-gwc-01. Beispiele sind nicht reserviert. Das Präfix erzeugt unter anderem global eindeutige Cosmos-/Key-Vault-Namen; auch der Web-App-Name muss weltweit frei sein. Namen vor dem Vorbereitungsskript festlegen.
Aktive RechteAzure-RBAC und Entra-Rollen sind getrennt. Bei PIM reicht „Eligible“ nicht: die benötigte Rolle im richtigen Tenant für den ausführenden Benutzer aktivieren. Nach Aktivierung frisch anmelden. Bei Fehlern den tatsächlichen Ausführungskontext prüfen, nicht pauschal weitere Rollen vergeben.

Resource Provider prüfen

Der erste Block liest nur das aktive Abonnement und die Provider-Statuswerte. Die Liste umfasst Web-App, Cosmos DB, Identitäten, Key Vault, Monitoring einschließlich Microsoft.OperationalInsights für Log Analytics sowie Storage und Container Instances für die Paketinstallation. Nur im vorgesehenen Kundenabonnement fortfahren.

Bash – nur prüfen, noch nichts ändern
az account show --query "{subscription:name,id:id,tenant:tenantId}" -o table

for provider in Microsoft.Web Microsoft.DocumentDB Microsoft.ManagedIdentity Microsoft.KeyVault Microsoft.Insights Microsoft.OperationalInsights Microsoft.Storage Microsoft.ContainerInstance; do
  az provider show --namespace "$provider" \
    --query "{Provider:namespace,Status:registrationState}" -o table || break
done

Nur falls Provider fehlen: Der nächste Block registriert diese Dienste im aktiven Abonnement. Er erstellt keine Web-App oder Datenbank und erteilt keine Graph-Zustimmung. Die Registrierung braucht eine Berechtigung auf Subscription-Ebene (z. B. Contributor/Owner); Rechte nur auf der Ressourcengruppe reichen nicht.

Bash – fehlende Provider registrieren
for provider in Microsoft.Web Microsoft.DocumentDB Microsoft.ManagedIdentity Microsoft.KeyVault Microsoft.Insights Microsoft.OperationalInsights Microsoft.Storage Microsoft.ContainerInstance; do
  state=$(az provider show --namespace "$provider" --query registrationState -o tsv) || break
  if [ "$state" != "Registered" ]; then
    echo "Registering $provider (current status: $state)"
    az provider register --namespace "$provider" || break
  else
    echo "$provider: Registered"
  fi
done

Fortschritt sichtbar prüfen

Die Registrierung läuft asynchron. Führen Sie danach den Prüfblock erneut aus. Als einfache Vorabkontrolle warten Sie auf „Registered“. „Registering“ bedeutet nicht automatisch einen Fehler; Azure registriert Regionen einzeln. Es gibt keine feste Wartezeit. Bei Fehlern nicht weiterdeployen, sondern Fehlertext und Zielabonnement prüfen.

Microsoft-Hilfe: Resource Provider, App-Service-Quotas und Free-Trial-Upgrade.

2

Was die beiden SBS-Skripte verändern

Laden Sie die Skripte über die Links dieser Anleitung herunter und öffnen Sie sie vor dem Ausführen im Editor. Die Cloud-Shell-Hilfe erklärt Download und Ausführung. Es sind administrative Änderungen im eigenen Mandanten, keine reinen Prüfskripte.

Skript / ZeitpunktÄnderungen und Zweck
prepare-app-registration – vor dem DeploymentErstellt bzw. aktualisiert die Entra-App „Visitor Registration <Präfix>“ und ihren Service Principal. Setzt Anmelde-/Redirect-Adressen, API-Scope, angeforderte delegierte Graph-Rechte und Office-/Teams-Vorautorisierungen; gibt die Client-ID aus. Erstellt keine Azure-Hostingressourcen und erteilt noch keine tenantweite Graph-Zustimmung.
grant-graph-permissions – nach dem DeploymentLiest die Identität <Präfix>-identity aus der angegebenen RG und vergibt User.Read.All und Group.Read.All als Graph-Anwendungsrechte: tenantweiter Lesezugriff auf Benutzer/Gruppen ohne angemeldeten Benutzer. Mit übergebener Client-ID erteilt/aktualisiert es außerdem die tenantweite Zustimmung für die dokumentierten delegierten Rechte einschließlich Mail.Send. Kein Versand von E-Mails durch das Skript selbst.

Ziel und Rechte vor Ausführung prüfen

Beim Vorbereitungsskript wird eine vorhandene Registrierung mit gleichem Anzeigenamen wiederverwendet und ihre Konfiguration aktualisiert. Deshalb eigene Präfixe pro Umgebung verwenden; keine fremde oder produktive App für einen neuen Test angeben. Beim zweiten Skript die Client-ID immer mitgeben. Die Skripte löschen keine Besucherdaten, verändern aber Anmeldung und Berechtigungen. Benötigte Entra-Rollen: Application/Cloud Application Administrator für die Vorbereitung; Privileged Role Administrator für Graph-Anwendungsrechte (Global Administrator ist ebenfalls berechtigt). Azure Owner allein genügt dafür nicht.

3

Fehlerfall: Redeploy oder neue Region?

Öffnen Sie in der Bereitstellung den fehlgeschlagenen Unter-Schritt und dessen „Error details“/„Raw error“. DeploymentFailed oder Conflict allein nennen noch keine Ursache. Notieren Sie Fehlercode, Region und Correlation ID; keine Secrets oder SAS-Token weitergeben.

FehlerNächster Schritt
Provider nicht registriertDen im Fehler genannten benötigten Provider registrieren, insbesondere Microsoft.OperationalInsights bei Monitoring. Danach mit unveränderten Werten erneut bereitstellen.
B1 VMs: 0 / SubscriptionIsOverQuotaForSkuQuota bzw. Subscription-Berechtigung klären (siehe Vorabprüfung). Providerregistrierung und Admin Consent lösen keine Quota-Probleme. Erst nach ausreichendem Kontingent erneut bereitstellen.
Cosmos DB: high demand in North Europe region … cannot fulfill your requestDie konkrete Meldung bezeichnet eine Azure-seitige regionale Kapazitäts-/Zugangsbeschränkung, keinen Fehler der Besucher-Anwendung. Andere zulässige Region prüfen oder Microsofts Regionszugang/Support nutzen. Germany West Central ist eine mögliche Alternative, aber keine Kapazitätsgarantie.
Authorization_RequestDenied / graphPermissions-deploymentAktive Entra-Rolle, Tenant und tatsächlich ausführende Identität prüfen. Admin Consent der App-Registrierung und Graph-Anwendungsrechte der Managed Identity sind verschiedene Zuweisungen. Nach frischer Anmeldung Fehler erneut prüfen; bleibt er bestehen, vollständigen Unterfehler an SBS senden.
Cosmos-Konto bereits im Status FailedNicht in einer Schleife redeployen. Den ursprünglichen Erstellungsfehler klären. Nur wenn Azure ausdrücklich eine Neuerstellung verlangt und es eine leere, fehlgeschlagene Erstinstallation ist, das konkret betroffene Konto nach Prüfung löschen. Niemals ein Konto mit Daten ohne Sicherungs-/Migrationsplan löschen.

Redeploy in derselben Region

Nach behobener Ursache dieselbe Subscription, RG, Region, dasselbe Präfix, denselben Web-App-Namen, dieselbe Client-ID und Admin-Objekt-ID verwenden. Den gespeicherten Session/JWT-Schlüssel erneut eingeben. Erfolgreiche Ressourcen stehen lassen. Sichere Parameter werden nicht unbedingt übernommen; leere Artefakt-SAS-Felder nicht blind als korrekt ansehen und keine Paket-URLs improvisieren. Bei unklaren Artefaktparametern SBS kontaktieren.

  1. Regionswechsel bei einer fehlgeschlagenen Erstinstallation: Nicht nur „Location“ im Redeploy ändern. Eine neue leere RG, ein neues firmenbezogenes Präfix und einen neuen weltweit eindeutigen Web-App-Namen für die andere Region wählen.
  2. Zuerst Quota und Provider prüfen. Das Vorbereitungsskript mit den neuen Namen ausführen und die dafür ausgegebene Client-ID verwenden. Danach eine neue Marketplace-Bereitstellung starten.
  3. Die neue Installation einschließlich Anmeldung prüfen. Erst anschließend alte Testressourcen auf Daten, Fremdnutzung und Kosten kontrollieren und gezielt aufräumen. Eine gesamte alte RG nur löschen, wenn sie ausschließlich zu diesem gescheiterten Test gehört und keine benötigten Daten enthält.
  4. Eine Entra-App-Registrierung wird beim Löschen einer RG nicht mitgelöscht; veraltete Testregistrierungen separat nach Prüfung entfernen lassen. Parallel vorhandene Ressourcen können Kosten verursachen. Für bestehende Produktivdaten ist ein geplanter Umzug nötig, keine Neuinstallation mit anschließendem Löschen.
4

Voraussetzungen

BereichAnforderung
AzureBesitzer der Ziel-Ressourcengruppe beziehungsweise des Abonnements – alternativ Mitwirkender plus Benutzerzugriffsadministrator. Die Vorlage weist einer temporären Bereitstellungsidentität eine eng begrenzte Rolle zu.
Microsoft Entra IDAnwendungsadministrator zum Anlegen der App-Registrierung sowie Administrator für privilegierte Rollen oder Globaler Administrator für Graph-Anwendungsrollen und Administratorzustimmung.
ArbeitsplatzEmpfohlen: Azure Cloud Shell mit Bash. Alternativ Azure CLI und die unten verlinkten Bash- oder PowerShell-Skripte lokal.
Microsoft 365Exchange Online für Outlook-Add-in und E-Mail-Versand, optional Microsoft Teams.
Objekt-ID des ersten AdministratorsDie Entra-Objekt-ID der Person, die die Ersteinrichtung durchführt. Sie finden sie im Entra Admin Center im Benutzerprofil oder mit az ad signed-in-user show --query id -o tsv.
Geheimer SitzungsschlüsselEine zufällige Zeichenfolge mit mindestens 32 Zeichen, etwa aus openssl rand -hex 32.
Azure-RegionEine Region mit App Service, Cosmos DB Serverless, Azure Container Instances und einem Storage Account. Zuerst Quota prüfen; bei Kapazitätsengpässen die Hinweise zum Regionswechsel oben beachten.

Ohne Objekt-ID kein erster Login

Solange keine Admin-Gruppe eingerichtet ist, dürfen nur die bei der Bereitstellung angegebenen Objekt-IDs die Einstellungen öffnen. Bleibt der Wert leer, kann niemand die Ersteinrichtung durchführen.

5

Was in Azure entsteht

RessourceZweck
App Service (Linux, Node.js 22)Die Web-Anwendung mit Terminal, Einstellungen, Auswertungen und der Schnittstelle für das Outlook-Add-in. Nur HTTPS, mindestens TLS 1.2.
Azure Cosmos DB (Serverless)Datenbank mit den Containern für geplante Termine, Besucherkontakte, Check-ins, Einstellungen, Änderungsprotokoll und Dateien.
Verwaltete IdentitätLiest über Microsoft Graph Gruppenmitgliedschaften und Benutzer (Anwendungsrollen Group.Read.All und User.Read.All). Es wird kein Client-Secret benötigt.
App-RegistrierungAnmeldung für Browser, Outlook und Teams. Stellt den Bereich access_as_user bereit; Outlook und Teams sind dafür bereits vorautorisiert.
Application Insights (optional)Protokolle und Telemetrie für den Betrieb.
Key Vault (optional)Speichert Datenbankschlüssel und Sitzungsschlüssel statt in den App-Einstellungen.

Die laufenden Azure-Kosten hängen von Tarif und Nutzung ab. In der kleinsten Ausbaustufe (App Service B1, Cosmos DB Serverless) liegen sie als Richtwert bei rund 20 Euro pro Monat. Microsoft rechnet diese Azure-Ressourcen direkt mit Ihnen ab.

Lizenzierung und Abrechnung

Das aktuelle Marketplace-Angebot ist eine Azure-Anwendung (Solution Template). Die Bereitstellung startet den Testzeitraum der SBS-Lizenzprüfung, erzeugt aber keine automatische Marketplace-Abrechnung für die SBS-Lizenz. Die Lizenzseite in der Anwendung zeigt Status, Laufzeit und die Zahl der konfigurierten Standorte.

6

App-Registrierung vorbereiten

Die Anwendung meldet Benutzer über eine App-Registrierung in Microsoft Entra an (Browser, Outlook, Teams). Azure Marketplace kann diese Registrierung nicht im Mandanten anlegen. Wählen Sie zuerst den endgültigen Web-App-Namen und das Bereitstellungspräfix, melden Sie die Azure CLI im Zielmandanten an und führen Sie anschließend das Vorbereitungsskript aus.

Noch unsicher bei az oder Bash?

Öffnen Sie die Schritt-für-Schritt-Hilfe für Azure Cloud Shell und Azure CLI. Sie benötigen damit keine lokale CLI-Installation und erhalten kopierfertige Befehle für beide SBS-Skripte.

Mit Zielmandant und Zielabonnement verbinden
az login --tenant <Mandanten-ID>
az account set --subscription <Abonnement-ID>
az account show --query "{subscription:name, tenant:tenantId, user:user.name}" -o table
Azure CLI, angemeldet mit einem Konto, das App-Registrierungen anlegen darf
# Bash
./prepare-app-registration.sh <web-app-name> <deploymentName>

# PowerShell
.\prepare-app-registration.ps1 -WebAppName <web-app-name> -DeploymentName <deploymentName>

Verwenden Sie denselben Web-App-Namen und dasselbe Präfix wie später in der Bereitstellung. Das Skript legt die Registrierung „Visitor Registration <deploymentName>“ mit Redirect-URIs, dem Bereich access_as_user, der Vorautorisierung für Outlook und Teams und der Identifier-URI api://<name>.azurewebsites.net/<Client-ID> an und gibt die Client-ID aus. Ein zweiter Lauf aktualisiert die vorhandene Registrierung. Download: prepare-app-registration.sh, prepare-app-registration.ps1.

Client-ID für den Marketplace-Assistenten notieren

Das Skript gibt die Client-ID aus. Kopieren Sie sie für die Bereitstellung. Verwenden Sie keine App-Registrierung aus einem anderen Mandanten oder einer früheren Testinstallation.

7

Über Azure Marketplace bereitstellen

Öffnen Sie das Angebot Smarter Visitor Registration – Standard im Azure-Portal und wählen Sie Erstellen. Eine neue, leere Ressourcengruppe wird empfohlen.

Azure-Marketplace-Assistent im Schritt Grundlagen mit Abonnement, Ressourcengruppe, Region, Bereitstellungspräfix und Web-App-Namen
Unter „Grundlagen“ wählen Sie das Abonnement, eine neue Ressourcengruppe, die Region sowie eindeutige Namen für Bereitstellung und Web-App.
Schritt im AssistentenEingabe oder Empfehlung
GrundlagenZielabonnement, neue Ressourcengruppe und Azure-Region. Für Tests hat sich „Germany West Central“ bewährt.
Bereitstellungspräfix3 bis 20 Kleinbuchstaben, Zahlen oder Bindestriche; firmen- und umgebungsbezogen, zum Beispiel firma-vr-gwc-01. Nicht das generische visitorreg übernehmen; siehe Vorabprüfung.
Web-App-NameWeltweit eindeutiger Name. Er wird Teil der Adresse https://<name>.azurewebsites.net und muss exakt dem Wert aus dem Vorbereitungsskript entsprechen.
Azure-KonfigurationApp Service „Basic B1“, Cosmos DB „Serverless“, Application Insights und Key Vault aktiviert lassen.
Erster AdministratorObjekt-ID der Person, die anschließend den Einrichtungsassistenten öffnet.
Entra-AnwendungClient-ID aus prepare-app-registration.
SitzungsschlüsselZufälligen Wert mit mindestens 32 Zeichen zweimal eingeben.
Azure-Konfiguration mit App Service Basic B1, Cosmos DB Serverless, Application Insights und Key Vault
Die empfohlenen Startwerte: App Service B1, Cosmos DB Serverless sowie Application Insights und Key Vault aktiviert.
Marketplace-Schritt Identität und Sicherheit mit Feldern für Administrator-Objekt-ID, Entra-Client-ID und Sitzungsschlüssel
Unter „Identität und Sicherheit“ tragen Sie die Objekt-ID des ersten Administrators, die zuvor erzeugte Client-ID und einen neuen Sitzungsschlüssel ein.

Keine Paketpfade oder ZIP-Dateien angeben

Azure Marketplace setzt den signierten Artefaktpfad automatisch. Verändern Sie _artifactsLocation und _artifactsLocationSasToken nicht. Im normalen Marketplace-Ablauf sind weder az deployment group create noch az webapp deploy erforderlich.

Wählen Sie Überprüfen + erstellen und danach Erstellen. Die Bereitstellung dauert gewöhnlich 10 bis 15 Minuten. Der letzte längere Schritt heißt <präfix>-install-package: Er installiert das zertifizierte Paket und wartet auf den Health-Endpunkt.

Die Adresse ist fest mit der Installation verbunden

Anmeldung, Outlook-Manifest und Teams-App verwenden die Adresse <name>.azurewebsites.net. Wählen Sie den Namen der Web-App deshalb mit Bedacht. Eine eigene Domain erfordert zusätzliche Anpassungen an der App-Registrierung – sprechen Sie uns dazu an.

8

Bereitstellung prüfen

Nach einer erfolgreichen Marketplace-Bereitstellung ist die Anwendung bereits installiert. Prüfen Sie zuerst den öffentlichen Health-Endpunkt:

curl https://<name>.azurewebsites.net/api/health

Erwartete Antwort

{"status":"ok","timestamp":"…"} mit HTTP-Status 200. Öffnen Sie anschließend https://<name>.azurewebsites.net/.

Sicher erneut ausführbar

Scheitert nur der Schritt <präfix>-install-package, öffnen Sie dessen Protokoll in der Ressourcengruppe. Die Bereitstellung kann mit denselben Werten erneut gestartet werden; die Vorlage ist idempotent.

9

Graph-Rechte und Administratorzustimmung

Führen Sie nach der Marketplace-Bereitstellung einmalig das zweite Skript aus. Es weist der verwalteten Identität die benötigten Microsoft-Graph-Anwendungsrollen zu und erteilt der App-Registrierung die tenantweite Administratorzustimmung.

Bash oder PowerShell
# Bash
./grant-graph-permissions.sh <Ressourcengruppe> <Bereitstellungspräfix> <Client-ID>

# PowerShell
.\grant-graph-permissions.ps1 -ResourceGroup <Ressourcengruppe> -DeploymentName <Bereitstellungspräfix> -ClientId <Client-ID>

Erwartete Ausgabe

Group.Read.All: assigned, User.Read.All: assigned und admin consent granted. Die neuen Rechte können einige Minuten benötigen, bevor Microsoft Graph sie verwendet.

BerechtigungArtWofür
User.Read, User.ReadBasic.All, People.ReaddelegiertAnmeldung und Personensuche
Group.Read.AlldelegiertGruppenauswahl in den Einstellungen
Mail.SenddelegiertE-Mails an Besucher im Namen des Terminal-Kontos
Group.Read.All, User.Read.AllAnwendung (verwaltete Identität)Gruppenmitgliedschaften prüfen, Ansprechpersonen für Teams-Anrufe auflösen

Manuelle Kontrolle im Entra Admin Center

Die delegierten Rechte sehen Sie unter App-Registrierungen › Visitor Registration <präfix> › API-Berechtigungen. Die Anwendungsrollen der verwalteten Identität sehen Sie unter Unternehmensanwendungen › <präfix>-identity › Berechtigungen.

10

Erster Login und Einrichtungsassistent

Öffnen Sie https://<name>.azurewebsites.net/admin und melden Sie sich mit dem Konto an, dessen Objekt-ID Sie bei der Bereitstellung angegeben haben. Solange die Lösung nicht eingerichtet ist, startet der Assistent.

Einrichtungsassistent mit dem ersten Schritt Grundkonfiguration
Der Assistent führt in vier Schritten durch die Ersteinrichtung.

1. Grundkonfiguration

Name und Zeitzone des ersten Standorts. Optional die Admin-Gruppe – Sie können sie auch später setzen.

2. Standorte

Weitere Standorte mit Terminal-Benutzern und Verhalten beim Check-in anlegen.

3. Branding

Firmenname, Logo und Farben des Terminals.

4. Zeitüberschreitungen

Wie lange Erfolgsmeldungen stehen bleiben und wann das Terminal zur Startseite zurückkehrt.

Mit Einrichtung abschließen speichert der Assistent die Angaben und öffnet das Terminal. Alle Werte können Sie später in den Einstellungen ändern.

Admin-Gruppe nicht vergessen

Tragen Sie unter Einstellungen › Sicherheit eine Entra-Gruppe als Admin-Gruppe ein und prüfen Sie, dass Sie selbst Mitglied sind. Sobald die Gruppe gesetzt ist, gelten die Objekt-IDs aus der Bereitstellung nicht mehr.

11

Nächste Schritte

  1. Standorte einrichten: Terminal-Benutzer, Richtlinien und E-Mails.
  2. Outlook-Add-in veröffentlichen und verteilen.
  3. Terminal als Kiosk einrichten, im Browser oder in Microsoft Teams.
  4. Den ersten Besuch testen.
12

Updates und Betrieb

  • Update der Anwendung: Folgen Sie den Versionshinweisen. Eine neue Marketplace-Version kann mit denselben Ressourcennamen erneut bereitgestellt werden; Einstellungen und Daten bleiben in Cosmos DB erhalten.
  • Änderungen an der Infrastruktur: Die Marketplace-Bereitstellung mit denselben Werten erneut ausführen, etwa um den Tarif zu wechseln. Löschen Sie die Ressourcengruppe nicht.
  • Version prüfen: Die installierte Version steht in der Fußzeile der Einstellungen und Auswertungen.
  • Sicherung: Cosmos DB sichert die Daten automatisch in regelmäßigen Abständen. Für längere Aufbewahrung passen Sie die Sicherungsrichtlinie des Datenbankkontos an.
  • Überwachung: Der App Service prüft die Anwendung über /api/health. Fehler und Protokolle finden Sie in Application Insights.

Nach einem Update

Wenn sich das Outlook-Add-in oder die Teams-App geändert hat, steht das in den Versionshinweisen. Veröffentlichen Sie dann das Manifest erneut beziehungsweise laden Sie das neue Teams-Paket mit erhöhter Versionsnummer hoch.

13

Fehlerbehebung

Nach der Anmeldung steht „Sie sind angemeldet, aber für diesen Bereich nicht berechtigt“.

Ihr Konto ist weder Administrator noch Terminal-Benutzer. Bei der Ersteinrichtung: Prüfen Sie, ob Ihre Objekt-ID in der App-Einstellung ADMIN_BOOTSTRAP_OBJECT_IDS des App Service steht. Danach: Prüfen Sie Ihre Mitgliedschaft in der Admin-Gruppe.

App-Registrierung oder Graph-Auswahl funktionieren nicht.

Prüfen Sie, ob prepare-app-registration im richtigen Mandanten lief und im Marketplace dieselbe Web-App sowie dasselbe Präfix verwendet wurden. Führen Sie nach der Bereitstellung grant-graph-permissions mit einem Administrator für privilegierte Rollen oder Globalen Administrator aus. Die Cloud-Shell-Hilfe erklärt die häufigsten CLI-, Tenant- und Berechtigungsfehler.

Der Name der Web-App ist bereits vergeben.

Namen unter azurewebsites.net sind weltweit eindeutig. Wählen Sie einen anderen Wert für webAppName.

Die Bereitstellung scheitert bei install-package.

Öffnen Sie in der Ressourcengruppe <präfix>-install-package › Protokolle. Verändern Sie keine Marketplace-Artefaktparameter und laden Sie kein ZIP manuell hoch. Starten Sie die Bereitstellung mit denselben Werten erneut oder senden Sie uns die Fehlermeldung.

Cosmos DB Serverless ist in der Region nicht verfügbar.

Prüfen Sie den genauen Unterfehler. Bei regionalem Kapazitätsmangel siehe Redeploy oder neue Region. Die Vorlage verwendet Serverless; „Bereitgestellt“ ist kein einfacher Schalter im Assistenten.

Besucher erhalten keine E-Mails.

Prüfen Sie, ob die Administratorzustimmung für Mail.Send erteilt ist, ob das Terminal-Konto ein Postfach hat und ob der Versand am Standort aktiviert ist. In der Teams-Desktop-App ist zusätzlich das Client-Secret nötig.

Die Anwendung startet nicht oder antwortet mit Fehler 500.

Prüfen Sie zuerst /api/health, danach <präfix>-install-package › Protokolle und den Protokolldatenstrom des App Service. Senden Sie uns die Fehlermeldung, bevor Sie App-Einstellungen oder Pakete manuell ändern.

Fragen zu diesem Produkt?

Unser Support-Team hilft Ihnen bei Fragen zu Smarter Visitor Registration gerne weiter.