Schnittstelle, Webhooks und Zugriffskontrolle
Decken die fertigen Anbindungen den Ablauf nicht ganz ab, richten Sie bewussten Zugang für eine eigene Anbindung ein. Ordnen Sie zugleich die Mitglieder der Firma und Ihr Vorgehen bei einem Problem mit Zugang oder Daten.
Sie erweitern den Ablauf um weitere Werkzeuge und behalten dabei im Blick, wer worauf Zugriff hat. Der Umfang einer Anbindung ist klar festgelegt.
Schritt für Schritt
Beschreiben Sie zuerst den Bedarf
Halten Sie fest, welche Daten Sie lesen oder ändern wollen und in welchem System das Ergebnis entstehen soll. Prüfen Sie die verfügbaren Anbindungen und die Datenflüsse. Eine eigene Nutzung der Schnittstelle lohnt sich, wenn sie eine konkrete Lücke schliesst, statt eine bereits laufende Verbindung zu verdoppeln.
Öffnen Sie Konto und Schnittstellenschlüssel
Gehen Sie zu den Einstellungen der Schlüssel. Sehen Sie eine Zugriffsbeschränkung, prüfen Sie Berechtigungen und ob die Funktion für die Firma verfügbar ist. Lesen Sie die Beschreibung der Bereiche. Wer die Verbindung baut, sollte wissen, welche Vorgänge die Schnittstelle wirklich anbietet, bevor er einen Schlüssel erhält.
Legen Sie einen eigenen, benannten Schlüssel an
Klicken Sie auf das Anlegen eines Schlüssels. Geben Sie ihm einen Namen, der den Zweck nennt, etwa „Lagerauswertung“, und markieren Sie die nötigen Bereiche. Wählen Sie für das Lesen keine überflüssigen Schreibrechte. Getrennte Schlüssel erleichtern es, später eine Verbindung abzuschalten, ohne die anderen anzuhalten.
Bewahren Sie den Schlüssel am richtigen Ort auf
Kopieren Sie den Schlüssel nach dem Anlegen aus dem Fenster und speichern Sie ihn in der sicheren Einrichtung Ihrer Anbindung. Legen Sie ihn nicht in eine Supportanfrage, ein öffentliches Repository oder ein Bildschirmfoto. Die Liste dient der Verwaltung, ersetzt aber nicht, wie Ihre Anwendung Geheimnisse speichert.
Prüfen Sie einen einzelnen Vorgang
Führen Sie mit der technischen Person einen kleinen Lesevorgang gemäss der Dokumentation der verfügbaren Schnittstelle aus. Bestätigen Sie die richtige Firma, die Felder und den Berechtigungsumfang. Beurteilen Sie einen Schreibvorgang an einem kontrollierten Beispiel mit klarem erwartetem Ergebnis. Öffnen Sie danach den geänderten Datensatz in der Oberfläche.
Prüfen Sie: Die Verbindung führt den nötigen Vorgang aus und das Ergebnis entspricht dem Datensatz in NavyFlame.
Fügen Sie einen Webhook für ein bestimmtes Ereignis hinzu
Wählen Sie im Abschnitt Webhooks das Hinzufügen. Nennen Sie ein Ereignis aus der verfügbaren Liste und die HTTPS-Adresse Ihres eigenen Empfängers. Bewahren Sie das erhaltene Geheimnis auf und geben Sie es der Person, die die Prüfung der Nachrichten umsetzt. Speichern Sie keine beliebige Adresse, die das Ereignis nicht verarbeiten kann.
Prüfen Sie die Zustellungen
Nutzen Sie beim Webhook Test senden, danach den Zustellverlauf. Vergleichen Sie das Ergebnis mit dem Protokoll des Empfängers. Ihre eigene Anwendung sollte eine erneute Zustellung desselben Ereignisses korrekt verarbeiten. Prüfen Sie auch das erste echte Ereignis, das die Verbindung bearbeitet.
Sehen Sie Mitglieder und Berechtigungen durch
Prüfen Sie unter Konto, Mitglieder, wer Zugang zur Firma hat. Passen Sie die Rollen an die Aufgaben an und entziehen Sie nicht mehr nötigen Zugang gemäss Ihrer Teamorganisation. Wer packt, und eine technische Anbindung, brauchen nicht dieselben Möglichkeiten wie die Inhaberschaft.
Legen Sie mit dem Support fest, wie Daten wiederhergestellt werden
Die Benutzeroberfläche bietet keine hier beschriebene Konsole zum eigenständigen Anlegen und Zurückspielen von Sicherungen. Legen Sie unter Support das Verfahren für Ihren Dienst fest, den nötigen Umfang und die entscheidende Person. Der Regelverlauf erlaubt es, eine Fassung einer Regel zurückzuholen, ist aber keine Kopie der ganzen Firma.
Führen Sie eine kurze Liste der Verbindungen
Notieren Sie Name der Anbindung, zuständige Person, genutzten Schlüssel, Umfang und wo Fehler zu prüfen sind. Sehen Sie den Zugang nach einem Wechsel von Personal oder Werkzeugen durch. Schalten Sie einen ungenutzten Schlüssel oder Webhook ab, bestätigen Sie, dass die gemeinte Verbindung endete und die anderen weiterlaufen.
Was dieses Kapitel Ihnen bringt
Sie haben benannte Verbindungen, einen geprüften Zugriffsumfang und ein vereinbartes Vorgehen, falls Daten je wiederhergestellt werden müssen.
In der Demo lernen Sie die Ansichten an Beispieldaten kennen. Eigene Anbindungen richten Sie ein, sobald Sie ein Konto haben.
Demo ansehenNavyFlame-Konto anlegen