Verbindung zur Remote-Site scheitert

Die Plugins der Suite bringen den Bereich „Remote-Sites“ mit: dort verbindest du weitere WordPress-Installationen per Application-Passwort und bedienst sie von hier aus. Verbinden, Testen und Entfernen laufen in allen Plugins über denselben geteilten Code, die Meldungen sind deshalb überall wortgleich. Dieser Artikel ordnet sie zu.

Die Meldungen im Einzelnen

• „Bitte URL (http/https), Benutzer und Application-Passwort angeben.“ — ein Feld ist leer oder die Adresse beginnt nicht mit http:// oder https://
• „Site nicht erreichbar.“ — es kam überhaupt keine Antwort zurück; beim Anlegen steht „Verbindung fehlgeschlagen:“ davor, beim späteren Prüfen „Test fehlgeschlagen:“
• „Zugangsdaten abgelehnt (Application-Passwort prüfen).“ — die Zielseite hat mit 401 oder 403 geantwortet
• „Keine gültige REST-Antwort (Code …).“ — es kam eine Antwort, aber kein auswertbares JSON; der genannte Code steht dabei
• „Site nicht gefunden.“ — der angeklickte Eintrag steht nicht mehr in der Liste dieser Installation

Verbindung anlegen und nachprüfen

1. Öffne die Seite des jeweiligen Plugins im WordPress-Menü und wechsle links in der Gruppe „Netzwerk“ auf „Remote-Sites“.
2. Fülle in der Karte „Site verbinden“ die Felder „Site-URL“, „Benutzername“ und „Application-Passwort“ aus.
3. Klicke auf „Verbinden & testen“.
4. Prüfe eine bestehende Verbindung später jederzeit über die Schaltfläche „Testen“ in der Tabelle „Verbundene Sites“.
5. Lies in der Spalte „Status“ ab, ob die Site als „verbunden“, „fehler“ oder „ungeprüft“ geführt wird.

Der Test ist ein angemeldeter Aufruf der WordPress-eigenen Benutzerroute auf der Zielseite. Er hat 20 Sekunden Zeit und folgt keinen Weiterleitungen. Versucht werden zwei Adressformen: zuerst die Form mit rest_route, die auf jeder Permalink-Einstellung funktioniert, danach der Weg über /wp-json/. Als Erfolg zählt nur eine echte JSON-Antwort. Anschließend liest der Test den Namen der Site über die Wurzel-Route nach; gelingt das nicht, steht der Hostname in der Liste.

Grüner Test, trotzdem scheitert die Aktion

• Die Aktionen neben jeder Site rufen eigene Routen der Zielseite auf: „Fernstatus“ und „Fern-Backup“ im Backup-Plugin, „Status“ und „Cache leeren“ in Performance, „Config senden“ in Consent, „Sicherheits-Status“ in Security, „SEO-Status“ in SEO und „Statistik abrufen“ in Analytics
• Diese Routen verlangen auf der Zielseite das Recht manage_options — das Application-Passwort muss also zu einem Konto mit Administratorrechten gehören
• Das jeweilige Plugin muss auf der Zielseite installiert und aktiv sein; sonst lautet die Antwort „… nicht abrufbar (Plugin auf Zielseite aktiv? Code …)“
• Dass „Testen“ grün meldet, sagt nur, dass Adresse und Zugangsdaten stimmen — über das Plugin auf der Gegenseite sagt es nichts
• Im Analytics-Plugin erscheint der Bereich „Remote-Sites“ nur für Administratoren