Developer Portal Communication Issues

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation.
info

Symptom

You might encounter one or more of the following issues caused by communication issues between the Developer Portal and Edge:

  1. Unable to perform the following tasks:
  2. Create or update SmartDocs.
  3. Register developer apps.
  4. List API products.
  5. Error returned when accessing SmartDocs models page on Developer Portal (select Content > SmartDocs in the Developer Portal administration menu).


  6. Developer app analytics not being generated.

Error Messages

  1. Error returned when accessing the “SmartDocs” tab in the developer portal:

    The website encountered an unexpected error. Please try again later.
    
  2. Error returned when registering a developer app in the developer portal:

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

Possible Causes

In most cases, the problem is due to incorrect devadmin credentials specified or insufficient permissions assigned to the devadmin user role.

Validate the Edge connection configuration for the dev portal by navigating to Configuration > Dev Portal and ensuring the Connection Status field displays Connection Successful. Otherwise, the dev portal is not able to properly connect to the Edge Management server.

Diagnosis

  1. Enable "DEBUG" logging on the dev portal by navigating to Configuration > Dev Portal and selecting Debug under Edge logging threshold. By default, Management API calls are not logged.
  1. Reproduce the problem.
  1. Access the log by navigating to Reports -> Recent Log Messages.

  1. Open the “Message” of type “LogPlugin” to learn more about the actual error.

Sample output showing 401 Unauthorized Error

Resolution

Follow the appropriate steps listed in the below table depending on the error encountered:

Error

Steps to Resolve

401 Unauthorized

Update the correct devadmin credentials on Developer Portal and test connectivity again. See Add and manage user accounts.

403 Forbidden

Update the devadmin userrole on Edge organization to have the required permissions for the resource. See Setting user roles and permissions.