Uso de roles vinculados a servicios para los flujos de datos

En las secciones siguientes, se explica cómo se administra el rol vinculado a servicios para los flujos de datos.

Permisos de roles vinculados a servicios

El SDK de Amazon Chime usa el rol vinculado al servicio denominado. AWSServiceRoleForChimeSDKMessaging El rol otorga acceso a los AWS servicios y recursos que utiliza o administra el SDK de Amazon Chime, como las transmisiones de Kinesis que se utilizan para la transmisión de datos.

El rol AWSServiceRoleForChimeSDKMessagingvinculado al servicio confía en los siguientes servicios para que estos puedan asumir el rol:

• messaging.chime.amazonaws.com

La política de permisos del rol permite que Amazon Chime SDK realice las siguientes acciones en el recurso especificado:

• kms:GenerateDataKey solo cuando la solicitud se realiza utilizando kinesis.*.amazonaws.com.

• kinesis:PutRecord, kinesis:PutRecords o kinesis:DescribeStream solo en transmisiones del siguiente formato: arn:aws:kinesis:*:*:stream/chime-messaging-*.

En el siguiente ejemplo se muestra la política.

{
    	"Version": "2012-10-17",
    	"Statement": [
    		{
    			"Effect": "Allow",
    			"Action": [
    				"kms:GenerateDataKey"
    			],
    			"Resource": "*",
    			"Condition": {
    				"StringLike": {
    					"kms:ViaService": [
    						"kinesis.*.amazonaws.com"
    					]
    				}
    			}
    		},
    		{
    			"Effect": "Allow",
    			"Action": [
    				"kinesis:PutRecord",
    				"kinesis:PutRecords",
    				"kinesis:DescribeStream"
    			],
    			"Resource": [
    				"arn:aws:kinesis:*:*:stream/chime-messaging-*"
    			]
    		}
    	]
    }

Debe configurar permisos para permitir a una entidad de IAM (como un usuario, grupo o rol) crear, editar o eliminar un rol vinculado a servicios. Para obtener más información, consulte Permisos de roles vinculados a servicios en la Guía del usuario de IAM.

Crear un rol vinculado a servicios

No necesita crear manualmente un rol vinculado a servicios. Cuando usa la PutMessagingStreamingConfigurationsAPI para crear una configuración de transmisión de datos, el SDK de Amazon Chime crea automáticamente el rol vinculado al servicio.

También puede utilizar la consola de IAM para crear un rol vinculado al servicio con el caso de uso de Amazon Chime SDK. En la AWS CLI o la AWS API, cree un rol vinculado al servicio con el nombre del messaging.chime.amazonaws.com servicio. Para obtener más información, consulte Crear un rol vinculado a un servicio en la Guía del usuario de IAM. Si elimina este rol, puede repetir este proceso para volver a crearlo.

Editar un rol vinculado a un servicio

Tras crear un rol vinculado a un servicio, solo puede editar su descripción y hacerlo mediante IAM. Para obtener más información, consulte Editar un rol vinculado a servicios en la Guía del usuario de IAM.

Eliminar los recursos que utiliza un rol vinculado a servicios

Antes de que pueda utilizar IAM para eliminar un rol vinculado a servicios, primero debe eliminar los recursos que utiliza el rol.

nota

Las eliminaciones pueden fallar si intenta eliminar recursos mientras Amazon Chime SDK los usa. Si falla la eliminación, espere unos minutos e intente de nuevo la operación.

Para eliminar los recursos utilizados por el rol AmazonChimeServiceChatStreamingAccess

Ejecute el siguiente comando CLI para desactivar la transmisión de datos para la instancia de la aplicación:

• aws chime-sdk-messaging delete-messaging-streaming-configurations --app-instance-arn app_instance_arn

Esta acción elimina todas las configuraciones de transmisión de la instancia de su aplicación.

Eliminar un rol vinculado a un servicio

Si ya no necesita utilizar una característica o servicio que requiere un rol vinculado a servicios, recomendamos que elimine dicho rol. De lo contrario, tendrá una entidad sin uso que no se supervisa ni mantiene activamente. Sin embargo, debe eliminar los recursos utilizados por su rol vinculado al servicio antes de poder eliminar manualmente el rol.

Puede usar la consola de IAM o la AWS API para eliminar el rol vinculado al AmazonChimeServiceRoleForChimeSDKMessagingservicio. AWS CLI Para obtener más información, consulte Eliminar un rol vinculado a un servicio en la Guía del usuario de IAM.