Acciones, recursos y claves de condición para AWS Chatbot
AWS Chatbot (prefijo de servicio: chatbot) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para usarse en las políticas de permisos de IAM.
Referencias:
-
Obtenga información para configurar este servicio.
-
Vea una lista de las operaciones de API disponibles para este servicio.
-
Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.
Temas
Acciones definidas por AWS Chatbot
Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.
La columna Nivel de acceso de la tabla Acciones describe cómo se clasifica la acción (lista, lectura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Niveles de acceso en los resúmenes de políticas.
La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.
La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.
La columna Acciones dependientes de la tabla Acciones muestra los permisos adicionales que pueden ser necesarios para llamar a una acción correctamente. Es posible que estos permisos sean necesarios además del permiso para la acción en sí. Cuando una acción especifica acciones dependientes, esas dependencias pueden aplicarse a los recursos adicionales definidos para esa acción, no solo al primer recurso de la tabla.
nota
Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.
Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.
| Acciones | Descripción | Nivel de acceso | Tipos de recursos (*necesarios) | Claves de condición | Acciones dependientes |
|---|---|---|---|---|---|
| AssociateToConfiguration | Concede permiso para asociar un recurso a una configuración. | Escritura | |||
| CreateChimeWebhookConfiguration | Otorga permiso para crear una Configuración de Chime Webhook de AWS Chatbot | Escritura | |||
| CreateCustomAction | Concede permiso para crear una acción personalizada. | Escritura | |||
| CreateMicrosoftTeamsChannelConfiguration | Concede permiso para crear una configuración de canal de Microsoft Teams de AWS Chatbot | Escritura | |||
| CreateSlackChannelConfiguration | Otorga permiso para crear una Configuración de canal de Slack de AWS Chatbot | Escritura | |||
| DeleteChimeWebhookConfiguration | Otorga permiso para eliminar una Configuración de Chime Webhook de AWS Chatbot | Escritura | |||
| DeleteCustomAction | Otorga permiso para eliminar una acción personalizada | Escritura | |||
| DeleteMicrosoftTeamsChannelConfiguration | Concede permiso para eliminar una configuración de canal de Microsoft Teams de AWS Chatbot | Escritura | |||
| DeleteMicrosoftTeamsConfiguredTeam | Concede permiso para eliminar los equipos de Microsoft Teams configurados con AWS Chatbot en una Cuenta de AWS | Escritura | |||
| DeleteMicrosoftTeamsUserIdentity | Concede permiso para eliminar una identidad de usuario de Microsoft Teams de AWS Chatbot | Escritura | |||
| DeleteSlackChannelConfiguration | Otorga permiso para eliminar una Configuración de canal de Slack de AWS Chatbot | Escritura | |||
| DeleteSlackUserIdentity | Otorga permiso para eliminar un AWS Chatbot Slack User Identity | Escritura | |||
| DeleteSlackWorkspaceAuthorization | Otorga permiso para eliminar la autorización del espacio de trabajo de Slack con AWS Chatbot, asociado con una Cuenta de AWS | Escritura | |||
| DescribeChimeWebhookConfigurations | Otorga permiso para enumerar todas las configuraciones de Chime Webhook de AWS Chatbot en una cuenta de AWS. | Lectura | |||
| DescribeSlackChannelConfigurations | Otorga permiso para enumerar todos las Configuraciones de canal de Slack de AWSChatbot en una Cuenta de AWS | Lectura | |||
| DescribeSlackChannels | Otorga permiso para enumerar todos los canales de Slack públicos en el espacio de trabajo de Slack conectados a la cuenta de AWS incorporada con el servicio AWS Chatbot. | Lectura | |||
| DescribeSlackUserIdentities | Otorga permiso para describir AWS Chatbot Slack User Identity | Lectura | |||
| DescribeSlackWorkspaces | Otorga permiso para enumerar todos los espacios de trabajo autorizados de Slack conectados a la cuenta de AWS incorporados con el servicio AWS Chatbot. | Lectura | |||
| DisassociateFromConfiguration | Concede permiso para desvincular un recurso de una configuración. | Escritura | |||
| GetAccountPreferences | Otorga permiso para recuperar preferencias de cuentas de AWS Chatbot | Lectura | |||
| GetCustomAction | Concede permiso para obtener una acción personalizada. | Lectura | |||
| GetMicrosoftTeamsChannelConfiguration | Concede permiso para obtener una sola configuración de canal de Microsoft Teams de AWS Chatbot de una Cuenta de AWS | Lectura | |||
| GetMicrosoftTeamsOauthParameters | Concede permiso para generar parámetros de OAuth para solicitar el código de OAuth de Microsoft Teams que debe utilizar el servicio AWS Chatbot | Lectura | |||
| GetSlackOauthParameters | Otorga permiso para generar parámetros de OAuth para solicitar el código de OAuth de Slack que utilizará el servicio AWS Chatbot. | Lectura | |||
| ListAssociations | Concede permiso para enumerar los recursos asociados a una configuración. | Lectura | |||
| ListCustomActions | Concede permiso para enumerar acciones personalizadas. | Enumeración | |||
| ListMicrosoftTeamsChannelConfigurations | Concede permiso para enumerar todas las configuraciones de canal de Microsoft Teams de AWS Chatbot de una Cuenta de AWS | Lectura | |||
| ListMicrosoftTeamsConfiguredTeams | Concede permiso para enumerar todos los equipos de Microsoft Teams conectados a la cuenta de AWS incorporados con el servicio AWS Chatbot | Lectura | |||
| ListMicrosoftTeamsUserIdentities | Concede permiso para describir identidades de usuario de Microsoft Teams de AWS Chatbot | Lectura | |||
| ListTagsForResource | Concede permiso para enumerar todas las etiquetas asociadas a la configuración del canal de AWS Chatbot | Lectura | |||
| RedeemMicrosoftTeamsOauthCode | Concede permiso para canjear parámetros generados anteriormente con API de Microsoft Teams a fin de adquirir tokens de OAuth para que los utilice el servicio AWS Chatbot. | Escritura | |||
| RedeemSlackOauthCode | Otorga permiso para canjear los parámetros generados anteriormente con la API de Slack a fin de adquirir tokens de OAuth para que los utilice el servicio AWS Chatbot. | Escritura | |||
| TagResource | Concede permiso para crear etiquetas en la configuración del canal de AWS Chatbot | Etiquetado | |||
| UntagResource | Concede permiso para eliminar etiquetas en la configuración del canal de AWS Chatbot | Etiquetado | |||
| UpdateAccountPreferences | Otorga permiso para actualizar preferencias de cuentas de AWS Chatbot | Escritura | |||
| UpdateChimeWebhookConfiguration | Otorga permiso para actualizar una Configuración de Chime Webhook de AWS Chatbot | Escritura | |||
| UpdateCustomAction | Concede permiso para actualizar una acción personalizada. | Escritura | |||
| UpdateMicrosoftTeamsChannelConfiguration | Concede permiso para actualizar una configuración de canal de Microsoft Teams de AWS Chatbot | Escritura | |||
| UpdateSlackChannelConfiguration | Otorga permiso para actualizar una Configuración de canal de Slack de AWS Chatbot | Escritura | |||
Tipos de recursos definidos por AWS Chatbot
Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.
| Tipos de recurso | ARN | Claves de condición |
|---|---|---|
| ChatbotConfiguration |
arn:${Partition}:chatbot::${Account}:chat-configuration/${ConfigurationType}/${ChatbotConfigurationName}
|
|
| custom-action |
arn:${Partition}:chatbot::${Account}:custom-action/${ActionName}
|
Claves de condición para AWS Chatbot
AWS Chatbot define las siguientes claves de condición que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.
A fin de ver las claves de condición globales que están disponibles para todos los servicios, consulte AWSClaves de contexto de condición globales.
| Claves de condición | Descripción | Tipo |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra el acceso por las etiquetas que se pasan en la solicitud | Cadena |
| aws:ResourceTag/${TagKey} | Filtra el acceso por las etiquetas asociadas al recurso | Cadena |
| aws:TagKeys | Filtra el acceso por las claves de etiquetas que se pasan en la solicitud | ArrayOfString |