Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Richtlinien für Chat-Anwendungen Mit den Richtlinien für AWS Organizations Chat-Anwendungen können Sie den Zugriff auf die Konten Ihrer Organisation von Chat-Anwendungen wie Slack und Microsoft Teams aus steuern. [Amazon Q Developer in Chat-Anwendungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) ist ein AWS Service, der es Softwareentwicklungsteams ermöglicht DevOps , Chatrooms von Messaging-Programmen zu verwenden, um betriebliche Ereignisse in ihren zu überwachen und darauf zu reagieren AWS Cloud. Amazon Q Developer in Chat-Anwendungen verarbeitet AWS-Service Benachrichtigungen von Amazon Simple Notification Service (Amazon SNS) und leitet sie an Chatrooms weiter, sodass Teams sie unabhängig vom Standort analysieren und sofort darauf reagieren können. ## Wie funktionieren die Richtlinien für Chat-Anwendungen Mithilfe von Richtlinien für Chat-Anwendungen kann das Verwaltungskonto oder der delegierte Administrator einer Organisation unternehmensweit Folgendes tun: + Erzwingen Sie, welche unterstützten Chat-Anwendungen (Amazon Chime, Microsoft Teams und Slack) verwendet werden können. + Beschränken Sie den Zugriff auf Chat-Clients auf bestimmte Arbeitsbereiche (Slack) und Teams (Microsoft Teams). + Beschränken Sie die Sichtbarkeit des Slack-Kanals auf öffentliche oder private Kanäle. + Lege bestimmte [Rolleneinstellungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/understanding-permissions.html#role-settings) fest und setze sie durch. Richtlinien für Chat-Anwendungen schränken Einstellungen auf Kontoebene ein und haben Vorrang vor Einstellungen auf Kontoebene wie [Rolleneinstellungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/understanding-permissions.html#role-settings) und [Channel-Guardrail-Richtlinien](https://docs.aws.amazon.com/chatbot/latest/adminguide/understanding-permissions.html#channel-guardrails). Sie können vom Amazon Q Developer aus in Chat-Anwendungen oder in der Organisationskonsole auf die Richtlinien für Chat-Anwendungen zugreifen und diese ändern. Nachdem die Richtlinien den Konten und Organisationseinheiten (OU) zugeordnet wurden, entsprechen alle aktuellen und future Konfigurationen von Amazon Q Developer in Chat-Anwendungen für die betreffenden Konten automatisch den Einstellungen für Verwaltung und Berechtigungen. Weitere Informationen finden Sie unter [Grundlegendes zur Vererbung von Verwaltungsrichtlinien](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_inheritance_mgmt.html). Wenn Sie versuchen, eine Aktion auszuführen, die durch eine Chat-Anwendungsrichtlinie eingeschränkt ist, werden Sie in einer Fehlermeldung darüber informiert, dass die Aktion aufgrund der Chat-Anwendungsrichtlinie nicht zulässig ist. Außerdem wird empfohlen, sich an das Verwaltungskonto oder den delegierten Administrator Ihrer Organisation zu wenden. **Anmerkung** Die Richtlinien für Chat-Anwendungen werden zur Laufzeit validiert. Das bedeutet, dass die vorhandenen Ressourcen kontinuierlich auf ihre Einhaltung überprüft werden. Es gibt keine Überschneidungen mit bestehenden IAM-Berechtigungen, da laufzeitbasierte IAM-Berechtigungen für das Senden von Benachrichtigungen oder die Interaktion mit Amazon Q Developer in Chat-Anwendungen derzeit nicht unterstützt werden. # Erste Schritte mit Richtlinien für Chat-Anwendungen Gehen Sie wie folgt vor, um mit der Verwendung von Richtlinien für Chat-Anwendungen zu beginnen. 1. [Erfahren Sie mehr über die Berechtigungen, die Sie benötigen, um Richtlinienaufgaben für Chat-Anwendungen auszuführen](orgs_manage_policies_prereqs.md). 1. [Aktivieren Sie Richtlinien für Chat-Anwendungen für Ihre Organisation](enable-policy-type.md). 1. [Erstellen Sie eine Richtlinie für Chat-Anwendungen](orgs_policies_create.md). 1. [Hängen Sie die Richtlinie für Chat-Anwendungen an das Stammverzeichnis, die Organisationseinheit oder das Konto Ihrer Organisation](orgs_policies_attach.md) an. 1. [Sehen Sie sich die kombinierten Richtlinien für Chat-Anwendungen an, die für ein Konto gelten](orgs_manage_policies_effective.md). Für alle diese Schritte melden Sie sich als IAM-Benutzer an, übernehmen eine IAM-Rolle oder melden sich als Stammbenutzer ([nicht empfohlen](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)) im Verwaltungskonto der Organisation an. **Weitere Informationen** + [Erfahren Sie mehr über die Syntax der Richtlinien für Chat-Anwendungen und sehen Sie sich Beispielrichtlinien an](orgs_manage_policies_chatbot_syntax.md) # Richtliniensyntax und Beispiele für Chat-Anwendungen In diesem Thema wird die Syntax der Richtlinien für Chat-Anwendungen beschrieben und es werden Beispiele bereitgestellt. ## Syntax für Richtlinien für Chat-Anwendungen Eine Richtlinie für Chat-Anwendungen ist eine Klartextdatei, die gemäß den [JSON-Regeln](http://json.org) strukturiert ist. Die Syntax für Richtlinien für Chat-Anwendungen folgt der Syntax für Verwaltungsrichtlinientypen. Eine umfassende Erläuterung dieser Syntax finden Sie unter [Vererbung von Verwaltungsrichtlinien verstehen](orgs_manage_policies_inheritance_mgmt.md). Dieses Thema konzentriert sich auf die Anwendung dieser allgemeinen Syntax auf die spezifischen Anforderungen des Richtlinientyps für Chat-Anwendungen. Das folgende Beispiel zeigt die grundlegende Syntax für eine Chat-Anwendungsrichtlinie: ``` { "chatbot":{ "platforms":{ "slack":{ "client":{ "@@assign":"enabled" // enabled | disabled }, "workspaces": { // limit 255 "@@assign":[ "Slack-Workspace-Id" ] }, "default":{ "supported_channel_types":{ "@@assign":[ "private" // public | private ] }, "supported_role_settings":{ "@@assign":[ "user_role" // user_role | channel_role ] } }, "overrides":{ // limit 255 "Slack-Workspace-Id":{ "supported_channel_types":{ "@@assign":[ "public" // public | private ] }, "supported_role_settings":{ "@@assign":[ "user_role" // user_role | channel_role ] } } } }, "microsoft_teams":{ "client":{ "@@assign":"enabled" }, "tenants":{ // limit 36 "Microsoft-Teams-Tenant-Id":{ // limit 36 "@@assign":[ "Microsoft-Teams-Team-Id" ] } }, "default":{ "supported_role_settings":{ "@@assign":[ "user_role" // user_role | channel_role ] } }, "overrides":{ // limit 36 "Microsoft-Teams-Tenant-Id":{ // limit 36 "Microsoft-Teams-Team-Id":{ "supported_role_settings":{ "@@assign":[ "user_role" // user_role | channel_role ] } } } } }, "chime":{ "client":{ "@@assign":"disabled" // enabled | disabled } } }, "default":{ "client":{ "@@assign":"disabled" // enabled | disabled } } } } ``` Diese Richtlinie für Chat-Anwendungen umfasst die folgenden Elemente: + Der Schlüsselname des Feldes `chatbot`. Richtlinien für Chat-Anwendungen beginnen immer mit diesem festen Schlüsselnamen. Das ist die oberste Zeile in dieser Beispielrichtlinie. + Darunter `chatbot` befindet sich ein `platforms` Block, der die Konfiguration für die verschiedenen unterstützten Chat-Anwendungen enthält: Slack, Microsoft Teams und Amazon Chime. + Für Slack sind die folgenden Felder verfügbar: + `"client"`: + `"enabled"`: Der Slack-Client ist aktiviert. Slack-Integrationen sind erlaubt. + `"disabled"`: Der Slack-Client ist deaktiviert. Slack-Integrationen sind nicht erlaubt. + `"workspaces"`: Durch Kommas getrennte Liste der erlaubten Slack-Workspaces. In diesem Beispiel sind die erlaubten Slack-Workspaces und. *Slack-Workspace-Id1* *Slack-Workspace-Id2* + `"default"`: Die Standardeinstellungen für Slack-Workspaces. + `"supported_channel_types"`: + `"public"`: Slack-Workspaces im Geltungsbereich erlauben standardmäßig öffentliche Slack-Channels. + `"private"`: Slack-Workspaces im Geltungsbereich erlauben standardmäßig private Slack-Channels. + `supported_role_settings`: + `"user_role"`: Slack-Workspaces im Geltungsbereich erlauben standardmäßig IAM-Rollen auf Benutzerebene. + `"channel_role"`: Slack-Workspaces im Geltungsbereich erlauben standardmäßig IAM-Rollen auf Kanalebene. + `"overrides"`: Die Override-Einstellungen für die Slack-Workspaces. + `Slack-Workspace-Id2`: Durch Kommas getrennte Liste der Slack-Workspaces, für die die Override-Einstellung gilt. In diesem Beispiel ist der Slack-Workspace. *Slack-Workspace-Id2* + `"supported_channel_types"`: + `"public"`: Überschreibe die Einstellung, ob Slack-Workspaces im Geltungsbereich öffentliche Slack-Channels zulassen. + `"private"`: Überschreibe die Einstellung, ob Slack-Workspaces im Gültigkeitsbereich private Slack-Channels zulassen. + `supported_role_settings`: + `"user_role"`: Überschreibt die Einstellung, ob Slack-Workspaces im Gültigkeitsbereich IAM-Rollen auf Benutzerebene zulassen. + `"channel_role"`: Überschreibt die Einstellung, ob Slack-Workspaces im Geltungsbereich IAM-Rollen auf Kanalebene zulassen. + Für Microsoft Teams sind die folgenden Felder verfügbar: + `"client"`: + `"enabled"`: Der Microsoft Teams-Client ist aktiviert. Microsoft Teams-Integrationen sind zulässig. + `"disabled"`: Der Microsoft Teams-Client ist deaktiviert. Microsoft Teams-Integrationen sind nicht zulässig. + `"tenants"`: Durch Kommas getrennte Liste der zulässigen Microsoft Teams-Mandanten. In diesem Beispiel ist der zulässige Mandant. *Microsoft-Teams-Tenant-Id* + `Microsoft-Teams-Tenant-Id`: Durch Kommas getrennte Liste der erlaubten Teams innerhalb des Mandanten. In diesem Beispiel ist das zulässige Team. *Microsoft-Teams-Team-Id* + `"default"`: Die Standardeinstellungen für die Teams innerhalb des Mandanten. + `supported_role_settings`: + `"user_role"`: Teams im Geltungsbereich lassen standardmäßig IAM-Rollen auf Benutzerebene zu. + `"channel_role"`: Teams im Geltungsbereich lassen standardmäßig IAM-Rollen auf Kanalebene zu. + `"overrides"`: Die Überschreibungseinstellungen für die Microsoft Teams-Mandanten. + `Microsoft-Teams-Tenant-Id`: Durch Kommas getrennte Liste der Mandanten, für die die Überschreibungseinstellung gilt. In diesem Beispiel ist der Mandant. *Microsoft-Teams-Tenant-Id* + `Microsoft-Teams-Team-Id`: Durch Kommas getrennte Liste der Teams innerhalb des Mandanten. In diesem Beispiel ist das zulässige Team. *Microsoft-Teams-Team-Id* + `supported_role_settings`: + `"user_role"`: Überschreibt die Einstellung, ob die Teams im Geltungsbereich IAM-Rollen auf Benutzerebene zulassen. + `"channel_role"`: Überschreibt die Einstellung, ob die Teams im Geltungsbereich IAM-Rollen auf Kanalebene zulassen. + Für Amazon Chime sind die folgenden Felder verfügbar: + `"client"`: + `"enabled"`: Der Amazon Chime Chime-Client ist aktiviert. Amazon Chime Chime-Integrationen sind zulässig. + `"disabled"`: Der Amazon Chime Chime-Client ist deaktiviert. Amazon Chime Chime-Integrationen sind nicht zulässig. + Darunter befindet sich ein `default` Block`chatbot`, der Amazon Q Developer in Chat-Anwendungen im gesamten Unternehmen deaktiviert, sofern er nicht auf einer niedrigeren Ebene außer Kraft gesetzt wird. Diese Standardeinstellung deaktiviert auch alle neuen Chat-Anwendungen, die Amazon Q Developer in Chat-Anwendungen unterstützt. Wenn Amazon Q Developer in Chat-Anwendungen beispielsweise eine neue Chat-Anwendung unterstützt, deaktiviert diese Standardeinstellung auch diese neu unterstützte Chat-Anwendung. **Anmerkung** Weitere Informationen zu IAM-Rollen auf Kanalebene und IAM-Rollen auf Benutzerebene finden Sie unter [Grundlegendes zu den Berechtigungen von Amazon Q Developer in Chat-Anwendungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/understanding-permissions.html) im *Administratorhandbuch für Amazon Q Developer in Chat-Anwendungen*. ## Beispiele für Richtlinien für Chat-Anwendungen Die folgenden Richtlinienbeispiele dienen nur zu Informationszwecken. ### Beispiel 1: Nur private Slack-Channels in einem bestimmten Workspace zulassen, Microsoft Teams deaktivieren, alle Authentifizierungsmodi werden unterstützt Die folgende Richtlinie konzentriert sich auf die Kontrolle der zulässigen Konfigurationen für Chatbot-Integrationen von Slack und Microsoft Teams. ``` { "chatbot": { "platforms": { "slack": { "client": { "@@assign": "enabled" }, "workspaces": { "@@assign": [ "Slack-Workspace-Id" ] }, "default": { "supported_channel_types": { "@@assign": [ "private" ] }, "supported_role_settings": { "@@assign": [ "channel_role", "user_role" ] } } }, "microsoft_teams": { "client": { "@@assign": "disabled" } }, "chime":{ "client":{ "@@assign":"disabled" } }, "default":{ "client":{ "@@assign":"disabled" } } } } } ``` **Für Slack** + Der Slack-Client ist aktiviert. + Nur der spezifische Slack-Workspace *Slack-Workspace-Id* ist erlaubt. + In den Standardeinstellungen sind nur private Slack-Channels, IAM-Rollen auf Kanalebene und IAM-Rollen auf Benutzerebene zulässig. **Für Microsoft Team** + Der Microsoft Teams-Client ist deaktiviert. **Für Amazon Chime** + Der Amazon Chime Chime-Client ist deaktiviert. **Zusätzliche Einzelheiten** + Der `default` Block unten legt fest, dass der Client deaktiviert wird, wodurch Amazon Q Developer in Chat-Anwendungen im gesamten Unternehmen deaktiviert wird, sofern er nicht auf einer niedrigeren Ebene überschrieben wird. Diese Standardeinstellung deaktiviert auch alle neuen Chat-Anwendungen, die Amazon Q Developer in Chat-Anwendungen unterstützt. Wenn Amazon Q Developer in Chat-Anwendungen beispielsweise eine neue Chat-Anwendung unterstützt, deaktiviert diese Standardeinstellung auch diese neu unterstützte Chat-Anwendung. ### Beispiel 2: Erlaube nur Slack-Integrationen mit IAM-Rollen auf Benutzerebene Die folgende Richtlinie verfolgt einen freizügigeren Ansatz für Slack. Sie erlaubt alle Slack-Workspaces, beschränkt aber den Authentifizierungsmodus auf nur IAM-Rollen auf Benutzerebene. ``` { "chatbot":{ "platforms":{ "slack":{ "client":{ "@@assign":"enabled" }, "workspaces": { "@@assign":[ "*" ] }, "default":{ "supported_role_settings":{ "@@assign":[ "user_role" ] } } }, "microsoft_teams":{ "client":{ "@@assign":"disabled" } }, "chime":{ "client":{ "@@assign":"disabled" } } }, "default":{ "client":{ "@@assign":"disabled" } } } } ``` **Für Slack** + Der Slack-Client ist aktiviert. + Mit dem Platzhalter werden keine spezifischen Slack-Workspaces definiert`"*"`, sodass alle Workspaces zulässig sind. + In den Standardeinstellungen sind nur IAM-Rollen auf Benutzerebene zulässig. **Für Microsoft Team** + Der Microsoft Teams-Client ist deaktiviert. **Für Amazon Chime** + Der Amazon Chime Chime-Client ist deaktiviert. **Zusätzliche Einzelheiten** + Der `default` Block unten legt fest, dass der Client deaktiviert wird, wodurch Amazon Q Developer in Chat-Anwendungen im gesamten Unternehmen deaktiviert wird, sofern er nicht auf einer niedrigeren Ebene überschrieben wird. Diese Standardeinstellung deaktiviert auch alle neuen Chat-Anwendungen, die Amazon Q Developer in Chat-Anwendungen unterstützt. Wenn Amazon Q Developer in Chat-Anwendungen beispielsweise eine neue Chat-Anwendung unterstützt, deaktiviert diese Standardeinstellung auch diese neu unterstützte Chat-Anwendung. ### Beispiel 3: Nur Microsoft Teams-Integrationen in einem bestimmten Mandanten zulassen Die folgende Beispielrichtlinie sperrt die Organisation so, dass sie nur Microsoft Teams-Chatbot-Integrationen innerhalb des angegebenen Mandanten zulässt, während Slack-Integrationen vollständig blockiert werden. ``` { "chatbot":{ "platforms":{ "slack":{ "client": { "@@assign": "disabled" }, }, "microsoft_teams":{ "client": { "@@assign": "enabled" }, "tenants":{ "Microsoft-Teams-Tenant-Id":{ "@@assign":[ "*" ] } } }, "chime": { "client":{ "@@assign": "disabled" } } } } } ``` **Für Slack** + Der Slack-Client ist deaktiviert. **Für Microsoft Team** + Nur ein bestimmter Mandant *Microsoft-Teams-Tenant-Id* ist zulässig, wobei der Platzhalter verwendet wird, `"*"` um alle Teams innerhalb dieses Mandanten zuzulassen. **Für Amazon Chime** + Der Amazon Chime Chime-Client ist deaktiviert. **Zusätzliche Einzelheiten** + Der `default` Block unten legt fest, dass der Client deaktiviert wird, wodurch Amazon Q Developer in Chat-Anwendungen im gesamten Unternehmen deaktiviert wird, sofern er nicht auf einer niedrigeren Ebene überschrieben wird. Diese Standardeinstellung deaktiviert auch alle neuen Chat-Anwendungen, die Amazon Q Developer in Chat-Anwendungen unterstützt. Wenn Amazon Q Developer in Chat-Anwendungen beispielsweise eine neue Chat-Anwendung unterstützt, deaktiviert diese Standardeinstellung auch diese neu unterstützte Chat-Anwendung. ### Beispiel 4: Erlaubt eingeschränkten Zugriff auf Amazon Q Developer in Chat-Anwendungen für Slack-Workspaces und einen Microsoft Teams-Mandanten Die folgende Richtlinie erlaubt eingeschränkten Zugriff auf Amazon Q Developer in Chat-Anwendungen für ausgewählte Slack-Workspaces und einen Microsoft Teams-Mandanten. ``` { "chatbot":{ "platforms":{ "slack":{ "client":{ "@@assign":"enabled" }, "workspaces": { "@@assign":[ "Slack-Workspace-Id1", "Slack-Workspace-Id2" ] }, "default":{ "supported_channel_types":{ "@@assign":[ "private" ] }, "supported_role_settings":{ "@@assign":[ "user_role" ] } }, "overrides":{ "Slack-Workspace-Id2":{ "supported_channel_types":{ "@@assign":[ "public", "private" ] }, "supported_role_settings":{ "@@assign":[ "channel_role", "user_role" ] } } } }, "microsoft_teams":{ "client":{ "@@assign":"enabled" }, "tenants":{ "Microsoft-Teams-Tenant-Id":{ "@@assign":[ "Microsoft-Teams-Team-Id" ] } }, "default":{ "supported_role_settings":{ "@@assign":[ "user_role" ] } }, "overrides":{ "Microsoft-Teams-Tenant-Id":{ "Microsoft-Teams-Team-Id":{ "supported_role_settings":{ "@@assign":[ "channel_role", "user_role" ] } } } } } }, "default":{ "client":{ "@@assign":"disabled" } } } } ``` **Für Slack** + Der Slack-Client ist aktiviert. + Die erlaubten Slack-Workspaces sind und. *Slack-Workspace-Id1* *Slack-Workspace-Id2* + Die Standardeinstellungen für Slack lauten, dass nur private Channels und IAM-Rollen auf Benutzerebene erlaubt sind. + Es gibt eine Überschreibung für den Workspace*Slack-Workspace-Id2*, die sowohl öffentliche als auch private Channels sowie sowohl IAM-Rollen auf Kanalebene als auch IAM-Rollen auf Benutzerebene erlaubt. **Für Microsoft Team** + Das Microsoft Teams ist aktiviert. + Die zugelassenen Teams-Mandanten gehören *Microsoft-Teams-Tenant-Id* dem Team an*Microsoft-Teams-Team-Id*. + In den Standardeinstellungen sind nur IAM-Rollen auf Benutzerebene zulässig. + Es gibt eine Überschreibung für den Mandanten*Microsoft-Teams-Tenant-Id*, die sowohl IAM-Rollen auf Kanalebene als auch IAM-Rollen auf Benutzerebene für das Team zulässt. *Microsoft-Teams-Team-Id* **Zusätzliche Einzelheiten** + Der `default` Block unten legt fest, dass der Client deaktiviert wird, wodurch Amazon Q Developer in Chat-Anwendungen im gesamten Unternehmen deaktiviert wird, sofern er nicht auf einer niedrigeren Ebene überschrieben wird. Das bedeutet, dass Amazon Chime in diesem Beispiel deaktiviert ist. Diese Standardeinstellung deaktiviert auch alle neuen Chat-Anwendungen, die Amazon Q Developer in Chat-Anwendungen unterstützt. Wenn Amazon Q Developer in Chat-Anwendungen beispielsweise eine neue Chat-Anwendung unterstützt, deaktiviert diese Standardeinstellung auch diese neu unterstützte Chat-Anwendung.