Führen Sie Kunden durch die Mandanteneinrichtung

Gilt für: ISV

Verwenden Sie diesen Artikel, um den Setupleitfaden zu erstellen, den Sie Kunden übergeben, die Ihre mehrinstanzenfähige SharePoint Embedded-App installieren. Der Kundenadministrator ist der Nutzen des Mandantenadministrators, der sharePoint Embedded-Anwendungen verwaltet, die im Microsoft 365-Mandanten registriert sind, und die Container, die Kundeninhalte enthalten.

Rolle "Kundenadministrator"

Informieren Sie Kunden darüber, wer das Setup durchführen soll. Ein Nutzen des Mandantenadministrators ist entweder ein globaler Administrator oder ein Benutzer, dem die SharePoint Embedded-Administratorrolle zugewiesen ist. Die Rolle ist in Microsoft Entra ID und im Microsoft 365 Admin Center verfügbar. Globale Administratoren verfügen bereits über diese Berechtigungen.

Informationen zu den Rollen finden Sie unter Installieren einer SharePoint Embedded-App.

Kundenvoraussetzungen

Bitten Sie den Kunden, diese Voraussetzungen vor der Setupbesprechung oder dem Installationsfenster zu bestätigen.

Benutzer benötigen keine Office-Lizenz, um an Microsoft Office-Dokumenten zusammenzuarbeiten, die in einem Container gespeichert sind.

Informationen, die dem Kunden gegeben werden sollen

Geben Sie die folgenden Werte in Ihrem Setupleitfaden an:

• Produktname.
• Herausgebername.
• Besitzer der Anwendungs-ID.
• Containertyp-ID.
• Name des Containertyps.
• Abrechnungsmodell.
• Microsoft Entra Berechtigungen, die Ihre App anfordert.
• Zustimmungsanweisungen für Ihre App.
• Umleitungs- oder Anmelde-URL, die von der App verwendet wird.
• Supportkontakt.
• Setupdauer erwartet.
• Validierungsschritte.

Anleitungen zur ISV-Vorbereitung finden Sie unter Vorbereiten Ihrer App für die Kundeninstallation.

Berechtigungen, die Ihre App anfordert

Informieren Sie Kunden genau, welche Microsoft Graph-Berechtigungen Ihre App benötigt und warum. SharePoint Embedded-Apps werden mit zwei Berechtigungen installiert.

Übersicht über das Setup für Kunden

Verwenden Sie diese allgemeine Sequenz in Ihrem Kundenleitfaden:

1. Weisen Sie die richtige Administratorrolle zu.
2. Überprüfen Sie den Herausgeber der App, die App-IDs und die angeforderten Berechtigungen.
3. Erteilen Sie bei Bedarf die Administratoreinwilligung.
4. Registrieren Sie den SharePoint Embedded-Containertyp im verbrauchenden Mandanten über den Setupflow Ihrer App.
5. Konfigurieren Sie bei Bedarf die Passthrough-Abrechnung.
6. Überprüfen Sie, ob die App dem Kundenadministrator angezeigt wird.
7. Erstellen Sie einen Testcontainer oder greifen Sie auf einen Testcontainer zu.
8. Vergewissern Sie sich, dass die App die erwarteten Dateivorgänge ausführen kann.
9. Entfernen oder beibehalten Sie Testinhalte gemäß der Validierungsrichtlinie des Kunden.

Schritt 1: Zuweisen des Administrators

Bitten Sie den Kunden, einen Administrator auszuwählen, der die vollständige Einrichtung abschließen kann. Wenn der Kunde keinen globalen Administrator verwenden möchte, kann er die Rolle SharePoint Embedded-Administrator zuweisen.

Weisen Sie den Kunden an, die Rollenzuweisung vor dem Installationsfenster abzuschließen. Dadurch werden Verzögerungen vermieden, wenn die Abrechnung oder Validierung erhöhte Zugriffsrechte erfordert.

Schritt 2: Überprüfen der Anwendung

Bitten Sie den Kundenadministrator, Folgendes zu überprüfen:

• Herausgeberidentität.
• Anwendungs-ID.
• Containertyp-ID.
• Angeforderte Berechtigungen (siehe Berechtigungen, die Ihre App anfordert).
• In SharePoint Embedded-Containern gespeicherte Daten.
• Gibt an, ob die App den Gastzugriff zulässt.
• Support- und Reaktionsverpflichtungen.
• Abrechnungsmodell.

Wenn Ihr Installationsablauf in Ihrem SaaS-Verwaltungsportal gehostet wird, schließen Sie Screenshots oder mandantenspezifische Werte in Ihre Übergabe ein, und halten Sie Links stabil, damit Kundenadministratoren den Leitfaden für die Produktion und Notfallwiederherstellung wiederverwenden können.

Schritt 3: Erteilen der Administratoreinwilligung

Der Kundenadministrator erteilt die Zustimmung für die Berechtigungen, die Ihre App benötigt. Dokumentieren Sie die genaue Zustimmungserfahrung für Ihre App, anstatt eine unformatierte Zustimmungs-URL zu senden, ohne zu erklären, was sie bewirkt.

Geben Sie dem Kunden diese Anleitung:

1. Melden Sie sich mit dem Kundenadministratorkonto an.
2. Öffnen Sie die Von Ihnen bereitgestellte App-Einrichtungs- oder Zustimmungserfahrung.
3. Überprüfen Sie den Herausgeber und die angeforderten Berechtigungen.
4. Erteilen Sie die Zustimmung nur, wenn der Herausgeber und die Berechtigungen mit der Kundenaushändigung übereinstimmen.
5. Notieren Sie sich die Zeit und den Administrator, der die Zustimmung abgeschlossen hat.

Kundenadministratoren sollten ihre Zustimmung nur für die genaue App-ID in Ihrem signierten Installationspaket erteilen. Die Zustimmung zu einer anderen App-ID ist ein Sicherheitsrisiko.

Schritt 4: Registrieren des Containertyps

Bevor die App Container erstellen und verwenden kann, muss der Containertyp im nutzenden Mandanten registriert werden. Da dieser Flow app-spezifisch ist, verknüpfen Sie Kunden mit der Einrichtungsoberfläche Ihres Produkts und der aktuellen Registrierungsdokumentation.

Bitten Sie den Kunden, folgendes zu bestätigen:

• Der Setupflow verwendet die erwartete besitzernde Anwendungs-ID.
• Die Registrierung zielt auf die erwartete Containertyp-ID ab.
• Die Registrierung wird im Mandanten des Kunden abgeschlossen.
• Jede Fehlermeldung wird mit Zeit-, Mandanten- und Korrelationsinformationen erfasst, sofern verfügbar.

Schritt 5: Einrichten der Abrechnung bei Bedarf

Überspringen Sie diesen Schritt, wenn Ihre App die Standardabrechnung verwendet. Wenn Ihre App passthrough-Abrechnung verwendet, teilen Sie dem Kunden mit, dass die SharePoint Embedded-Abrechnung konfiguriert werden muss, bevor Benutzer auf die App zugreifen können.

Der Kunde benötigt ein gültiges Azure Abonnement und eine Ressourcengruppe. Ein globaler Administrator richtet die Abrechnung im Microsoft 365 Admin Center ein, und der Administrator, der die Abrechnungsbeziehung erstellt, benötigt auch die Rolle Besitzer oder Mitwirkender für das Azure Abonnement. Richten Sie dann die Abrechnung ein:

1. Öffnen Sie die Microsoft 365 Admin Center.
2. Wechseln Sie zu Setup.
3. Wählen Sie in Files und Inhalt die Option Inhalt mit Microsoft Syntex automatisieren aus.
4. Wählen Sie Zu Syntex-Einstellungen wechseln aus.
5. Wählen Sie unter Syntex-Dienste fürdie Option Apps aus.
6. Wählen Sie SharePoint Embedded aus.
7. Befolgen Sie die Anweisungen auf der SharePoint Embedded-Seite , um SharePoint Embedded-Apps zu aktivieren.

Schritt 6: Überprüfen der Sichtbarkeit der Verwaltung

Nachdem die Zustimmung, Registrierung und Abrechnung abgeschlossen sind, bitten Sie den Kundenadministrator, zu bestätigen, dass die App verwaltet werden kann. Administratoren können sharePoint Admin Center und andere Verwaltungstools verwenden, um SharePoint Embedded-Anwendungen und -Container zu verwalten.

Kundenadministratoren haben folgende Möglichkeiten:

• Auflisten von Anwendungen im Mandanten.
• Auflisten von Containern einer Anwendung.
• Anzeigen von Containerdetails
• Anzeigen von aktiven und gelöschten Containern in Administratorumgebungen.
• Verwalten Sie Vertraulichkeitsbezeichnungen und Freigabeeinstellungen, sofern unterstützt.
• Überprüfen Sie das Sicherheits- und Complianceverhalten.

Ausführlichere Überprüfungsschritte finden Sie unter Überprüfen der Installation der Kunden-App.

Prüfliste für die Kundeneinrichtung

Geben Sie Kunden eine Checkliste, die sie abzeichnen können.

• [ ] Der zugewiesene Administrator verfügt über die Rolle "Globaler Administrator" oder "SharePoint Embedded-Administrator".
• [ ] Die App-ID und der Herausgeber stimmen mit der ISV-Übergabe überein.
• [ ] Admin Zustimmung für die erwartete App erteilt wird.
• [ ] Der Containertyp wird im verbrauchenden Mandanten registriert.
• [ ] Bei Bedarf wird die Passthrough-Abrechnung konfiguriert.
• [ ] Ein Testbenutzer kann sich bei der App anmelden.
• [ ] Ein Testcontainer kann erstellt oder geöffnet werden.
• [ ] Ein Testdokument kann hochgeladen, gelesen und gelöscht werden.
• [ ] Der Kundenadministrator kann die App oder Container in Verwaltungstools anzeigen.
• [ ] Validierungshinweise und Supportkontakte werden aufgezeichnet.

Problembehandlung während des Setups

Verwenden Sie diese Tabelle, um Probleme mit der frühen Einrichtung weiterzuleiten.

Nächste Schritte

Überprüfen Sie nach dem Setup die Installation mit dem Kundenadministrator: Überprüfen der Installation der Kunden-App.