Sicherheit und Grenzen
Der Proxy ist so konzipiert, dass ein Linked Service Ihre APIs integrieren kann, ohne sie preiszugeben:
- Nur serverseitig – Anfragen werden von den Servern von Seekdown gesendet, sodass Ihr Endpoint und
seine Anmeldeinformation der Seite oder dem Besucher nie offengelegt werden.
- Nur öffentliche Adressen – ein Linked Service kann nur öffentliche Hosts im Internet erreichen.
Anfragen an private, interne Netzwerk- oder Loopback-Adressen werden abgelehnt, sodass der Proxy nicht auf interne Infrastruktur gerichtet werden kann.
- Nur Assistenten – Linked Services laufen auf Assistenten, nicht auf Suchcentern.
- Erlaubte Methoden –
GET,POST,PUTundDELETE. - Zeitlimit für Anfragen – ein Aufruf, der nicht innerhalb von etwa einer Minute antwortet, wird abgebrochen.
- Dynamische Werte sind abgeschottet – ein Wert
{{params.x}}wird in der URL URL-kodiert und in Headern von
Steuerzeichen bereinigt, sodass er keine zusätzlichen Pfade, Query-Parameter oder Header einschleusen kann. Platzhalter sind nur im Pfad, in der Query oder in einem Header-Wert erlaubt – nie im Host –, sodass ein Wert die Anfrage nie umleiten kann. Wird ein referenzierter Parameter nicht geliefert, schlägt der Aufruf fehl, statt eine unvollständige Anfrage zu senden.
Fehlerbehebung
- Der Aufruf schlägt sofort fehl – prüfen Sie, ob die URL eine öffentliche
https://-Adresse ist; interne oder
private Hosts sind absichtlich blockiert.
- Der Endpoint meldet „unauthorized“ – prüfen Sie, ob der Header name dem entspricht, was Ihre API
erwartet, und ob das gespeicherte Geheimnis aktuell ist. Verwenden Sie im Zweifel Remove stored secret und legen Sie es neu fest.
- Beim Absenden passiert nichts – stellen Sie sicher, dass die Aktion oder das Formular
executeProxyRequest (oder sendProxyForm) mit der exakten Service ID aufruft.