Verwalten von Webhooks

Als Administrator können Sie Webhooks aktualisieren und verwalten, indem Sie ihre Konfiguration aktualisieren (z. B. die Ereignis-Trigger, die vom Webhook abonniert wurden) sowie zuvor konfigurierte Webhooks deaktivieren und löschen.

Aktualisieren von Webhooks

Sie können die für Webhooks konfigurierten Parameter nach der Erstellung aktualisieren. In den folgenden Abschnitten wird beschrieben, wie Sie Eigenschaften für Organisations- und Service-Webhooks aktualisieren.

Aktualisieren von Organisations-Webhooks

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktualisieren:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Organisations-Webhooks den Webhook, den Sie aktualisieren möchten.
4. Klicken Sie auf die Schaltfläche Optionen, und klicken Sie auf Bearbeiten.
5. Nehmen Sie im Fenster Webhook bearbeiten die folgenden Änderungen vor:
   1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein.
   2. Klicken Sie zum Aktualisieren des Webhook-Typs auf das Dropdown-Menü Typ, und wählen Sie einen neuen Webhook-Typ aus.
      • Wenn Sie Alle auswählen, werden alle unterstützten Ereignis-Trigger abonniert. Sie erhalten Benachrichtigungen für die einzelnen Ereignisse, sobald diese eintreten.
      • Wenn Sie Elemente, Benutzer, Gruppen oder Rollen auswählen, können Sie manuell festlegen, welche Trigger-Ereignisse Sie abonnieren möchten.
   3. Wenn Sie einen anderen Webhook-Typ als Alle auswählen, wird ein zusätzliches Dropdown-Menü angezeigt, das sich auf den ausgewählten Webhook-Typ bezieht. Wenn Sie beispielsweise Elemente als Webhook-Typ ausgewählt haben, wird das Dropdown-Menü Elemente angezeigt, über das Sie ein bestimmtes Element für die Überwachung durch den Webhook auswählen können.
   4. Klicken Sie zum Aktualisieren der Ereignis-Trigger auf das Dropdown-Menü Ereignisse, und wählen Sie ein neues Trigger-Ereignis aus. Wenn beispielsweise der Webhook aufgerufen werden soll, sobald ein bestimmtes Element veröffentlicht wird, wählen Sie /items/<Element-ID>/publish aus.
   5. Wählen Sie zum Aktualisieren der Payload-URL Webhook-URL aus, und geben Sie die neue Payload-URL für den Webhook-Empfänger an.
   6. Klicken Sie zum Aktualisieren des Notebook-Elements auf Notebook, und wählen Sie das neue Notebook aus, das beim Auslösen des Webhooks ausgeführt werden soll.
   7. Fügen Sie optional im Textfeld Secret (optional) eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret. Der Secret-Wert wird zum Generieren einer in den Webhook-Payload-Headern enthaltenen Signatur verwendet. Anhand dieser Signatur kann der Webhook-Empfänger feststellen, ob die Nachricht vertrauenswürdig ist.
6. Klicken Sie auf Webhook aktualisieren, um die Änderungen zu übernehmen.

Aktualisieren von Service-Webhooks

Führen Sie die folgenden Schritte aus, um die Eigenschaften eines Service-Webhooks zu aktualisieren:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Service-Webhooks angemeldet sind.

   Hinweis:

   Mitglieder, denen die Publisher-Rolle zugewiesen wurde, können keine Service-Webhooks über die ArcGIS Enterprise-Portal-Site erstellen oder verwalten und müssen diese Workflows über die administrative API ausführen.

2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Service-Webhooks den Webhook, den Sie aktualisieren möchten.
4. Klicken Sie auf die Schaltfläche Optionen, und klicken Sie auf Bearbeiten.
5. Nehmen Sie im Fenster Webhook bearbeiten die folgenden Änderungen vor:
   1. Geben Sie zum Aktualisieren des Webhook-Namens einen eindeutigen Namen für den Webhook in das Textfeld Name ein.
   2. Klicken Sie zum Aktualisieren des Service, mit dem der Webhook verknüpft ist, auf das Dropdown-Menü Service, und wählen Sie einen neuen Service aus.

      Hinweis:

      Durch Auswählen eines Geoverarbeitungsservice wird das Ereignis als Service ist beendet festgelegt. Durch Auswählen eines Feature-Service wird das Dropdown-Menü Ereignisse aktiviert.

   3. Wählen Sie bei Auswahl eines Feature-Service-Webhooks neue Ereignis-Trigger aus dem Dropdown-Menü Ereignisse aus. Wenn beispielsweise der Webhook aufgerufen werden soll, sobald eine Feature-Anlage aktualisiert wird, wählen Sie AttachmentsUpdated aus.
   4. Wählen Sie zum Aktualisieren der Payload-URL Webhook-URL aus, und geben Sie die neue Payload-URL für den Webhook-Empfänger an.
   5. Fügen Sie optional im Textfeld Secret (optional) eine alphanumerische Zeichenfolge hinzu, die als Secret für den Webhook verwendet wird, oder aktualisieren Sie ein bereits vorhandenes Secret. Der Secret-Wert wird zum Generieren einer in den Webhook-Payload-Headern enthaltenen Signatur verwendet. Anhand dieser Signatur kann der Webhook-Empfänger feststellen, ob die Nachricht vertrauenswürdig ist.
6. Klicken Sie auf Webhook aktualisieren, um die Änderungen zu übernehmen.

Deaktivieren von Webhooks

Webhooks können manuell oder nach Erfüllung der Deaktivierungsrichtlinie deaktiviert werden. Sobald ein Webhook deaktiviert wird, wird er unterbrochen und kann keine Payloads übermitteln, wenn diese ausgelöst werden. In den folgenden Abschnitten wird beschrieben, wie Sie Organisations- und Service-Webhooks deaktivieren.

Deaktivieren von Organisations-Webhooks

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu deaktivieren:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Organisations-Webhooks den Organisations-Webhook, den Sie deaktivieren möchten, und klicken Sie auf Aktiv.
4. Klicken Sie auf Bestätigen, um den Webhook anzuhalten.

Deaktivieren von Service-Webhooks

Gehen Sie zum Deaktivieren eines Service-Webhooks wie folgt vor:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Service-Webhooks angemeldet sind.

   Hinweis:

   Mitglieder, denen die Publisher-Rolle zugewiesen wurde, können keine Service-Webhooks über die ArcGIS Enterprise-Portal-Site erstellen oder verwalten und müssen diese Workflows über die administrative API ausführen.

2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Service-Webhooks den Service-Webhook, den Sie deaktivieren möchten, und klicken Sie auf Aktiv.
4. Klicken Sie auf Bestätigen, um den Webhook anzuhalten.

Aktivieren von Webhooks

Wenn ein Webhook deaktiviert wurde, können keine Payloads mehr über ihn übermittelt werden. Nach der Reaktivierung eines Webhooks wird dieser neu gestartet und kann beim nächsten Aufruf des Webhooks wieder Payloads übermitteln. In den folgenden Abschnitten wird beschrieben, wie Sie zuvor deaktivierte Organisations- und Service-Webhooks aktivieren.

Aktivieren von Organisations-Webhooks

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktivieren:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Organisations-Webhooks den Organisations-Webhook, den Sie aktivieren möchten, und klicken Sie auf Nicht aktiv.
4. Klicken Sie auf Bestätigen, um den Webhook neu zu starten.

Aktivieren von Service-Webhooks

Gehen Sie zum Aktivieren eines Service-Webhooks wie folgt vor:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Service-Webhooks angemeldet sind.

   Hinweis:

   Mitglieder, denen die Publisher-Rolle zugewiesen wurde, können keine Service-Webhooks über die ArcGIS Enterprise-Portal-Site erstellen oder verwalten und müssen diese Workflows über die administrative API ausführen.

2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Service-Webhooks den Service-Webhook, den Sie aktivieren möchten, und klicken Sie auf Nicht aktiv.
4. Klicken Sie auf Bestätigen, um den Webhook neu zu starten.

Löschen von Webhooks

Wenn ein zuvor erstellter Webhook nicht mehr benötigt wird, können Sie ihn dauerhaft aus der Organisation entfernen, indem Sie ihn löschen. In den folgenden Abschnitten wird beschrieben, wie Sie Organisations- und Service-Webhooks löschen.

Löschen von Organisations-Webhooks

Führen Sie die folgenden Schritte aus, um einen Organisations-Webhook über die ArcGIS Enterprise-Portal-Website zu aktualisieren:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Organisations-Webhooks angemeldet sind.
2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Organisations-Webhooks den Organisations-Webhook, den Sie aktualisieren möchten.
4. Klicken Sie zunächst auf die Schaltfläche Optionen und dann auf Löschen.
5. Klicken Sie im Fenster Löschen auf die Schaltfläche Bestätigen, um den Webhook dauerhaft zu entfernen.

Löschen von Service-Webhooks

Gehen Sie zum Löschen eines Service-Webhooks wie folgt vor:

1. Vergewissern Sie sich, dass Sie als Standardadministrator oder als Mitglied einer benutzerdefinierten Rolle mit Administratorberechtigungen zum Erstellen und Verwalten der Service-Webhooks angemeldet sind.

   Hinweis:

   Mitglieder, denen die Publisher-Rolle zugewiesen wurde, können keine Service-Webhooks über die ArcGIS Enterprise-Portal-Site erstellen oder verwalten und müssen diese Workflows über die administrative API ausführen.

2. Navigieren Sie zu Organisation > Einstellungen > Webhooks.
3. Suchen Sie unter Service-Webhooks den Service-Webhook, den Sie aktualisieren möchten.
4. Klicken Sie zunächst auf die Schaltfläche Optionen und dann auf Löschen.
5. Klicken Sie im Fenster Löschen auf die Schaltfläche Bestätigen, um den Webhook dauerhaft zu entfernen.