Gestire webhook

Un amministratore può aggiornare e gestire i webhook aggiornandone la configurazione (ad esempio aggiornando i trigger di eventi a cui è abbonato il webhook), nonché disabilitando ed eliminando i webhook configurati.

Aggiornare webhook

Puoi aggiornare i parametri configurati per i webhook dopo la creazione. Le sezioni seguenti illustrano come aggiornare le proprietà per i webhook dell'organizzazione e del servizio.

Aggiornare i webhook dell'organizzazione

Per aggiornare un webhook dell'organizzazione tramite il sito Web del portale ArcGIS Enterprise, attenersi alla seguente procedura:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook dell'organizzazione.
2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook organizzazione, individuare il webhook da aggiornare.
4. Fare clic sul pulsante Opzioni, quindi fare clic su Modiifica.
5. Nella finestra Modifica webhook, modificare i seguenti elementi:
   1. Per aggiornare il nome del webhook, immetti un nome univoco per il webhook nella casella di testo Nome.
   2. Per aggiornare il tipo del webhook, fare clic sul menu a discesa Tipo e selezionare il nuovo tipo.
      • Selezionando Tutti si effettua la sottoscrizione a tutti i trigger di eventi supportati. Riceverai notifiche per ciascun evento quando si verifica.
      • Selezionare Elementi, Utenti, Gruppi o Ruoli consente di definire manualmente a quali eventi di trigger si desidera effettuare la sottoscrizione.
   3. Se si seleziona un tipo di webhook diverso da Tutti, comparirà un ulteriore menu a discesa relativo al tipo di webhook che è stato scelto. Ad esempio, se si è selezionato Elementi per il tipo di webhook, compare il menu a discesa Elementi che consente di selezionare un elemento specifico che verrà monitorato dal webhook.
   4. Per aggiornare i trigger degli eventi, fare clic sul menu a discesa Eventi e selezionare un nuovo evento di trigger. Ad esempio, se si desidera che il webhook venga invocato quando un elemento specifico viene pubblicato, selezionare /items/<ID elemento>/publish.
   5. Se è necessario aggiornare l'URL di payload, selezionare URL webhook e fornire il nuovo URL di payload per il ricevitore webhook.
   6. Se è necessario mantenere l'elemento del notebook, selezionare Notebook e scegliere il nuovo notebook che verrà eseguito quando il webhook viene azionato.
   7. Facoltativamente, aggiungere una stringa alfanumerica che funga da segreto per il webhook o aggiornare un segreto preesistente nella casella di testo Segreto (facoltativo). Il valore segreto sarà usato per generare una firma inclusa nelle intestazioni di payload del webhook. Il ricevitore del webhook può utilizzare questa firma per stabilire se il messaggio può essere ritenuto attendibile.
6. Fare clic su Aggiorna webhook per applicare le modifiche.

Aggiornare i webhook del servizio

Per aggiornare le proprietà del webhook del servizio, effettuare questi passaggi:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook del servizio.

   Nota:

   I membri assegnati al ruolo di publisher non potranno creare o gestire i webhook del servizio dal sito del portale ArcGIS Enterprise e dovranno eseguire questi flussi di lavoro di tramite l'API amministrativa. Flussi di lavoro di

2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook servizio, individuare il webhook da aggiornare.
4. Fare clic sul pulsante Opzioni, quindi fare clic su Modiifica.
5. Nella finestra Modifica webhook, modificare i seguenti elementi:
   1. Per aggiornare il nome del webhook, immetti un nome univoco per il webhook nella casella di testo Nome.
   2. Per aggiornare il servizio a cui è associato il webhook, fare clic sul menu a discesa Servizio e selezionare un nuovo servizio.

      Nota:

      Selezionando un servizio di geoprocessing si imposta l'evento come Servizio terminato Selezionando un feature service si abilita il menu a discesa Eventi.

   3. Se si seleziona un webhook di feature service, selezionare un nuovo attivatore di eventi dal menu a discesa Eventi. Ad esempio, se si desidera che il webhook venga richiamato quando viene aggiornato un allegato di una feature, selezionare AttachmentsUpdated.
   4. Se è necessario aggiornare l'URL di payload, selezionare URL webhook e fornire il nuovo URL di payload per il ricevitore webhook.
   5. Facoltativamente, aggiungere una stringa alfanumerica che funga da segreto per il webhook o aggiornare un segreto preesistente nella casella di testo Segreto (facoltativo). Il valore segreto sarà usato per generare una firma inclusa nelle intestazioni di payload del webhook. Il ricevitore del webhook può utilizzare questa firma per stabilire se il messaggio può essere ritenuto attendibile.
6. Fare clic su Aggiorna webhook per applicare le modifiche.

Disattivare i webhook

I webhook possono essere disattivati manualmente oppure quando è soddisfatta la politica di disattivazione. Quando un webhook viene disattivato, il webhook viene sospeso e non può fornire i payload quando vengono attivati. In questa sezione viene illustrano come disattivare i webhook dell'organizzazione e del servizio.

Disattivare i webhook dell'organizzazione

Per disattivare un webhook dell'organizzazione tramite il sito Web del portale ArcGIS Enterprise, attenersi alla seguente procedura:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook dell'organizzazione.
2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webook organizzazione, individuare il webhook dell'organizzazione da disattivare e fare clic su Attiva.
4. Fare clic su Conferma per eliminare mettere in pausa il webhook.

Disattivare i webhook del servizio

Per disattivare un webhook del servizio, procedere nel modo seguente:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook del servizio.

   Nota:

   I membri assegnati al ruolo di publisher non potranno creare o gestire i webhook del servizio dal sito del portale ArcGIS Enterprise e dovranno eseguire questi flussi di lavoro di tramite l'API amministrativa. Flussi di lavoro di

2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook de servizio, individuare il webhook del servizio da disattivare e fare clic su Attiva.
4. Fare clic su Conferma per eliminare mettere in pausa il webhook.

Attivare webhook

Se un webhook è disattivato, non può consegnare i payload. La riattivazione di un webhook riavvia il webhook consentendogli di consegnare i payload quando viene richiamato il webhook successivo. Le sezioni seguenti illustrano come attivare i webhook dell'organizzazione e del servizio precedentemente disattivati.

Attivare i webhook dell'organizzazione

Per attivare un webhook dell'organizzazione tramite il sito Web del portale ArcGIS Enterprise, attenersi alla seguente procedura:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook dell'organizzazione.
2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook organizzazione, individuare il webhook dell'organizzazione da attivare e fare clic su Inattivo.
4. Fare clic su Conferma per riavviare il webhook.

Attivare i webhook del servizio

Per attivare un webhook del servizio, procedere nel modo seguente:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook del servizio.

   Nota:

   I membri assegnati al ruolo di publisher non potranno creare o gestire i webhook del servizio dal sito del portale ArcGIS Enterprise e dovranno eseguire questi flussi di lavoro di tramite l'API amministrativa. Flussi di lavoro di

2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook del servizio, individuare il webhook del servizio da attivare e fare clic su Inattivo.
4. Fare clic su Conferma per riavviare il webhook.

Eliminare webhook

Se un webhook precedentemente creato non serve più, è possibile rimuoverlo definitivamente dall'organizzazione eliminandolo. Nelle sezioni seguenti viene descritto come eliminare i webhook dell'organizzazione, del servizio.

Eliminare i webhook dell'organizzazione

Per aggiornare un webhook dell'organizzazione tramite il sito Web del portale ArcGIS Enterprise, attenersi alla seguente procedura:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook dell'organizzazione.
2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook organizzazione, individuare il webhook dell'organizzazione da aggiornare.
4. Fare clic sul pulsante Opzioni e fare clic su Elimina.
5. Nella finestra Elimina, fare clic sul pulsante Conferma per rimuovere definitivamente il webhook.

Eliminare i webhook del servizio

Per eliminare un webhook del servizio, procedere nel modo seguente:

1. Verificare di aver effettuato l'accesso come amministratore predefinito o un membro di un ruolo personalizzato con privilegi di amministrazione per creare e gestire i webhook del servizio.

   Nota:

   I membri assegnati al ruolo di publisher non potranno creare o gestire i webhook del servizio dal sito del portale ArcGIS Enterprise e dovranno eseguire questi flussi di lavoro di tramite l'API amministrativa. Flussi di lavoro di

2. Accedi a Organizzazione > Impostazioni > Webhook.
3. In Webhook servizio, individuare il webhook del servizio da aggiornare.
4. Fare clic sul pulsante Opzioni e fare clic su Elimina.
5. Nella finestra Elimina, fare clic sul pulsante Conferma per rimuovere definitivamente il webhook.