NOTE: Some aspects of this product are in Beta. The hybrid installation options are GA. To join the Beta program, reach out to your Apigee representative.

Managing your portals

Create and manage your portals, as described in the following sections.

About the portal roles

You need one of the following roles to manage your portals. To assign roles to a user, see Change user roles in the UI.

Role Description
Portal Administrator Full CRUD permissions for integrated portals.

Note: The Portal Administrator role is not currently visible in the UI. In order to assign the role to a user, use the following gcloud command:

gcloud projects add-iam-policy-binding <project-id> --member=user:<user-email> --role=roles/apigee.portalAdmin
Organization Administrator Super user. Has full CRUD access to resources in the organization. This is a predefined role.
Read-only Organization Administrator Has read-only access to resources in the organization. This is a predefined role.

Exploring the Portals page

To access the Portals page, use one of the following methods:

  • Select Publish > Portals in the side navigation bar.
  • When editing a portal, click Portals in the top navigation bar.

The portals page opens and lists the current portals.

Portals page

As highlighted in the previous figure, the Portals page enables you to:

Creating a portal

Create multiple portals for your organization, as required.

When you create a new portal:

To create a new portal:

  1. Access the Portals page.
  2. Click + Portal.
  3. Enter the following information in the Create a Portal dialog:

    Field Description
    Name Name of portal. The name can contain only letters, numbers, spaces, and the following special characters: period (.), comma (,), dash (-), or underscore (_). Must be unique across all organizations.

    Note: If you delete a portal, you cannot immediately create a portal with the same name as the deleted portal will be stored temporarily in the Trash folder.
    Domain (Read only) As you enter the portal name, the default domain for the portal is displayed. For example: 'orgname-portalname.apigee.io', where 'orgname' is the organization name and 'portalname' is defined using the portal name converted to all lowercase and with spaces removed.

    Note: You can customize the domain name, as described in Customizing your domain.
    Description Description of your portal. This information is for internal use only. It will not be displayed on your live portal.
  4. Click Create.

Next steps:

Building your portal

To build your portal and its contents:

  1. Access the Portals page.
  2. Click the name of the portal you want to build. The portal landing page is displayed.
  3. Build the portal and its contents, as described in steps to build your portal.

Editing the portal name and description

To edit portal details, including name and description:

  1. Access the Portals page.
  2. Position your cursor over an existing portal to display the actions menu.
  3. Click Edit icon.
  4. Edit the portal name and description.
  5. Click Update.

Viewing the live portal

To view the live portal:

  1. Access the Portals page.
  2. Position your cursor over an existing portal to display the actions menu.
  3. Click .

The live portal opens in a new browser tab.

Deleting a portal

There are times when you may need to delete a portal. For example, if you have created a test portal to try out features in your local environment, you may wish to delete it after the testing phase is complete.

To delete a portal:

  1. Access the Portals page.
  2. Position your cursor over an existing portal to display the actions menu.
  3. Click Delete.
  4. To confirm the delete operation:
    a. Type DELETE in the text field.
    b. Click Delete.