Administrar webhooks

Como administrador, puede actualizar y administrar webhooks actualizando su configuración (por ejemplo, actualizando los desencadenadores de eventos a los que está suscrito el webhook), así como deshabilitando y eliminando webhooks configurados anteriormente.

Actualizar webhooks

Puede actualizar los parámetros configurados de los webhooks después de crearlos. En las siguientes secciones se describe cómo actualizar las propiedades de los webhooks de servicios y de organización.

Actualizar webhooks de organización

Para actualizar un webhook de organización a través del sitio web del portal de ArcGIS Enterprise, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de la organización.
2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de organización, localice el webhook que desea actualizar.
4. Haga clic en el botón Opciones y luego en Editar.
5. En la ventana Editar webhook, modifique lo siguiente:
   1. Para actualizar el nombre del webhook, proporcione un nombre único para el webhook en el cuadro de texto Nombre.
   2. Para actualizar el tipo de webhook, haga clic en el menú desplegable Tipo y seleccione un nuevo tipo de webhook.
      • Al seleccionar Todo, se le suscribe a todos los desencadenadores de eventos compatibles. Recibirá notificaciones de cada evento a medida que ocurran.
      • Seleccionar Elementos, Usuarios, Grupos o Roles le permite definir manualmente a qué eventos desencadenadores desea suscribirse.
   3. Si selecciona un tipo de webhook distinto de Todo, aparecerá un menú desplegable adicional relativo al tipo de webhook elegido. Por ejemplo, si seleccionó Elementos para el tipo de webhook, aparece el menú desplegable Elementos, que le permite seleccionar un elemento específico que supervisará el webhook.
   4. Para actualizar los desencadenadores de eventos, haga clic en el menú desplegable Eventos y seleccione un nuevo evento desencadenador. Por ejemplo, si desea que se invoque el webhook al publicar un elemento específico, seleccione /items/<item ID>/publish.
   5. Si necesita actualizar la URL de carga, seleccione URL de webhook y proporcione la nueva URL de carga para el receptor de webhook.
   6. Si lo desea, agregue una cadena alfanumérica que actúe como secreto para el webhook o actualice un secreto preexistente en el cuadro de texto Secreto (opcional). El valor del secreto se utilizará para generar una firma que se incluirá en los encabezados de la carga del webhook. El receptor del webhook puede utilizar esta firma para determinar si el mensaje es de confianza.
6. Haga clic en Actualizar webhook para aplicar los cambios.

Actualizar webhooks de servicio

Para actualizar las propiedades de un webhook de servicio, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de servicio.

   Nota:

   Los miembros que tengan asignado el rol Publisher podrán crear o administrar webhooks de servicio desde el sitio del portal de ArcGIS Enterprise y tendrán que llevar a cabo estos flujos de trabajo mediante la API administrativa.

2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de servicio, localice el webhook que desea actualizar.
4. Haga clic en el botón Opciones y luego en Editar.
5. En la ventana Editar webhook, modifique lo siguiente:
   1. Para actualizar el nombre del webhook, proporcione un nombre único para el webhook en el cuadro de texto Nombre.
   2. Para actualizar el servicio con el que está asociado el webhook, haga clic en el menú desplegable Servicio y seleccione un servicio nuevo.

      Nota:

      Al seleccionar un servicio de geoprocesamiento el evento se establecerá como Servicio finalizado. Al seleccionar un servicio de entidades se hablitará el menú desplegable Eventos.

   3. Si selecciona un webhook de servicio de entidades, seleccione nuevos desencadenadores de eventos en el menú desplegable Eventos. Por ejemplo, si desea que se invoque el webhook cuando se acutaliza un adjunto de entidad, seleccione AttachmentsUpdated.
   4. Si necesita actualizar la URL de carga, seleccione URL de webhook y proporcione la nueva URL de carga para el receptor de webhook.
   5. Si lo desea, agregue una cadena alfanumérica que actúe como secreto para el webhook o actualice un secreto preexistente en el cuadro de texto Secreto (opcional). El valor del secreto se utilizará para generar una firma que se incluirá en los encabezados de la carga del webhook. El receptor del webhook puede utilizar esta firma para determinar si el mensaje es de confianza.
6. Haga clic en Actualizar webhook para aplicar los cambios.

Desactivar webhooks

Los webhooks se pueden desactivar manualmente o una vez que se cumple la política de desactivación. Cuando se desactiva un webhook, el webhook se pausa y no puede enviar cargas cuando se desencadenan. En las siguientes secciones se describe cómo desactivar los webhooks de servicios y de organización.

Desactivar webhooks de organización

Para desactivar un webhook de organización a través del sitio web del portal de ArcGIS Enterprise, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de la organización.
2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de organización, localice el webhook de la organización que desee desactivar y haga clic en Activo.
4. Haga clic en Confirmar para pausar el webhook.

Desactivar webhooks de servicio

Para desactivar un webhook de servicio, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de servicio.

   Nota:

   Los miembros que tengan asignado el rol Publisher podrán crear o administrar webhooks de servicio desde el sitio del portal de ArcGIS Enterprise y tendrán que llevar a cabo estos flujos de trabajo mediante la API administrativa.

2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de servicio, localice el webhook de servicio que desea desactivar y haga clic en Activo.
4. Haga clic en Confirmar para pausar el webhook.

Activar webhooks

Mientras un webhook está desactivado, no podrá enviar cargas. Al reactivar un webhook, se reinicia el webhook y se habilita para enviar cargas la próxima vez que se invoque el webhook. En las siguientes secciones se describe cómo activar los webhooks de organización y servicio previamente desactivados.

Activar webhooks de organización

Para activar un webhook de organización a través del sitio web del portal de ArcGIS Enterprise, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de la organización.
2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de organización, localice el webhook de la organización que desee activar y haga clic en Inactivo.
4. Haga clic en Confirmar para reiniciar el webhook.

Activar webhooks de servicio

Para activar un webhook de servicio, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de servicio.

   Nota:

   Los miembros que tengan asignado el rol Publisher podrán crear o administrar webhooks de servicio desde el sitio del portal de ArcGIS Enterprise y tendrán que llevar a cabo estos flujos de trabajo mediante la API administrativa.

2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de servicio, localice el webhook de servicio que desea activar y haga clic en Inactivo.
4. Haga clic en Confirmar para reiniciar el webhook.

Eliminar webhooks

Si ya no se necesita un webhook creado anteriormente, puede quitarlo de su organización de forma permanente eliminándolo. En las siguientes secciones, se describe cómo eliminar webhooks de organización y de servicio.

Eliminar webhooks de organización

Para actualizar un webhook de organización a través del sitio web del portal de ArcGIS Enterprise, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de la organización.
2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de organización, localice el webhook de organización que desea actualizar.
4. Haga clic en el botón Opciones y luego en Eliminar.
5. En la ventana Eliminar, haga clic en el botón Confirmar para eliminar permanentemente el webhook.

Eliminar webhooks de servicio

Para eliminar un webhook de servicio, siga estos pasos:

1. Compruebe que haya iniciado sesión como administrador predeterminado o como miembro con un rol personalizado con privilegios administrativos para crear y administrar los webhooks de servicio.

   Nota:

   Los miembros que tengan asignado el rol Publisher podrán crear o administrar webhooks de servicio desde el sitio del portal de ArcGIS Enterprise y tendrán que llevar a cabo estos flujos de trabajo mediante la API administrativa.

2. Vaya a Organización > Configuración > Webhooks.
3. En Webhooks de servicio, localice el webhook de servicio que desea actualizar.
4. Haga clic en el botón Opciones y luego en Eliminar.
5. En la ventana Eliminar, haga clic en el botón Confirmar para eliminar permanentemente el webhook.