Kommunikationsprobleme beim Entwicklerportal

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Symptom

Bei Kommunikationsproblemen zwischen dem Entwicklerportal und Edge können eines oder mehrere der folgenden Probleme auftreten:

  1. Folgende Aufgaben können nicht ausgeführt werden:
  2. SmartDocs erstellen oder aktualisieren
  3. Registrieren Sie Entwickleranwendungen
  4. API-Produkte auflisten.
  5. Fehler, der beim Zugriff auf die SmartDocs-Modellseite im Entwicklerportal zurückgegeben wird (wählen Sie im Verwaltungsmenü des Entwicklerportals Content > SmartDocs aus).


  6. App-Analysen für Entwickler werden nicht generiert.

Fehlermeldungen

  1. Fehler, der beim Zugriff auf den Tab „SmartDocs“ im Entwicklerportal zurückgegeben wird:

    The website encountered an unexpected error. Please try again later.
    
  2. Beim Registrieren einer Entwickler-App im Entwicklerportal zurückgegebener Fehler:

    There was an error trying to create the App. Please try again later.
    

Mögliche Ursachen

In den meisten Fällen ist das Problem auf falsche devadmin-Anmeldedaten oder unzureichende Berechtigungen zurückzuführen, die der Nutzerrolle „devadmin“ zugewiesen sind.

Prüfen Sie die Edge-Verbindungskonfiguration für das Entwicklungsportal. Gehen Sie dazu zu Konfiguration > Entwicklerportal und achten Sie darauf, dass im Feld „Verbindungsstatus“ „Verbindung erfolgreich“ angezeigt wird. Andernfalls kann das Entwicklungsportal keine ordnungsgemäße Verbindung zum Edge Management-Server herstellen.

Diagnose

  1. Aktivieren Sie das Logging DEBUG im Entwicklungsportal. Gehen Sie dazu zu Configuration > Dev Portal und wählen Sie unter „Edge-Logging-Schwellenwert“ die Option „Debug“ aus. Standardmäßig werden Management API-Aufrufe nicht protokolliert.
  1. Reproduzieren Sie das Problem.
  1. Greifen Sie auf das Log zu, indem Sie zu Berichte -> Letzte Log-Nachrichten gehen.

  1. Öffnen Sie die „Nachricht“ vom Typ „LogPlugin“, um mehr über den eigentlichen Fehler zu erfahren.

Beispielausgabe mit dem Fehler 401 Nicht autorisiert

Auflösung

Führen Sie je nach aufgetretenem Fehler die entsprechenden Schritte in der folgenden Tabelle aus:

Fehler

Schritte zur Problemlösung

401 Nicht autorisiert

Aktualisieren Sie die korrekten devadmin-Anmeldedaten im Entwicklerportal und testen Sie die Verbindung noch einmal. Weitere Informationen finden Sie unter Nutzerkonten hinzufügen und verwalten.

403 Unzulässig

Aktualisieren Sie die Nutzerrolle „devadmin“ in der Edge-Organisation, um die erforderlichen Berechtigungen für die Ressource zu haben. Weitere Informationen finden Sie unter Nutzerrollen und Berechtigungen festlegen.