Schlüssel und Secrets

Schlüssel

Die Karte Keys listet die Dienste auf, die mit Ihrem Konto verbunden sind und die Ihre Apps nutzen können, etwa Stripe, OpenAI oder Shopify, mit einer Anzahl. Sie zeigt jede aktivierte Verbindung des Kontos, nicht nur die dieser App. Ein Klick darauf öffnet Connectors. Dort fügen Sie sie einmal hinzu und legen fest, welche Apps welche Verbindung nutzen.

Secrets

Schlüssel für Dienste, die die App aufruft und für die es keinen Connector gibt: ein Wetterdienst, SMS, die eigene API eines Kunden. Sie finden die Seite im Menü unter Cloud, und es braucht eine Person, die die App ändern darf. Klicken Sie auf Add secret, geben Sie einen Namen und die Adresse des Dienstes ein und fügen Sie den Schlüssel ein.

• Der Schlüssel wird nur an diese Adresse gesendet, nie anderswohin, und steht nie im Code der App.
• Er wird verschlüsselt gespeichert. Nach dem Speichern kann er ersetzt oder gelöscht, aber nicht gelesen werden.
• Eine Änderung gilt sofort, in der Vorschau und in der veröffentlichten App, ohne erneut zu veröffentlichen.

Fragen Sie ihn dann im Chat mit seinem Namen an: „Zeige das Wetter in Paris mit WEATHER_KEY“. Die App schreibt den Namen an die Stelle, an die der Schlüssel gehört, und Setherion setzt den Schlüssel beim Absenden ein. Jede Anfrage mit einem Secret verbraucht einen Integrations-Credit. Apps auf Ihrem eigenen Supabase können noch keine Secrets nutzen.

Regeln für ein Secret

• Der Name besteht aus Großbuchstaben, Ziffern und Unterstrichen, beginnt mit einem Buchstaben und hat 2 bis 64 Zeichen, zum Beispiel WEATHER_KEY. Ein Name, der einen Schlüssel enthält, wird abgelehnt, ebenso ein Name, der schon vergeben ist: Ersetzen Sie das alte Secret über sein Menü.
• Der Wert darf bis zu 4.096 Zeichen lang sein, und eine App kann 50 Secrets enthalten.
• Die Adresse des Dienstes muss eine öffentliche https-Adresse sein. IP-Adressen, localhost, Ports und private Namen werden abgelehnt. Wenn Sie einen ganzen Link einfügen, wird nur dessen Host behalten.
• Eine Anfrage wird nur gesendet, wenn ihre Adresse die ist, die mit dem Secret gespeichert wurde. Andernfalls wird sie mit der Meldung abgelehnt, dass das Secret nur an diesen Host gesendet werden kann.
• Der Schlüssel wird aus der Antwort entfernt, bevor die App sie sieht.
• Eine Anfrage wartet bis zu 30 Sekunden, wird nicht weitergeleitet, und die Antwort darf bis zu 5 MB groß sein.
• Ein Besucher kann bis zu 600 solcher Anfragen pro Stunde stellen. Sie stoppen, solange das Backend pausiert ist oder das Monatskontingent aufgebraucht ist.
• Die Tabelle zeigt für jedes Secret den Namen, die Adresse, an die es gesendet wird, und wann es aktualisiert wurde, mit Replace und Delete in jeder Zeile.