Create a portal entry - Cloud
Tutorial: Create a portal entry
You can use the dashboard to create a portal that allows developers to access the APIs you create.
Prerequisites for a portal catalogue entry:
- An API configured and live on your gateway
- The API must be Closed (i.e. it must use either Auth Token or Basic Auth security mechanisms)
- A security policy configured to grant access to the API
Step 1: Select "Catalogue" from the "Portal Management" section
Step 2: Click Add new API
This page displays all of the catalogue entries you have defined, whether they have documentation attached and whether they are active on the portal or not. Click Add new API.
Step 3: Set a Public API Name and associate a security policy
When publishing an API with Tyk, you are not publishing a single API, but instead you are publishing access to a group of APIs. The reason for this is to ensure that it is possible to compose and bundle APIs that are managed into APIs that are published. Tyk treats these as separate, so the thing that is published on the portal is not the same as the actual API being managed by Tyk, one is a logical managed API and the other (the published catalogue version) is a facade.
Since API policies allow the bundling of access control lists of multiple APIs, it is actually this that you are granting access to. Any developer that signs up for this API, will be granted a bearer token that has this policy as a baseline template, or as a "plan".
- You will only see security policies for valid APIs in the drop-down list for the policies
- The policy must be "closed" (see Prerequisites)
Step 4: Add a description
All catalogue entries can have a description. You can use Markdown formatting in these fields:
Step 5: Show the API
An API will not be published until you select Show API:
Step 6: Add Documentation
You can add import documentation in the following formats:
- From a Swagger file
- From a Swagger URL
- From API Blueprint
From v1.4, you can add your documentation before or after saving your API.
Step 6: Save the API
To save the API, click Update.
Step 7: Take a look
You can now visit your portal to see the API catalogue entry. Select Open Your Portal: