Configuración de notificaciones - Amazon WorkDocs

Aviso: las suscripciones de nuevos clientes y las actualizaciones de cuentas ya no están disponibles para Amazon. WorkDocs Obtén más información sobre los pasos de migración aquí: Cómo migrar datos de Amazon WorkDocs.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración de notificaciones

Sigue este proceso para configurar las notificaciones:

  1. Configura los permisos de usuario o rol de IAM para permitir que las personas que llaman accedan a la gestión de suscripciones a las notificaciones. APIs

  2. Llame a la suscripción de notificaciones APIs para activar o desactivar la publicación de mensajes de SNS en su terminal.

nota

Para mayor seguridad, cree usuarios federados en lugar de usuarios de IAM siempre que sea posible.

Para establecer los permisos de usuarios de IAM

  • Utilice la consola IAM para configurar los siguientes permisos para el usuario:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "workdocs:CreateNotificationSubscription",
            "workdocs:DeleteNotificationSubscription",
            "workdocs:DescribeNotificationSubscriptions"
            ],
        "Resource": "*"
        }
    ]
}
Para habilitar las notificaciones

La activación de las notificaciones le permite llamar CreateNotificationSubscriptiondespués de suscribirse a las notificaciones.

  1. Abre la WorkDocs consola de Amazon en https://console.aws.amazon.com/zocalo/.

  2. En la página Gestiona tus WorkDocs sitios, selecciona el directorio deseado y selecciona Acciones y, a continuación, Administrar notificaciones.

  3. En la página Administrar notificaciones, elija Habilitar notificaciones.

  4. Introduce el ARN del usuario o rol al que quieres permitir que reciba notificaciones de tu sitio de Amazon WorkDocs .

Para obtener información sobre cómo permitir que Amazon WorkDocs utilice las notificaciones, consulte Uso de la WorkDocs API de Amazon con el SDK de AWS para Python y AWS Lambda. Una vez que habilite las notificaciones, usted y su usuario podrán suscribirse a ellas.

Para suscribirse a las notificaciones WorkDocs

  1. Prepare el punto de conexión para procesar mensajes de Amazon SNS. Para obtener más información, consulte Distribución ramificada a puntos de conexión HTTP/S en la Guía para desarrolladores de Amazon Simple Notification Service.

    importante

    SNS envía un mensaje de confirmación al punto de conexión configurado. Debe confirmar este mensaje para recibir las notificaciones. Además, si necesita módulos criptográficos validados FIPS 140-2 al acceder a AWS a través de una interfaz de la línea de comandos o una API, utilice un punto de conexión de FIPS. Para obtener más información sobre los puntos de conexión de FIPS disponibles, consulte Estándar de procesamiento de la información federal (FIPS) 140-2.

  2. Haga lo siguiente:

    • Obtención de un ID de organización

      1. En el panel de navegación de la consola AWS Directory Service, elija Directorios.

      2. El ID de directorio correspondiente a tu WorkDocs sitio de Amazon también sirve como ID de organización para ese sitio.

    • Cree una solicitud de suscripción como la siguiente:

      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());

Notificaciones de SNS

El mensaje incluye la siguiente información:

  • organizationId: el ID de la organización.

  • parentEntityType: el tipo de entidad principal (Document | DocumentVersion | Folder).

  • parentEntityId: el ID de la entidad principal.

  • entityType: el tipo de la entidad (Document | DocumentVersion | Folder).

  • entityId: el ID de la entidad.

  • action: la acción, que puede ser uno de los siguientes valores:

    • delete_document

    • move_document

    • recycle_document

    • rename_document

    • revoke_share_document

    • share_document

    • upload_document_version

Para deshabilitar las notificaciones

  1. Abre la WorkDocs consola de Amazon en https://console.aws.amazon.com/zocalo/.

  2. En la página Gestiona tus WorkDocs sitios, selecciona el directorio deseado y selecciona Acciones y, a continuación, Administrar notificaciones.

  3. En la página Administrar notificaciones, seleccione el ARN para el desea deshabilitar las notificaciones y elija Deshabilitar notificaciones.