Configuración de notificaciones para un usuario o función de IAM - 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 para un usuario o función de IAM

Para crear y administrar notificaciones en Amazon WorkDocs, los administradores utilizan las consolas IAM y Amazon WorkDocs. Utiliza la consola de IAM para establecer permisos de usuario y utiliza la consola de Amazon WorkDocs para habilitar las notificaciones. Una vez habilitadas las notificaciones, te suscribes a ellas. Siga estos pasos.

Para configurar los permisos de usuario

  • Utilice la consola de IAM para establecer 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

Habilitar notificaciones le permite llamarCreateNotificationSubscriptiondespués de suscribirse a las notificaciones de.

  1. Abra la consola de Amazon WorkDocs enhttps://console.aws.amazon.com/zocalo/.

  2. En la página Administrar sus sitios de WorkDocs, seleccione el directorio que desee, y elija Acciones y Administrar notificaciones.

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

  4. Escriba el ARN del usuario o función al que desea permitir recibir notificaciones desde el sitio de Amazon WorkDocs.

Para obtener información sobre cómo habilitar Amazon WorkDocs para utilizar notificaciones, consulteUso de la API de Amazon WorkDocs con AWS SDK para Python y AWS Lambda. Una vez habilitadas las notificaciones, usted y su usuario pueden suscribirse a ellas.

Para suscribirse a las notificaciones de WorkDocs

  1. Prepare el punto de enlace para procesar mensajes de Amazon SNS. Para obtener más información, consulteDistribución ramificada a puntos de enlace HTTP/Sen laGuía para desarrolladores de Amazon Simple Notification Service.

    importante

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

  2. Haga lo siguiente:

    • Obtener un ID de organización

      1. En el navegadorConsola de AWS Directory Servicepanel de navegación, seleccioneDirectorios.

      2. LaID de directoriocorrespondiente a su sitio de Amazon WorkDocs también sirve como ID de organización de ese sitio de.

    • 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 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. Abra la consola de Amazon WorkDocs enhttps://console.aws.amazon.com/zocalo/.

  2. En la página Administrar sus sitios de WorkDocs, seleccione el directorio que desee, y elija Acciones y Administrar notificaciones.

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