You are browsing documentation for an older version. See the latest documentation here.
Managing Developers
Developer Status
A status represents the state of a developer and the access they have to the Dev Portal and APIs:
-
Approved
- A developer who can access the Dev Portal. Approved developers can create credentials & access all APIs that allow those credentials.
-
Requested
- A developer who has requested access but has not yet been Approved.
-
Rejected
- A developer who has had their request denied by a Kong admin.
-
Revoked
- A developer who once had access to the Dev Portal but has since had access Revoked.
Approving Developers
Developers who have requested access to a Dev Portal will appear under the Requested Access tab. From this tab, you can choose to Accept or Reject the developer from the actions in the table row. After selecting an action, the corresponding tab is updated.
View Approved Developers
To view all currently approved developers, click the Approved tab. From here, you can choose to Revoke or Delete a particular developer. Additionally, you can use this view to send an email to a developer with the Email Developer mailto
link. See Emailing Developers for more info.
View Revoked Developers
To view all currently revoked developers, click the Revoked tab. From here, you can choose to Re-approve or Delete a developer.
View Rejected Developers
To view all currently rejected developers, click the Rejected tab. Rejected developers completed the registration flow on your Dev Portal but were rejected from the Request Access tab. You may Approve or Delete a developer from this tab.
Email Developers
Invite Developers to Register
To invite a single or multiple developers:
- Click Invite Developers.
- Use the popup modal to enter email addresses separated by commas.
- After all emails have been added, click Invite. A pre-filled message opens in your default email client with a link to the registration page for your Dev Portal.
Each developer is bcc’d by default for privacy. You may choose to edit the message or send as is.
Developer Management Property Reference
portal_auto_approve
Default: off
Description: Dev Portal Auto Approve Access.
When set to on
, a developer will automatically be marked as approved
after
completing Dev Portal registration. Access can still be revoked through
Kong Manager or the API.
When set to off
, a Kong admin will have to manually approve the Developer
using Kong Manager or the API.
portal_invite_email
Default: on
Description: When enabled, Kong admins can invite developers to a Dev Portal by using the Invite button in Kong Manager.
portal_access_request_email
Default: on
Description:
When enabled, Kong admins specified by smtp_admin_emails
will receive an email
when a developer requests access to a Dev Portal.
When disabled, Kong admins will have to manually check the Kong Manager to view any requests.
portal_approved_email
Default: on
Description: When enabled, developers will receive an email when access to a Dev Portal has been approved.
When disabled, developers will receive no indication that they have been
approved. It is suggested to only disable this feature if portal_auto_approve
is enabled.
portal_reset_email
Default: on
Description: When enabled, developers will be able to use the Reset Password flow on a Dev Portal and will receive an email with password reset instructions.
When disabled, developers will not be able to reset their account passwords. Kong Admins will have to manually create new credentials for the Developer in the Kong Manager.
portal_token_exp
Default: 21600
Description:
Duration in seconds for the expiration of the Dev Portal reset password token.
Default is 21600
(six hours).
portal_reset_success_email
Default: on
Description: When enabled, developers will receive an email after successfully resetting their Dev Portal account password.
When disabled, developers will still be able to reset their account passwords, but will not receive a confirmation email.