Notificaciones de eventos de Amazon Chime SDK

El SDK de Amazon Chime permite enviar notificaciones de eventos de reuniones a Amazon EventBridge, Amazon Simple Queue Service (SQS) y Amazon Simple Notification Service (SNS).

nota

El espacio de nombres predeterminado para reuniones del SDK de Amazon Chime usa los puntos de enlace. ChimeSDKMeetings El espacio de nombres Chime heredado utiliza un único punto de conexión. Para obtener más información sobre los espacios de nombres y los puntos de enlace, consulte la sección anterior de esta guía. Migración al espacio de nombres Meetings de Amazon Chime SDK

Enviar notificaciones a EventBridge

Puede enviar notificaciones de eventos del SDK de Amazon Chime a. EventBridge Para obtener información detallada sobre el uso del SDK de Amazon Chime con EventBridge, consulte Automatización del SDK de Amazon Chime con en la Guía del administrador del SDK de EventBridge Amazon Chime. Para obtener información al respecto EventBridge, consulta la Guía del EventBridge usuario de Amazon.

Envío de notificaciones a Amazon SQS y Amazon SNS

Puede utilizar la CreateMeetingAPI de la referencia de API del SDK de Amazon Chime para enviar notificaciones de eventos de reuniones del SDK de Amazon Chime a una cola de Amazon SQS y a un tema de Amazon SNS por reunión. Esto puede ayudar a reducir la latencia de las notificaciones. Para obtener más información sobre Amazon SQS, consulte la Guía del desarrollador de Amazon Simple Queue Service. Para obtener más información sobre Amazon SNS, consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Las notificaciones enviadas a Amazon SQS y Amazon SNS contienen la misma información que las notificaciones a las que envía el SDK de Amazon Chime. EventBridge Amazon Chime SDK admite el envío de notificaciones de eventos de reuniones a colas y temas de la región de API utilizada para crear una reunión. Es posible que las notificaciones de eventos se envíen fuera del orden en que se produjeron.

Concesión del acceso de Amazon Chime SDK a Amazon SQS y Amazon SNS

Antes de que Amazon Chime SDK pueda enviarle notificaciones a través de una cola de Amazon SQS o un tema de Amazon SNS, debe conceder permiso al Amazon Chime SDK para publicar mensajes en el nombre de recurso de Amazon (ARN) de la cola o el tema. Para ello, adjunte una política AWS Identity and Access Management (de IAM) a la cola o al tema que conceda los permisos adecuados al SDK de Amazon Chime. Para obtener más información, consulte Gestión de identidades y accesos en Amazon SQS en la Guía para desarrolladores de Amazon Simple Queue Service y Ejemplos de casos de control de acceso a Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

nota

La cola de Amazon SQS o el tema de Amazon SNS deben utilizar la misma región que el punto de enlace de la API del AWS SDK de Amazon Chime.

ejemplo Permita que Amazon Chime SDK publique eventos en una cola de Amazon SQS

El siguiente ejemplo de política de IAM concede a Amazon Chime SDK permiso para publicar notificaciones de eventos de reuniones en la cola de Amazon SQS especificada. Anote la declaración condicional para aws:SourceArn y aws:SourceAccount. Abordan posibles problemas de Suplente confuso.

nota

• Puede utilizar aws:SourceArn o aws:SourceAccount al crear las políticas que aparecen a continuación. No tiene que usar ambas opciones.

• En estos ejemplos se utiliza el espacio de nombres ChimeSDKMeetings y el punto de conexión correspondiente. Si utiliza el espacio de nombres Chime, debe usar el punto de conexión chime.amazonaws.com.

{
    "Version": "2008-10-17",
   "Id": "example-ID",
    "Statement": [
        { 
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "meetings.chime.amazonaws.com"  
            },
                "Action": [
                    "sqs:SendMessage",
                    "sqs:GetQueueUrl"
                ],
               "Resource": "arn:aws:sqs:"eu-central-1:111122223333:queueName",
               "Condition": {
                   "ArnLike": {
                       "aws:SourceArn": "arn:partition:chime::111122223333:*"
               },
               "StringEquals": {
                   "aws:SourceAccount": "111122223333"
               }
            }
        }
   ]
}

En este ejemplo, se muestra una política de Amazon SNS que permite a Amazon Chime SDK enviar notificaciones de eventos de reuniones a su tema de SNS.

{
    "Version": "2008-10-17",
    "Id": "example-ID",
    "Statement": [
     {
        "Sid": "allow-chime-sdk-access-statement-id",
        "Effect": "Allow",
        "Principal": {
            "Service": "meetings.chime.amazonaws.com"  
    },
       "Action": [
           "SNS:Publish"
       ],
           "Resource": "arn:aws:sns:eu-central-1:111122223333:topicName",
           "Condition": {
           "ArnLike": {
               "aws:SourceArn": "arn:partition:chime::111122223333:*"
      },
      "StringEquals": {
          "aws:SourceAccount": "111122223333"
          }
       }
     }
   ]
}

Si la cola de Amazon SQS está habilitada para el cifrado del servidor (SSE), debe realizar un paso adicional. Adjunte una política de IAM a la AWS KMS clave asociada que otorgue permiso al SDK de Amazon Chime para realizar AWS KMS las acciones necesarias para cifrar los datos añadidos a la cola.

{
    "Version": "2012-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "meetings.chime.amazonaws.com"
            },
            "Action": [
                "kms:GenerateDataKey",
                "kms:Decrypt"
            ],
            "Resource": "*"
        }
    ]
}

ejemplo Permitir que Amazon Chime SDK publique eventos en un tema de Amazon SNS

El siguiente ejemplo de política de IAM concede a Amazon Chime SDK permiso para publicar notificaciones de eventos de reuniones en el tema de Amazon SNS especificado.

{
    "Version": "2008-10-17",
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "allow-chime-sdk-access-statement-id",
            "Effect": "Allow",
            "Principal": {
                "Service": "meetings.chime.amazonaws.com"
            },
            "Action": [
                "SNS:Publish"
            ],
            "Resource": "arn:aws:sns:eu-central-1:111122223333:topicName",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:partition:chime::111122223333:*"
            },
           "StringEquals": {
               "aws:SourceAccount": "111122223333"
           }
        }
     }
  ]
}