Notificações de eventos do SDK do Amazon Chime

O Amazon Chime SDK suporta o envio de notificações de eventos de reuniões para a Amazon, Amazon Simple Queue Service (SQS) EventBridge, Amazon Simple Queue Service (SQS) e Amazon Simple Notification Service (SNS).

nota

O namespace padrão de reuniões do Amazon Chime SDK usa os endpoints. ChimeSDKMeetings O namespace Chime legado usa um único endpoint. Para obter mais informações sobre namespaces e endpoints, consulteComo migrar para o namespace SDK Meetings do Amazon Chime, anteriormente neste guia.

Enviando notificações para EventBridge

Você pode enviar notificações de eventos do Amazon Chime SDK para. EventBridge Para obter informações detalhadas sobre o uso do Amazon Chime SDK com EventBridge, consulte Automatizar o Amazon Chime SDK com o Amazon Chime SDK EventBridge no Guia do administrador do Amazon Chime SDK. Para obter informações sobre EventBridge, consulte o Guia EventBridge do usuário da Amazon.

Como enviar notificações para o Amazon SQS e o Amazon SNS

Você pode usar a CreateMeetingAPI na Referência de API do SDK do Amazon Chime para enviar notificações de eventos de reuniões do SDK do Amazon Chime para uma fila do Amazon SQS e um tópico do Amazon SNS por reunião. Isso pode ajudar a reduzir a latência das notificações. Para obter mais informações sobre o Amazon SQS, consulte o Guia do desenvolvedor do Amazon Simple Queue Service. Para obter mais informações sobre tópicos do Amazon SNS, consulte o Guia do desenvolvedor do Amazon Simple Notification Service.

As notificações enviadas para o Amazon SQS e o Amazon SNS contêm as mesmas informações que as notificações para as quais o SDK do Amazon Chime envia. EventBridge O SDK do Amazon Chime suporta o envio de notificações de eventos de reuniões para filas e tópicos na região da API usados para criar uma reunião. As notificações de eventos podem ser entregues fora da ordem de ocorrência.

Como conceder ao SDK do Amazon Chime acesso ao Amazon SQS e ao Amazon SNS

Antes que o SDK do Amazon Chime possa enviar notificações por meio de uma fila do Amazon SQS ou tópico do Amazon SNS, você deve conceder ao SDK do Amazon Chime permissão para publicar mensagens no nome do recurso da Amazon (ARN) da fila ou do tópico. Para fazer isso, anexe uma política AWS Identity and Access Management (IAM) à fila ou ao tópico que conceda as permissões apropriadas ao SDK do Amazon Chime. Para obter mais informações, consulte Gerenciamento de identidade e acesso no Amazon SQS no Guia do desenvolvedor do Amazon Simple Queue Service e Casos de exemplo para controle de acesso do Amazon SNS no Guia do desenvolvedor do Amazon Simple Notification Service.

nota

Sua fila do Amazon SQS ou tópico do Amazon SNS deve usar a mesma região do AWS seu endpoint da API Amazon Chime SDK.

exemplo Permita que o SDK do Amazon Chime publique eventos em uma fila do Amazon SQS

O exemplo de política do IAM a seguir concede ao SDK do Amazon Chime permissão para publicar notificações de eventos de reuniões na fila especificada do Amazon SQS. Observe a declaração condicional para aws:SourceArn e aws:SourceAccount. Eles abordam possíveis problemas Confused Deputy.

nota

• Você pode usar aws:SourceArn ou aws:SourceAccount ao criar as políticas abaixo. Não é necessário usar ambos.

• Esses exemplos usam o namespace ChimeSDKMeetings e o endpoint correspondente. Se você usar o namespace Chime, deverá usar o endpoint 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"
               }
            }
        }
   ]
}

Este exemplo mostra uma política do Amazon SNS que permite que o SDK do Amazon Chime envie notificações de eventos de reuniões para seu tópico do 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"
          }
       }
     }
   ]
}

Se a fila do Amazon SQS estiver habilitada para criptografia do lado do servidor (SSE), é necessário realizar uma etapa adicional. Anexe uma política do IAM à AWS KMS chave associada que concede ao SDK do Amazon Chime permissão para as AWS KMS ações necessárias para criptografar dados adicionados à fila.

{
    "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": "*"
        }
    ]
}

exemplo Permita que o SDK do Amazon Chime publique eventos em um tópico do Amazon SNS

O exemplo de política do IAM a seguir concede ao SDK do Amazon Chime permissão para publicar notificações de eventos de reuniões no tópico especificado do Amazon 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"
           }
        }
     }
  ]
}