Häufig gestellte Fragen zu Webhooks

In diesem Thema sind Fragen oder Probleme, die bei der Arbeit mit Webhooks auftreten können, und mögliche Lösungen aufgeführt.

• ArcGIS Enterprise wird in einer nicht verbundenen Umgebung hinter der Firewall meiner Organisation bereitgestellt. Kann ich trotzdem Webhooks konfigurieren?

• Was löst eine Aktualisierung eines Elements, eines Benutzers oder einer Gruppe aus?

• Ich verwende in meinem ArcGIS Enterprise-Portal die integrierte Windows-Authentifizierung. Kann ich trotzdem die An- und Abmeldung von Benutzern im bzw. aus dem Portal abonnieren (user/<username>/signIn)?

• Was passiert, wenn meine Payload-URL ausfällt oder nicht mehr verfügbar ist? Gibt es eine Möglichkeit, eine Payload wiederherzustellen, die nicht übermittelt wurde?

ArcGIS Enterprise wird in einer nicht verbundenen Umgebung hinter der Firewall meiner Organisation bereitgestellt. Kann ich trotzdem Webhooks konfigurieren?

Ja. Um Webhooks zu konfigurieren, müssen Sie eine Payload-URL verwenden, die über Ihr ArcGIS Enterprise-Portal erreichbar ist. Dazu können Sie eine benutzerdefinierte Anwendung und auf Ihrem internen Server bereitstellen.

Was löst eine Aktualisierung eines Elements, eines Benutzers oder einer Gruppe aus?

Wenn Sie Aktualisierungen für Ihre Portal-Elemente, Benutzer und Gruppen abonniert haben, wird Ihr Webhook ausgelöst, wenn deren Eigenschaften aktualisiert wurden. Wenn Sie beispielsweise Aktualisierungen für ein bestimmtes Element in Ihrem Portal abonniert haben, wird Ihr Webhook ausgelöst, sobald der Titel, die Tags oder die Miniaturansicht des Elements aktualisiert wurden. Der Netzwerkverkehr bietet Aufschluss darüber, ob eine Aktion eine Aktualisierung im Portal bewirkt. Jedes Mal, wenn eine Aktion zu einer Aktualisierung führt, kann diese Aktion auch einen Webhook auslösen, der auf Aktualisierungen wartet.

Ich verwende in meinem ArcGIS Enterprise-Portal die integrierte Windows-Authentifizierung. Kann ich trotzdem die An- und Abmeldung von Benutzern im bzw. aus dem Portal abonnieren (user/<username>/signIn)?

Ab Version 10.9 können Sie mit dem Trigger-Ereignis /signin Anmeldeereignisse für die Portal-Authentifizierung, die Authentifizierung auf Webebene und für Enterprise-Anmeldenamen erfassen.

Was passiert, wenn meine Payload-URL ausfällt oder nicht mehr verfügbar ist? Gibt es eine Möglichkeit, eine Payload wiederherzustellen, die nicht übermittelt wurde?

Beim Einrichten von Organisations-Webhooks für Benutzer, Gruppen und Elemente haben Sie die Möglichkeit, erweiterte Parameter zu konfigurieren. Damit wird festgelegt, wie und wann das Portal einen weiteren Übermittlungsversuch unternimmt, wenn eine Payload nicht gesendet werden kann, und wie die Deaktivierungsrichtlinie lautet, mit der der Webhook deaktiviert wird, wenn das Senden einer Payload weiterhin fehlschlägt. Wenn das Portal versucht, eine Payload an einen nicht erreichbaren oder nicht reagierenden Payload-URL- oder Webhook-Empfänger zu übermitteln, bestimmen die von Ihnen festgelegten erweiterten Parameter, wie viele weitere Übermittlungsversuche das Portal für die Payload unternimmt. Wenn auch die weiteren Versuche fehlschlagen, zählen sie im Hinblick auf die Deaktivierungsrichtlinie als ein einzelner Fehler.

Sie können auch den Benachrichtigungsstatus eines Webhooks aufrufen, um alle Payload-Übermittlungsversuche anzuzeigen und herauszufinden, ob diese erfolgreich waren.

Hinweis:

Service-Webhooks unterstützen derzeit weder das Nachverfolgen von Payloads noch Deaktivierungsrichtlinien.