icon-zpa.svg
Secure Private Access (ZPA)

Configuring User Portals

After you configure a user portal, ZPA generates a canonical name (CNAME) that must be published in your public DNS. When a user's web browser resolves to the user portal URL, they need to be authenticated against their identity provider (IdP). After authentication, ZPA displays the user portal along with all associated application links. The user can only view links to applications they are allowed to access. To learn more, see About User Portal Links.

For an end user to access a user portal, at least one SAML attribute needs to be configured for your IdP in ZPA. To learn more, see About SAML Attributes and Configuring an IdP for Single Sign-On.

The Authentication Timeout for a user portal session is based on the default timeout policy rule. If you edit the rule, the change does not immediately impact any currently authenticated user portal sessions. When an end user's session expires, the user portal might become unresponsive. If this occurs, they need to reauthenticate into the portal to continue accessing applications.

To add a user portal:

  1. Go to Resource Management > User Portals > User Portals.
  2. Click Add User Portal.

The Add User Portal window that appears

  1. In the Add User Portal window:

    • Name: Enter a name for the portal. The name cannot contain special characters, with the exception of periods (.), hyphens (-), and underscores ( _ ).
    • Status: Enable the portal. If disabled, the portal is inaccessible to users.
    • Certificate Type: Select either Managed or Custom.
      • If you select Managed, the portal certificate is managed by Zscaler.
        1. Enter the domain prefix.
        2. Select the domain suffix from the drop-down menu.
        3. Click the Copy icon to copy the URL.

        Close
      • If you select Custom, then you select an existing certificate.
        1. Enter the full URL for the portal. This is the URL that the users access to view the portal. The URL must use the HTTPS protocol and be a fully qualified domain name (FQDN).

        A user portal's FQDN cannot be configured as an application within an application segment.

        1. Select a certificate from the Portal Server Certificate drop-down menu that is associated with the portal. Click Clear Selection to deselect the certificate. To learn more, see About Browser Access (Web Server) Certificates.

        The certificate must support the FQDN specified for the portal.

        Close
      • Description: (Optional) Enter a description for the portal.
      • If you want to display a notification to your users at the top of the portal page, under Notification Banner:
        • Status: Enable the notification banner.
        • Message Text: Enter the notification text that you want displayed in the portal's banner.

  2. Click Save.

For user portals with a custom certificate, complete the following steps:

  1. On the User Portals page, expand the row to view the portal details within the table, then click the Copy icon next to the Canonical Name (CNAME). You need this CNAME record for your public DNS.
  2. Add the CNAME information you copied to your public DNS, and verify that the FQDN for the user portal resolves to the record.

Zscaler automatically manages the public DNS for the FQDN of user portals with a Zscaler-managed certificate.

Related Articles
About User PortalsConfiguring User PortalsEditing User PortalsAbout User Portal LinksConfiguring User Portal LinksEditing User Portal LinksViewing and Managing Zscaler Client Connector Download LinksAccessing a User Portal