AWS chatbot documentation change
Summary
Updated terminology from 'chat channels' to 'chat applications' throughout the document to reflect service renaming/rebranding
Security assessment
The changes are purely terminological updates (channels→applications) with no modifications to security-related content. References to IAM permissions, role configuration, and logging remain functionally identical. No vulnerabilities or new security features are introduced.
Diff
diff --git a/chatbot/latest/adminguide/chime-setup.md b/chatbot/latest/adminguide/chime-setup.md index fcb65229f..50a715440 100644 --- a//chatbot/latest/adminguide/chime-setup.md +++ b//chatbot/latest/adminguide/chime-setup.md @@ -11 +11 @@ AWS Chatbot is now Amazon Q Developer. [Learn more](./service-rename.html) -To get started using Amazon Q Developer in chat channels to help manage your AWS infrastructure, follow the steps below to set up Amazon Q Developer in chat channels with chat channels and Amazon SNS topic subscriptions. +To get started using Amazon Q Developer in chat applications to help manage your AWS infrastructure, follow the steps below to set up Amazon Q Developer in chat applications with chat channels and Amazon SNS topic subscriptions. @@ -28 +28 @@ To get started using Amazon Q Developer in chat channels to help manage your AWS -Before you get started, make sure you've completed the tasks in [Setting up Amazon Q Developer in chat applications](./getting-started.html#setting-up). You will need to choose a permissions scheme in the following procedure. This scheme determines the permissions your channel members will have and what Amazon Q Developer in chat channels can do on your behalf. For more information about Amazon Q Developer in chat channels permissions, see [Understanding permissions](./understanding-permissions.html). +Before you get started, make sure you've completed the tasks in [Setting up Amazon Q Developer in chat applications](./getting-started.html#setting-up). You will need to choose a permissions scheme in the following procedure. This scheme determines the permissions your channel members will have and what Amazon Q Developer in chat applications can do on your behalf. For more information about Amazon Q Developer in chat applications permissions, see [Understanding permissions](./understanding-permissions.html). @@ -32 +32 @@ Before you get started, make sure you've completed the tasks in [Setting up Amaz -To set up Amazon Q Developer in chat channels for Amazon Chime, get the webhook URL for your team's chat room from Amazon Chime. +To set up Amazon Q Developer in chat applications for Amazon Chime, get the webhook URL for your team's chat room from Amazon Chime. @@ -42 +42 @@ You must be an Amazon Chime chat room admin and have the ability to manage webho - 2. For **Amazon Chime** , choose the chat room that you want to set up to receive notifications through Amazon Q Developer in chat channels. + 2. For **Amazon Chime** , choose the chat room that you want to set up to receive notifications through Amazon Q Developer in chat applications. @@ -66 +66 @@ If you need to create a new webhook for the chat room, choose **Add webhook** , - 9. If you want to enable logging for this configuration, choose **Send logs to CloudWatch**. For more information, see [Amazon CloudWatch Logs for Amazon Q Developer in chat channels](./cloudwatch-logs.html). + 9. If you want to enable logging for this configuration, choose **Send logs to CloudWatch**. For more information, see [Amazon CloudWatch Logs for Amazon Q Developer in chat applications](./cloudwatch-logs.html). @@ -76 +76 @@ There is an extra charge for using CloudWatch Logs. - 2. For **Webhook description** , use the following naming convention to describe the purpose of the webhook: `Chat_room_name/Webhook_name`. This helps you associate Amazon Chime webhooks with their Amazon Q Developer in chat channels configurations. + 2. For **Webhook description** , use the following naming convention to describe the purpose of the webhook: `Chat_room_name/Webhook_name`. This helps you associate Amazon Chime webhooks with their Amazon Q Developer in chat applications configurations. @@ -78 +78 @@ There is an extra charge for using CloudWatch Logs. - 11. For **IAM permissions** , set the IAM permissions for Amazon Q Developer in chat channels. + 11. For **IAM permissions** , set the IAM permissions for Amazon Q Developer in chat applications. @@ -80 +80 @@ There is an extra charge for using CloudWatch Logs. - 1. For **Role** , choose **Create a new role from template**. If you want to use an existing role instead, choose it from the **IAM Role** list. To use an existing IAM role, you might need to modify it for use with Amazon Q Developer in chat channels. For more information, see [Configuring an IAM Role for Amazon Q Developer in chat channels](./editing-iam-roles-for-chatbot.html). + 1. For **Role** , choose **Create a new role from template**. If you want to use an existing role instead, choose it from the **IAM Role** list. To use an existing IAM role, you might need to modify it for use with Amazon Q Developer in chat applications. For more information, see [Configuring an IAM Role for Amazon Q Developer in chat applications](./editing-iam-roles-for-chatbot.html). @@ -82 +82 @@ There is an extra charge for using CloudWatch Logs. - 2. For **Policy templates** , choose **Notification permissions**. This is the IAM policy provided by Amazon Q Developer in chat channels. It provides the necessary Read and List permissions for CloudWatch alarms, events and logs, and for Amazon SNS topics. + 2. For **Policy templates** , choose **Notification permissions**. This is the IAM policy provided by Amazon Q Developer in chat applications. It provides the necessary Read and List permissions for CloudWatch alarms, events and logs, and for Amazon SNS topics. @@ -88 +88 @@ There is an extra charge for using CloudWatch Logs. - 1. For **SNS Region** , choose the AWS Region that hosts the SNS topics for this Amazon Q Developer in chat channels subscription. + 1. For **SNS Region** , choose the AWS Region that hosts the SNS topics for this Amazon Q Developer in chat applications subscription. @@ -96 +96 @@ There is an extra charge for using CloudWatch Logs. -For a tutorial on subscribing existing Amazon SNS topics to Amazon Q Developer in chat channels, see [Tutorial: Subscribing an Amazon SNS topic to Amazon Q Developer in chat channels](./subscribe-sns-topic.html). +For a tutorial on subscribing existing Amazon SNS topics to Amazon Q Developer in chat applications, see [Tutorial: Subscribing an Amazon SNS topic to Amazon Q Developer in chat applications](./subscribe-sns-topic.html). @@ -105 +105 @@ Notifications from supported services that publish to the chosen SNS topics will -You can configure as many webhooks as you need. The SNS topics that you choose also must be configured in the services for which you want to receive notifications. For more information, see [Monitoring AWS services using Amazon Q Developer in chat channels](./related-services.html). +You can configure as many webhooks as you need. The SNS topics that you choose also must be configured in the services for which you want to receive notifications. For more information, see [Monitoring AWS services using Amazon Q Developer in chat applications](./related-services.html). @@ -109 +109 @@ You can configure as many webhooks as you need. The SNS topics that you choose a -To verify that an Amazon Simple Notification Service (Amazon SNS) topic sends notifications to your Amazon Chime chat room, you can test your setup by sending a notification. To test your notifications, ensure your topics are assigned to a service supported by Amazon Q Developer in chat channels. For a list of supported services, see [Monitoring AWS services using Amazon Q Developer in chat applications](./related-services.html). You can also test notifications by using CloudWatch. For more information, see [Test notifications from AWS services to Amazon Chime using CloudWatch](./test-notifications-cw.html). +To verify that an Amazon Simple Notification Service (Amazon SNS) topic sends notifications to your Amazon Chime chat room, you can test your setup by sending a notification. To test your notifications, ensure your topics are assigned to a service supported by Amazon Q Developer in chat applications. For a list of supported services, see [Monitoring AWS services using Amazon Q Developer in chat applications](./related-services.html). You can also test notifications by using CloudWatch. For more information, see [Test notifications from AWS services to Amazon Chime using CloudWatch](./test-notifications-cw.html). @@ -113 +113 @@ To verify that an Amazon Simple Notification Service (Amazon SNS) topic sends no - 1. Open the [Amazon Q Developer in chat channels console](https://console.aws.amazon.com/chatbot/). + 1. Open the [Amazon Q Developer in chat applications console](https://console.aws.amazon.com/chatbot/). @@ -132 +132 @@ After you configure your chat clients and test that your notifications are worki - * Learn about which other AWS services you can integrate with Amazon Q Developer in chat channels in [Monitoring AWS services using Amazon Q Developer in chat applications](./related-services.html). + * Learn about which other AWS services you can integrate with Amazon Q Developer in chat applications in [Monitoring AWS services using Amazon Q Developer in chat applications](./related-services.html). @@ -134 +134 @@ After you configure your chat clients and test that your notifications are worki - * Learn about what you can customize using Amazon Q Developer in chat channels in [Customizing Amazon Q Developer in chat applications](./customizing-chatbot.html). + * Learn about what you can customize using Amazon Q Developer in chat applications in [Customizing Amazon Q Developer in chat applications](./customizing-chatbot.html).