Configuração de notificações - Amazon WorkDocs

Aviso: novas inscrições de clientes e atualizações de conta não estão mais disponíveis para a Amazon. WorkDocs Saiba mais sobre as etapas de migração aqui: Como migrar dados da Amazon WorkDocs.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração de notificações

Você segue esse processo para configurar as notificações:

  1. Defina permissões de usuário ou função do IAM para permitir que o chamador acesse o gerenciamento de assinaturas de APIs notificações.

  2. Ligue para a assinatura de notificação APIs para ativar ou desativar a publicação de mensagens do SNS em seu endpoint.

nota

Para maior segurança, crie usuários federados em vez de usuários do IAM sempre que possível.

Para definir as permissões de um usuário IAM

  • Use o console do IAM para definir as seguintes permissões para o usuário:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "workdocs:CreateNotificationSubscription",
            "workdocs:DeleteNotificationSubscription",
            "workdocs:DescribeNotificationSubscriptions"
            ],
        "Resource": "*"
        }
    ]
}
Como ativar notificações

A ativação das notificações permite que você ligue CreateNotificationSubscriptiondepois de assinar as notificações.

  1. Abra o WorkDocs console da Amazon em https://console.aws.amazon.com/zocalo/.

  2. Na página Gerenciar seus WorkDocs sites, selecione o diretório desejado e escolha Ações e, em seguida, Gerenciar notificações.

  3. Na página Manage Notifications (Gerenciar notificações), selecione Enable Notifications (Ativar notificações).

  4. Insira o ARN do usuário ou função que você deseja permitir que receba notificações do seu site da Amazon WorkDocs .

Para obter informações sobre como permitir que WorkDocs a Amazon use notificações, consulte Como usar a WorkDocs API da Amazon com o AWS SDK para Python e o AWS Lambda. Depois de ativar as notificações, você e seu usuário podem se inscrever nelas.

Para se inscrever para WorkDocs receber notificações

  1. Prepare o endpoint para processar mensagens do Amazon SNS. Para obter mais informações, consulte Fanout to HTTP/S endpoints no Guia do desenvolvedor do Amazon Simple Notification Service.

    Importante

    O SNS envia uma mensagem de confirmação ao seu endpoint configurado. Você deve confirmar essa mensagem para receber notificações. Além disso, se você precisar de módulos criptográficos validados pelo FIPS 140-2 ao acessar a AWS por meio de uma interface de linha de comando ou uma API, use um endpoint do FIPS. Para ter mais informações sobre endpoints do FIPS disponíveis, consulte Federal Information Processing Standard (FIPS) 140-2.

  2. Faça o seguinte:

    • Obter um ID de organização

      1. No painel de navegação do console do AWS Directory Service, escolha Diretórios.

      2. O ID do diretório correspondente ao seu WorkDocs site da Amazon também serve como ID da organização desse site.

    • Crie a solicitação de recebimento conforme este exemplo:

      CreateNotificationSubscriptionRequest request = new CreateNotificationSubscriptionRequest();
request.setOrganizationId("d-1234567890");
request.setProtocol(SubscriptionProtocolType.Https);
request.setEndpoint("https://my-webhook-service.com/webhook");
request.setSubscriptionType(SubscriptionType.ALL);
CreateNotificationSubscriptionResult result = amazonWorkDocsClient.createNotificationSubscription(request);
System.out.println("WorkDocs notifications subscription-id: " result.getSubscription().getSubscriptionId());

Notificações do SNS

A mensagem inclui as seguintes informações:

  • organizationId — O ID da organização.

  • parentEntityType — O tipo do pai (Document | DocumentVersion | Folder).

  • parentEntityId — O ID do pai.

  • entityType — O tipo da identidade (Document | DocumentVersion | Folder).

  • entityId — O ID da entidade.

  • action — A ação, que pode ter um dos seguintes valores:

    • delete_document

    • move_document

    • recycle_document

    • rename_document

    • revoke_share_document

    • share_document

    • upload_document_version

Como desativar notificações

  1. Abra o WorkDocs console da Amazon em https://console.aws.amazon.com/zocalo/.

  2. Na página Gerenciar seus WorkDocs sites, selecione o diretório desejado e escolha Ações e, em seguida, Gerenciar notificações.

  3. Na página Manage Notifications (Gerenciar notificações) selecione o ARN para o qual você deseja desativar as notificações e clique em Disable Notifications (Desativar notificações).