Apps für freigegebene und private Kanäle

Freigegebene und private Kanäle in Microsoft Teams ermöglichen eine flexible Zusammenarbeit innerhalb von Teams und organisationenübergreifend. Derzeit werden Bot- und Registerkarten-Apps in freigegebenen und privaten Kanälen unterstützt. Die Verwendung dieses Updates bietet mehrere Vorteile:

• Freigegebene Kanäle: Ermöglichen Sie eine nahtlose Kommunikation mit internen oder externen Mitgliedern, ohne den Kontext des Benutzers zu ändern. Diese Kanäle gewährleisten eine sichere präzise Zugriffssteuerung und die Synchronisierung von Mitgliedschaften in Echtzeit.

• Private Kanäle: Stellen Sie sicheren Raum für ausgewählte Teammitglieder bereit, um an vertraulichen oder vertraulichen Inhalten zusammenzuarbeiten, um Datenschutz und fokussierte Diskussionen innerhalb des Teams zu gewährleisten.

Grundlegendes zu Kanälen für die App-Integration

Verschiedene Kanäle bestimmen die Sichtbarkeit von Apps, den Benutzerzugriff und das Datenspeicherungsverhalten:

Kanalübergreifende Funktionen

Hier sehen Sie eine Übersicht über die verschiedenen Kanäle und ihre Funktionen für verschiedene Parameter:

Verstehen, wie verschiedene Kanäle die App-Funktionalität bestimmen

Stellen Sie sicher, dass Sie verstehen, wie verschiedene Kanäle app-Funktionalität, Mitgliedschaft, Speicher oder Datenschutz bestimmen. Andernfalls kann es zu einer fehlerhaften Funktionalität oder einer unbeabsichtigten Offenlegung von Daten kommen:

• Verwenden von kanalspezifischen Mitgliedschafts-APIs

  Gehen Sie nicht davon aus, dass die Teammitgliedschaft gleich der Kanalmitgliedschaft ist. Nur Mitglieder, die Sie dem Kanal hinzufügen, können an freigegebenen und privaten Kanälen teilnehmen.

• Unterscheiden zwischen Benutzern und Rollen

  Kanalmitglieder können mandanteninterne Benutzer, Gäste oder mandantenübergreifende Benutzer (externe Benutzer von anderen Mandanten) umfassen. Wenn Ihre App zwischen verschiedenen Benutzern unterscheiden muss, um den Zugriff, die Datensichtbarkeit und die Featureverfügbarkeit zu verwalten, müssen Sie Benutzerrollen und Mandanten-IDs überprüfen, bevor Sie Berechtigungen erteilen.

• Gehen Sie nicht von einer einzelnen SharePoint-Website aus, die an ein Team gebunden ist

  Im Gegensatz zu Standardkanälen, die eine SharePoint-Website für das Team freigeben, verfügen private und freigegebene Kanäle über eigene SharePoint-Websites. Verwenden Sie immer die richtige URL für jeden Kanal, um fehlende Dateien oder Fehler beim nicht autorisierten Zugriff zu vermeiden.

• Beibehalten des Datenbereichs für Kanäle

  Aggregieren oder Cross-Post-Daten über Kanäle hinweg nur bei Bedarf, um versehentliche Lecks zu verhindern. Beispielsweise sollten Analyse-Apps keine privaten Kanaldaten in teamweiten Berichten enthalten, es sei denn, die Berechtigungen sind klar definiert.

Zurück zum Anfang

Aktivieren von Apps für freigegebene und private Kanäle

Die meisten Apps können freigegebene und private Kanäle mit einem einfachen Manifestupdate unterstützen. Entscheiden Sie sich basierend auf einem der folgenden Szenarien für den Ansatz:

• Apps ohne Abhängigkeit von angegebenen Parametern
• Apps mit Abhängigkeit von angegebenen Parametern

Apps ohne Abhängigkeit von angegebenen Parametern

Wenn Ihre App dies nicht tut:

• Verwenden der Kanal- oder Teammitgliedschaft zum Bestimmen der Nachrichtenübermittlung, Aufgabenzuweisung oder Berechtigungen
• Zugreifen auf oder Verwalten von Dateien, die in Teams oder SharePoint gespeichert sind
• Kombinieren oder Freigeben von Daten über mehrere Kanäle oder Teams hinweg
• Anpassen der Benutzeroberfläche basierend auf Benutzern (intern, Gäste oder externe Mitglieder)

Dann müssen Sie nur folgendes ausführen:

1. Hinzufügen supportsChannelFeaturesvon : tier1 zu Ihrem App-Manifest
2. Überprüfen Sie das erwartete Verhalten, und testen Sie Ihre App kanalübergreifend.

Es besteht keine Abhängigkeit von klassischem Und Administratorzugriff für supportsChannelFeatures: tier1.

Apps mit Abhängigkeit von angegebenen Parametern

Wenn Ihre App erweiterte Szenarien verarbeitet oder von den angegebenen Parametern abhängig ist, die im Abschnitt Apps ohne Abhängigkeit von angegebenen Parametern aufgeführt sind, lesen Sie diesen Leitfaden, um gezielte Updates und die bewährten Methoden zu erhalten. Schreiben Sie Ihren Code nicht neu.

Abrufen des Kontexts für freigegebene und private Kanäle

Verwenden Sie beim Laden der Benutzeroberfläche in einem freigegebenen oder privaten Kanal die vom getContext Anruf empfangenen Daten für freigegebene oder private Kanäle. Der getContext Aufruf veröffentlicht zwei neue Eigenschaften, hostTeamGroupID und hostTenantID, die zum Abrufen der Kanalmitgliedschaft mithilfe von Microsoft Graph-APIs verwendet werden. Jeder Kanal wird innerhalb eines Hostteams erstellt. Weitere Informationen finden Sie unter Abrufen von Kontext in freigegebenen Kanälen und Abrufen von Kontext für Ihre Registerkarte für private Kanäle.

Kanalmitgliedschaft verwalten

Verwenden Sie die allMembers API, um Kanalmitgliedschaften über Standard-, freigegebene und private Kanäle hinweg zu verwalten und zu überwachen. Es verbessert die Genauigkeit, indem direkte und indirekte Member korrekt reflektiert werden. Weitere Informationen finden Sie unter Auflisten allerMembers.

GET /teams/{team-id}/channels/{channel-id}/allMembers

Identifizieren von Mitgliedern

• Direkte Mitglieder: Benutzer, die dem Kanal direkt hinzugefügt werden, einschließlich Benutzern aus anderen Mandanten (mandantenübergreifend).
• Indirekte Mitglieder: Benutzer, die Mitglieder des Teams sind, für das der Kanal freigegeben wird, einschließlich Teams im selben Mandanten oder in einem mandantenübergreifenden.

Sie können ermitteln, ob ein Mitglied eines freigegebenen oder privaten Kanals direkt oder indirekt ist, indem Sie die @microsoft.graph.originalSourceMembershipUrl Anmerkung überprüfen. Diese Eigenschaft identifiziert die Quelle des Zugriffs eines Members auf die Kanäle:

Verwalten indirekter Mitgliedschaften über Kanäle hinweg

Sie können die indirekte Mitgliedschaft in Kanälen mithilfe der folgenden Microsoft Graph-APIs verwalten:

• Verwenden Sie die allMembers API, um alle Benutzer abzurufen, die Mitglieder eines bestimmten Kanals sind.

  GET /teams/{team-id}/channels/{channel-id}/allMembers
  

• Verwenden Sie die doesUserHaveAccess API, um zu überprüfen, ob der Benutzer aus dem Kanal entfernt wurde, und kann alle Benutzerzugriffe und relevanten Berechtigungen anzeigen. Apps mit klassischen Anwendungsberechtigungen und RSC-Berechtigungen können diese API verwenden.

  GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userid',tenantId='@TenantID',userPrincipalName='@UserPrincipalName')
  

• Verwenden Sie die sharedWithTeams API, um alle Teams aufzulisten, für die ein Kanal freigegeben ist.

  GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams
  

• Verwenden Sie die allowedMembers API, um Benutzer aus einem freigegebenen Team abzurufen, die auf einen freigegebenen Kanal zugreifen können.

  GET /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{sharewithteamsId}/allowedMembers
  

  Hinweis

  Die allowedMembers API gibt nur neu zugeordnete Benutzer zurück und gilt nicht für nicht freigegebene Ereignisse.

Zurück zum Anfang

Abrufen von App-Benachrichtigungen für Änderungen der Microsoft Graph-Mitgliedschaft

Apps, die in freigegebenen und privaten Kanälen installiert sind, erhalten Benachrichtigungen, wenn Benutzer einem Team hinzugefügt oder daraus entfernt werden, das den Kanal teilt.

Um App-Benachrichtigungen zu erhalten, müssen Sie:

1. Installieren Sie die App in einem Hostteam, und aktivieren Sie sie für den freigegebenen oder privaten Kanal. Weitere Informationen zum Installieren der App finden Sie unter Installieren der App.
2. Erstellen Sie ein gültiges Microsoft Graph-Änderungsbenachrichtigungsabonnement, um zugeordnete Teammitgliedschaftsänderungen und freigegebene oder nicht freigegebene Ereignisse mithilfe unterstützter APIs zu überwachen.

Um sowohl direkte als auch indirekte Memberupdatebenachrichtigungen zu erhalten, müssen Sie beim Erstellen eines Abonnements beide Abfragezeichenfolgenparameter einschließen. Wenn Sie die Abfragezeichenfolgen nicht angeben, sendet das Abonnement nur Benachrichtigungen für direkte Memberupdates. Weitere Informationen finden Sie unter Kanalmitgliedschaftszugriff.

/teams/{team-id}/channels/getAllMembers?notifyOnIndirectMembershipUpdate=true&suppressNotificationWhenSharedUnsharedWithTeam=true

Mithilfe dieses Abonnements können Apps Mitgliedschaftsänderungen in Kanälen und den zugehörigen Teams überwachen. Weitere Informationen zum Erstellen eines Microsoft Graph-Abonnements für Änderungsbenachrichtigungen finden Sie unter Erstellen eines Abonnements.

Abrufen von App-Benachrichtigungen für Änderungen der Botmitgliedschaft

Ihr Bot empfängt das conversationUpdate Ereignis, wenn er Benachrichtigungen zu Mitgliedschaftsupdates für Teams erhält, in denen er hinzugefügt wird. Um sowohl direkte als auch indirekte Benachrichtigungen zu Mitgliedsupdates zu erhalten, richten Sie Ihren Bot mit den folgenden Voraussetzungen ein:

1. Aktualisieren Sie das App-Manifest auf v1.25. Fügen Sie hinzu supportsChannelFeatures, tier1 um die App-Bereitschaft zu deklarieren.

2. Anfordern Resource-Specific Zustimmungsberechtigung (RSC)

   Ihre App muss die folgende RSC-Berechtigung anfordern, um auf Kanalmitgliedschaftsinformationen zuzugreifen:

   {
   "authorization": {
   "permissions": {
     "resourceSpecific": [
       {
         "name": "ChannelMember.Read.Group",
         "type": "Application"
       }
     ]
   }
     }
   }
   

3. Hinzufügen des Bots im freigegebenen Kanal

   Um Benachrichtigungen zu Mitgliedsereignissen zu erhalten, installieren Sie den Bot auf Teams-Ebene, und lassen Sie ihn manuell im freigegebenen Kanal zu.

   Dieser Prozess stellt sicher, dass der Bot aktiv ist und zum Empfangen von Benachrichtigungen sowohl für direkte als auch für indirekte Mitglieder autorisiert ist.

Verwalten hinzugefügter und entfernter Memberereignisse

In den folgenden Szenarien wird ein Mitglied hinzugefügtes Ereignis an Ihren Bot gesendet:

1. Wenn Sie den Bot installieren und zu einer Unterhaltung hinzufügen.
2. Wenn Sie einen Benutzer zu einer Unterhaltung hinzufügen, in der der Bot installiert ist.

Ihr Bot empfängt in den folgenden Szenarien ein Ereignis zum Entfernen eines Mitglieds:

1. Wenn Sie den Bot deinstallieren und aus einer Unterhaltung entfernen.
2. Wenn Sie einen Benutzer aus einer Unterhaltung entfernen, in der der Bot installiert ist.

Weitere Informationen finden Sie unter Unterhaltungsereignisse.

Wenn Sie den Bot im Team oder Kanal installieren, empfängt das Agents SDK eine conversationUpdate Aktivität über die OnConversationUpdateActivityAsync -Methode, wenn Sie einem anderen Team einen freigegebenen Kanal hinzufügen.

Wenn Sie einem freigegebenen Kanal ein neues Mitglied hinzufügen, wird die OnMembersAddedAsync -Methode aufgerufen. Diese Methode stellt den Kontext und die Details des Benutzers bereit, der hinzugefügt wurde, damit der Bot entsprechend reagieren kann.

Die folgenden Agents SDK-Beispiele gelten sowohl für direkte als auch indirekte Member zum Hinzufügen und Entfernen von Ereignissen.

Element hinzugefügtes Ereignis

public async Task OnMembersAddedAsync(ITurnContext turnContext, AppState turnState, CancellationToken cancellationToken)
{
    var membersAdded = turnContext.Activity.MembersAdded;

    List<string> addedMembers = new List<string>();
    foreach (var member in membersAdded)
    {
        if (member.Id != turnContext.Activity.Recipient.Id)
        {
            addedMembers.Add($"Member {member.Name} (ID {member.Id}) added.");
        }
    }

    await ActivityUtils.SendAdaptiveCard(
        "Member Added",
        addedMembers,
        new List<object> { "membersAdded", membersAdded },
        turnContext,
        cancellationToken).ConfigureAwait(false);

Ereignis zum Entfernen eines Mitglieds

public async Task OnMembersRemovedAsync(ITurnContext turnContext, AppState turnState, CancellationToken cancellationToken)
{
    var membersRemoved = turnContext.Activity.MembersRemoved;

    List<string> removedMembers = new List<string>();
    foreach (var member in membersRemoved)
    {
        if (member.Id != turnContext.Activity.Recipient.Id)
        {
            removedMembers.Add($"Member {member.Name} (ID {member.Id}) removed.");
        }
    }

    await ActivityUtils.SendAdaptiveCard(
        "Member Removed",
        removedMembers,
        new List<object> { "membersRemoved", membersRemoved },
        turnContext,
        cancellationToken).ConfigureAwait(false);
}

Behandeln von Massenmitgliedschaftsänderungen für graph

Wenn Massenmitgliedschaftsänderungen vorgenommen werden, schränkt Teams Benachrichtigungen zu Aktualisierungen einzelner Mitgliedschaften ein, wenn ein Kanal für ein Team freigegeben oder freigegeben wird. Verwenden sharedWithTeams Sie die Abonnementressource, um die Benachrichtigungsüberladung bei Mitgliedschaftsupdates zu reduzieren, z. B. wenn ein freigegebener Kanal einem Team mit Tausenden von Mitgliedern hinzugefügt oder daraus entfernt wird:

/teams/{team-id}/channels/{channel-id}/sharedWithTeams

Das sharedWithTeams Abonnement sendet eine einzelne Benachrichtigung, wenn ein Kanal für ein Team freigegeben oder freigegeben wird. Es vermeidet Tausende von benutzerspezifischen Benachrichtigungen und verbessert die Leistung für Apps, die Mitgliedschaftsänderungen überwachen. Stellen Sie sicher, dass Sie die Mitgliederliste des freigegebenen Kanals mithilfe der allMembers-API aktualisieren, nachdem Sie eine Benachrichtigung vom Team erhalten haben, die für freigegeben oder aufgehoben wurde .

Überprüfen des Benutzerzugriffs für Graphmitgliedschaftsupdates

Wenn eine App eine Benachrichtigung über das Entfernen eines Mitglieds für ein indirektes Mitgliedschaftsupdate empfängt , ist es wichtig zu überprüfen, ob der Benutzer aus dem Kanal entfernt wird, insbesondere, da derselbe Benutzer möglicherweise sowohl direkte als auch indirekte Mitgliedschaft hat. Wenn beispielsweise ein Benutzer aus einem Team entfernt wird, das einen Kanal gemeinsam verwendet, muss Ihre App bestätigen, ob der Zugriff des Benutzers auf den freigegebenen Kanal widerrufen wird. Verwenden Sie die doesUserHaveAccess API, um zu bestimmen, ob der Benutzer aus dem freigegebenen Kanal entfernt wird. Weitere Informationen zu Benutzerzugriffen und relevanten Berechtigungen finden Sie unter doesUserHaveAccess-API .

GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userid',tenantId='@TenantID',userPrincipalName='@UserPrincipalName')

Wenn eine App eine Benachrichtigung über ein mitglied hinzugefügtes Mitglied für ein indirektes Mitgliedschaftsupdate empfängt, lesen Sie die AllMembers-API , um die Liste aller Mitglieder zu aktualisieren.

GET /teams/{team-id}/channels/{channel-id}/allMembers

Klassifizieren von Mitgliedern als mandantenintern oder out-tenant

Sie können Mitglieder als mandantenintern oder out-tenant klassifizieren, indem Sie die TenantId des Mitglieds oder Teams wie folgt vergleichen ownerTenantId :

1. Rufen Sie die des TenantId Members ab, das Sie vergleichen möchten.

   GET /teams/{host-team-group-id}/channels/{channel-id}/allMembers
   

2. Rufen Sie microsoftTeams.app.getContext() auf Ihrer Registerkarte aus der Teams JavaScript-Clientbibliothek auf. Der getContext()-Aufruf gibt den Kontext des freigegebenen Kanals zurück, der die Details wie displayName, membershipType, ownerGroupIdund ownerTenantIdenthält.

3. Vergleichen Sie die TenantId des Members mit der ownerTenantId -Eigenschaft, und bestimmen Sie, ob es sich bei dem Mitglied um einen Mandanten oder einen out-tenant handelt.

Zurück zum Anfang

Grundlegendes zu App-Berechtigungen in freigegebenen Kanälen

Sie können mit externen Mitgliedern außerhalb Ihrer organization zusammenarbeiten, indem Sie freigegebene Kanäle verwenden. App-Berechtigungen in freigegebenen Kanälen folgen der App-Liste des Hostteams und der App-Richtlinie des Hostmandanten.

Überprüfen der Botinstallation in einem Kanal

Wenn einem anderen Team ein freigegebener Kanal hinzugefügt wird, empfängt das Agents SDK nur dann eine conversationUpdate Aktivität über die OnConversationUpdateActivityAsync -Methode, wenn der Bot im Team installiert ist. Es gibt keine dedizierte API, um zu überprüfen, ob Ihre App Teil eines Kanals ist. Bots können erkennen, wann Ihre App indirekt zu einem Kanal hinzugefügt wird.

Verwenden Sie dieses channelMemberAdded Ereignis, um appspezifische Logik auszulösen, z. B.:

• Senden einer Begrüßungsnachricht
• Abrufen der Kanalliste
• Konfigurieren von Registerkarten
• Starten geplanter Aufträge

        protected override async Task OnConversationUpdateActivityAsync(
            ITurnContext<IConversationUpdateActivity> turnContext,
            CancellationToken cancellationToken)
        {
            var tcd = turnContext.Activity.GetChannelData<TeamsChannelData>();
            var eventType = tcd?.EventType?.ToLowerInvariant();

            var extended = turnContext.Activity.GetChannelData<SharedChannelChannelData>();

            var raw = turnContext.Activity.ChannelData as JObject
                      ?? (turnContext.Activity.ChannelData != null
                          ? JObject.FromObject(turnContext.Activity.ChannelData)
                          : new JObject());

            _logger.LogInformation("ConversationUpdate eventType={EventType}, channelId={ChannelId}, teamId={TeamId}",
                eventType, tcd?.Channel?.Id, tcd?.Team?.Id);

            switch (eventType)
            {
                case "channelshared":
                {
                    var hostTeam = extended?.Team; 
                    var sharedWith = extended?.SharedWithTeams ?? new List<TeamInfoEx>();

                    _logger.LogInformation("ChannelShared: hostTeam={HostTeamId}, sharedWithCount={Count}",
                        hostTeam?.Id, sharedWith.Count);

                    foreach (var team in sharedWith)
                    {
                        _logger.LogInformation("SharedWithTeam: id={Id}, name={Name}, aadGroupId={AadGroupId}, tenantId={TenantId}",
                            team.Id, team.Name, team.AadGroupId, team.TenantId);
                    }

                    await turnContext.SendActivityAsync(
                        MessageFactory.Text($" Channel shared with {sharedWith.Count} team(s)."),
                        cancellationToken);
                    break;
                }

                case "channelunshared":
                {
                    var unsharedFrom = extended?.UnsharedFromTeams ?? new List<TeamInfoEx>();

                    _logger.LogInformation("ChannelUnshared: unsharedFromCount={Count}", unsharedFrom.Count);

                    foreach (var team in unsharedFrom)
                    {
                        _logger.LogInformation("UnsharedFromTeam: id={Id}, name={Name}, aadGroupId={AadGroupId}, tenantId={TenantId}",
                            team.Id, team.Name, team.AadGroupId, team.TenantId);
                    }

                    await turnContext.SendActivityAsync(
                        MessageFactory.Text($" Channel unshared from {unsharedFrom.Count} team(s)."),
                        cancellationToken);
                    break;
                }

                default:
                    break;
            }

            await base.OnConversationUpdateActivityAsync(turnContext, cancellationToken);
        }

Authentifizieren externer Benutzer für den Zugriff auf App-Inhalte in SharePoint

Führen Sie diesen Schritt aus, wenn Ihre App Inhalte auf der SharePoint-Website des Mandanten speichert, der den Kanal hostet und ein SharePoint-Token anfordert.

Senden Sie nun den gespeicherten Host tenantId innerhalb tenantId des Aufrufparameters getAuthToken , um mandantenübergreifenden Benutzern den Zugriff auf Inhalte zu ermöglichen, die auf einer SharePoint-Website gehostet werden, die an den freigegebenen Kanal angefügt ist.

Identifizieren von Gastbenutzern in Kanälen mithilfe von Graph-API

Sie können ermitteln, ob ein Mitglied eines Kanals ein Gastbenutzer ist, der von externen organization zu Ihrem Mandanten eingeladen wird, indem Sie die roles -Eigenschaft für jedes Objekt in der Liste der Mitglieder einer Kanalantwort verwenden.

Für Gäste: roles = guest.

Verwenden Sie die folgende allMembers API, um alle Gastbenutzer in einem Kanal genau abzurufen:

GET /teams/{team-id}/channels/{channel-id}/allMembers

Diese API funktioniert über Standard- und andere Kanäle hinweg und wird für die zuverlässige Identifizierung von Gastmitgliedern empfohlen.

Zugreifen auf SharePoint-Daten in freigegebenen und privaten Kanälen

Wenn Sie eine App mit SharePoint Framework erstellen, müssen Sie die SharePoint in Microsoft 365 (SPO)-Website verwenden, die mit dem freigegebenen Kanal verknüpft ist, nicht die website, die mit der Hostteamgruppe verknüpft ist. Sowohl freigegebene als auch private Kanäle verfügen über eine eigene SharePoint-Website, auf die nur Mitglieder dieses bestimmten freigegebenen oder privaten Kanals zugreifen können.

Verwenden Sie die Microsoft Graph-Einladungs-API, um auf die Dokumentbibliothek der SharePoint in Microsoft 365-Website zuzugreifen, die mit einem freigegebenen oder privaten Kanal verknüpft ist.

Zurück zum Anfang

Zugreifen auf SharePoint-Speicher für Kanaldateien mithilfe von Graph-API

Verwenden Sie die folgende API, um auf das Stammverzeichnis von SharePoint-Dateien eines Kanals zuzugreifen:

GET /teams/{teamId}/channels/{channelId}/filesFolder

Diese API gibt ein DriveItem-Objekt für den Dateistamm dieses Kanals zurück. Weitere Informationen finden Sie unter Kanaldateien.

Verwenden Sie die folgenden Eigenschaften für alle nachfolgenden Dateivorgänge:

• parentReference.driveId: Die SharePoint-DriveId für die Website des Kanals.
• itemId: Die folderId für den Stamm des Kanals.

Das erwartete Laufwerkverhalten der Kanäle lautet wie folgt:

• Standard Kanäle verwenden die driveId der Teamwebsite.
• Andere Kanäle verwenden eine separate driveId für ihre einzelnen Websites.

Verwalten des Dateizugriffs für externe oder Gastbenutzer mithilfe von Graph-API

POST /drives/{driveId}/items/{itemId}/invite

Authentifizieren externer Benutzer in Registerkarten oder Aufgabenmodulen

Wenn Ihr Registerkarten- oder Aufgabenmodul auf SharePoint-Ressourcen im Basismandanten des Kanals zugreifen muss, führen Sie die folgenden Schritte aus:

1. Erkennen externer Benutzer Verwenden Sie getContext() zum Abrufen des Kanalkontexts. Vergleichen Sie user.tenant.id mit channel.ownerTenantId oder channel.hostTenantId. Wenn sie sich unterscheiden, ist der Benutzer extern.

2. Anfordern eines Tokens vom Basismandanten Rufen Sie getAuthToken() mit der Mandanten-ID (user.tenant.id oder tid) des externen Benutzers an, um sicherzustellen, dass das Token von seinem Basismandanten ausgestellt wird.

Zurück zum Anfang

Testen Ihrer App über mehrere Kanäle hinweg

Stellen Sie vor dem Veröffentlichen von Updates sicher, dass Ihre App in allen Kanaltypen in realen Situationen ordnungsgemäß funktioniert.

Standardkanal

Vergewissern Sie sich, dass die vorhandene Funktionalität nach ihren Änderungen intakt bleibt. Stellen Sie sicher, dass Registerkarten, Bots und Messagingerweiterungen weiterhin wie erwartet funktionieren.

Freigegebener Kanal

Privater Kanal

Erstellen Sie einen privaten Kanal in Team A mit mindestens zwei Mitgliedern (Besitzer und Mitglied).

Führen Sie die folgenden Schritte aus, um die Unterstützung für private Kanäle zu überprüfen:

1. Fügen Sie die App zu Team A hinzu, und fügen Sie sie dann dem privaten Kanal hinzu.
2. Vergewissern Sie sich, dass die Registerkarte ordnungsgemäß im privaten Kanal geladen wird.
3. Testen Sie Botantworten für verschiedene Benutzertypen:
   • Mandanteninternes Mitglied
   • Gastbenutzer oder externer Benutzer
4. Wenn Ihre App Mitglieder auflistet oder Aufgaben zuweist, vergewissern Sie sich, dass nur Kanalmitglieder und nicht das gesamte Team verwendet werden.
5. Fügen Sie dem privaten Kanal ein neues Mitglied hinzu, und überprüfen Sie Folgendes:
   • Ob Ihre App ein Mitgliedschaftsänderungsereignis empfängt
   • Gibt an, ob Ihre Mitgliedschafts-API das neue Mitglied widerspiegelt

Tests in diesen Szenarien helfen Ihnen, Probleme mit Funktionalität, Berechtigungen und Benutzererfahrung zu erkennen.

Bewährte Methoden für die Unterstützung aller Kanäle

Was Sie tun sollten

• Rufen Sie immer die Mitgliederliste und die Rollen des aktuellen Kanals ab, bevor Sie Aktionen ausführen. Wenn Sie beispielsweise Benachrichtigungen senden oder Aufgaben zuweisen, richten Sie sich nur an die tatsächlichen Kanalmitglieder und nicht an das gesamte Team.
• Steuern des Datenzugriffs und der Freigabe basierend auf kanalbezogener Mitgliedschaft und Berechtigungen. Weitere Informationen finden Sie unter Verwalten der Kanalmitgliedschaft.
• Bestimmen Sie , ob Benutzer intern, Gäste oder Extern (mandantenübergreifend) sind, und authentifizieren Sie sie in ihrem Basismandanten. Überprüfen Sie Berechtigungen für mandantenübergreifende Szenarien immer, insbesondere beim Zugriff auf Dateien. Weitere Informationen finden Sie unter Identifizieren von Gastbenutzern in Kanälen mithilfe von Graph-API.
• Aktualisieren Sie Hilfetext und Benutzerhandbücher , um zu erläutern, wie sich Ihre App in verschiedenen Kanaltypen verhält, einschließlich Einschränkungen für Gäste oder externe Benutzer.
• Lesen Sie die Dokumentation und Änderungsprotokolle von Teams , um auf den neuesten Updates für APIs, Berechtigungen und Kanalkonfigurationen zu bleiben.

Was Sie nicht tun sollten

• Beschränken Sie vertrauliche Aktionen auf Besitzer oder interne Benutzer, und bieten Sie Eingeschränkte Features für Gäste oder externe Teilnehmer.
• Schließen Sie private Kanaldaten niemals in umfassendere Berichte oder öffentliche Kanäle ein, es sei denn, dies ist explizit autorisiert.

Häufig gestellte Fragen

Zurück zum Anfang

Codebeispiele

Siehe auch

• Kanalmitgliedschaft verwalten
• Grundlegendes zu App-Berechtigungen in freigegebenen Kanälen
• Erstellen von Registerkarten für Teams
• Freigegebene Kanäle in Microsoft Teams
• Kanalressourcentyp
• Aufbewahrungsrichtlinie für Teams-Speicherorte
• Verwenden Sie den Gastzugriff und den externen Zugriff, um mit Personen außerhalb Ihres Unternehmens zusammenzuarbeiten
• Verwalten externer Besprechungen und Chatten mit Personen und Organisationen mithilfe von Microsoft-Identitäten