Eigene Connectors

Ein eigener Connector ist ein Dienst, den Sie selbst beschreiben: jede API im Internet, die einen Schlüssel verlangt. Sobald er erstellt ist, nutzen Ihre Apps ihn wie jeden Connector aus der Liste, über Setherion, wobei der Schlüssel auf unseren Servern bleibt.

Klicken Sie oben rechts auf der Seite Connectors auf +, dann auf Custom connector, und füllen Sie aus:

• Details. Einen Display name, eine Short description für die Liste, eine längere Description, eine Category und eine optionale Adresse der Dokumentation.
• Authentication. Wie der Schlüssel übertragen wird: als Bearer token, als API key in a header (Sie nennen den Header), als API key in the address (Sie nennen den Parameter) oder als Username and password. Sie können auch benennen, wonach Personen gefragt werden, zum Beispiel „Password“. What requests to this API will look like zeigt es Ihnen, während Sie wählen. Danach die API base URL, mit der jede Anfrage beginnt, und eine Test request: ein einfacher Aufruf, der ohne gültigen Schlüssel fehlschlägt, etwa einer, der das aktuelle Konto zurückgibt.
• Who may use it. Only your app's team (die Voreinstellung), Visitors can read oder Anybody, dann die Arten von Anfragen, die Apps senden dürfen: GET liest, die anderen ändern etwas. Bei Visitors can read darf jeder, der die App öffnet, lesen, und nur das Team ändert etwas. Bei Anybody darf jeder alle Aufrufe ausführen, die Sie erlaubt haben, und Aufrufe werden pro Besucher strenger begrenzt, wählen Sie es also nur für eine API, die dafür gebaut ist.
• Agent knowledge. Optional und lohnend: die Pfade, zu jedem eine Anfrage und eine Antwort, und alles, was leicht falsch gemacht wird. Setherion liest es, wenn es Ihre Apps erstellt. Ohne diese Angaben muss Setherion die Pfade raten, und eine Vermutung kann falsch sein: Sagen Sie zum Beispiel, welcher Pfad Ihr eigenes Konto zurückgibt. Fügen Sie hier niemals einen Schlüssel ein.

Im Formular steht kein Schlüssel. Create öffnet die Seite des Connectors, auf der Sie den Schlüssel hinzufügen, auf Test connection klicken und verbinden, wie bei jedem anderen Dienst. Edit und Delete befinden sich ebenfalls auf dieser Seite. Beim Löschen wird auch sein Schlüssel entfernt, und Apps, die ihn nutzen, erreichen ihn sofort nicht mehr.

Ask. Sobald er verbunden und für eine App angehakt ist, fragen Sie ihn mit Namen an: „Show my open projects from Acme on the dashboard.“ „Add a button that creates a task in Acme.“

• Die API base URL muss mit https:// beginnen und im öffentlichen Internet liegen. Eine Adresse innerhalb eines privaten Netzwerks, eine IP-Adresse oder eine mit einem anderen Port als 443 wird abgelehnt, beim Speichern und erneut bei jedem Aufruf.
• Eigene Connectors gehören Ihnen: Sie werden nicht an die Mitglieder eines Team-Arbeitsbereichs verliehen, und ein Arbeitsbereich, der die Connectors auflistet, die seine Apps nutzen dürfen, lässt sie aus.
• Sie können bis zu 25 haben.
• Für einen einzelnen Schlüssel, den eine App braucht, genügen vielleicht Schlüssel und Secrets.