Setup overview

You set up and use Gloo Platform Portal in two broad ways, as a backend and frontend.

Review the following diagram to understand how you set up both aspects of Gloo Portal.

Portal setup overview

  1. As the Gloo Platform administrator, you install the required components to run Portal. For more information, see Administer Portal.
  2. As the app owner, you deploy OpenAPI apps across clusters or even workspaces. Then, you bundle the apps together by creating a route table for all the apps that you want to expose through the developer portal. You might think of this route table of apps as your API product. Create a route table for each version of your app, with its own lifecycle management, terms of service, and other metadata. Then, you can group separate route table versions together into a single API product to display in the developer portal to your end users. For more information, see Create your API products.
  3. As the portal admin, you make sure that the virtual gateway is set up with the host that your portal listens on, which matches the host in the route table. Then, you can create a usage plan to control access to your API product by combining two types of policies: rate limiting and external auth. Finally, you include all these details in the Portal custom resource. For more information, see the following guides:
  4. As the frontend developer, you can apply your company's branding to the developer portal. This setup also includes the way that end users interact with your API, such as generating API keys for accessing or the API docs for using your API product. For more information, see Build a developer portal frontend.
  5. Your end users interact with your APIs through the developer portal. For more information, see Interact with the developer portal.