Create a Portal Entry - Pro Edition
Managing your portal is a key part of Tyk Dashboard, this section aims to provide some tutorials to help you get started working with your portal and publishing your APIs to the public.
Publish to your Developer Portal
Step 1: Create your first API
If you haven’t already, create an API in your Dashboard, your Portal will not be visible or live until you have at least one live API being managed by Tyk. This tutorial assumes you’ve created your first API using the Dashboard and called it “Test API”.
Step 2: Initialise all your portal settings
By default there is no Portal configured, you need to configure from the Portal settings screen, even if you don’t want to change the options. Select Portal Management > Settings. The notification view on the right will say that no configuration was detected so it was created. Your Portal won’t work without this step, so it’s important.
That’s it, now you need to create the home page.
Step 3: Create the home page
From Pages” click Add Page and give it any title you like (e.g. “Welcome”) and select Default Home Page Template from the Page Type drop-down list. Ensure Check to make this page the home page is selected.
Save the page.
Step 4: Create a Policy
When you publish an API to the Portal, Tyk actually publishes a way for developers to enrol in a policy, not the API directly.
Why?: A Tyk policy can grant access to multiple APIs (so long as they all use the same access control mechanism) and set a template for any keys that are generated for the portal for things such as Tags, Rate Limits and Quotas. Another useful feature with a policy and the Portal is that when the key is generated for a developer, it can be made to expire after a certain time - e.g. a trial key.
To create a policy for your test API, select New Policy from the Policies menu. You can leave all the defaults as is, except:
- Name the policy Default
- Select Test API API in the Access Rights > Add access rule drop-down list and click Add so it appears in the list
- Select Activate Policy
Save the policy by clicking Create.
Step 5: Publish the API to the Portal
The API that you defined earlier is active and will work as you’ve seen in the previous tutorial, this time we want to use the Portal to generate a token for a named developer.
Not all APIs are visible to the Portal, only the ones you tell it about, so from the Catalogue menu, select Add API then:
- Select your Default policy
- Fill in the description fields
- Ensure the Enable this API is selected
Save the API Catalogue entry by clicking Update.
Step 6: Set your Portal hostname
When you set up your Tyk installation, you will have had to, at some point, define a hostname for your portal, either as a
/etc/hosts file entry, or as a qualified hostname such as
portal.domain.com. To make the Dashboard aware of this, from the Your Developer portal > Set Your Portal Domain enter the hostname and wait for Tyk to refresh.
This process will bind your organisations’ Portal to the domain name you’ve specified.
Note: If you installed Tyk On-Premises for Vagrant, you will have created a
portal-instance.com. You should enter this hostname in the drop-down.
NOTE: You need to restart your Dashboard service for the changes to take effect.
Step 7: Log into your Portal
Select Open Your Portal from the Your Developer Portal menu drop-down, a new page will open with your new (most likely empty) Portal home page.
A note for Docker users: If you are using Docker, do not use the drop-down, instead, use the domain name you defined when you set up the forward proxy for your domains - if you followed the Docker setup guide, your Dashboard will be on: