Get started with a web application

Web applications are used by an enterprise and reside in the app server within the data center.
To secure access with Enterprise Application Access (EAA) attach an access and identity connector to the web application server inside the data center. The connector does a dialout to the Enterprise Application Access Cloud on port 443. The users connect to the Enterprise Application Access Login Portal URL in their web browsers. They provide their credentials once to gain access to all of the applications.

Get started with a web appGet started with a web app

Set up a web application and learn how to:

  • Create and install a connector in Amazon AWS environment.

  • Add users to the Enterprise Application Access Cloud directory, create an ‚ÄčAkamai‚Äč identity provider (IdP).

  • Associate the directory and deploy the IdP.

  • Configure a web application (HTTPS application) with time-based access control rules (ACL) for restricted access to certain users at specific times.

  • Add authentication with the identity provider (IdP) for the web application.

  • Verify if the user can access the web application using the external hostname.

Start with a simple configuration:

  • Use the cloud directory in Enterprise Application Access (do not use any other Active Directory or LDAP).

  • Use the ‚ÄčAkamai‚Äč cloud domain (do not use any custom external domain). You do not have to configure and upload certificates.

Also, we skip for now application services like URL rewrite rules for optimized content delivery, URL path-based policies, and use of Internet Content Adaptation Protocol (ICAP) for offload-processing of internet-based content by dedicated servers.

The authentication mechanism for the web application server is set to none (default). Additional configuration is needed if you want to use any of the advanced application-facing authentication mechanisms like SAML 2.0, WS Federation, and OpenID Connect 1.0.

Create, download and install an Access Identity Connector

Create and deploy a connector for Amazon AWS environment for any access application.

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Clients & Connectors > Access and Identity Connectors.

  3. Click Add New Connector (+).

  4. Enter a connector name and an optional description.

  5. Select a connector package type. The package type corresponds to the virtual environment where you are installing the connector. For example, if you install the connector on the Amazon AWS environment, select package type Amazon AWS EC2/VPC.

  6. Enable Debugging.

  7. Click Save Connector (‚úď).
    The status of the connector changes to Created (Download CloudFormation Template).

  8. Click the connector status.
    The connector file opens in a separate browser window.

  9. Download and save the connector file.
    The connector file is used later to set up the connector in the virtual environment.

  10. Log in to your AWS console and select AWS services menu > AWS CloudFormation > CREATE STACK.

    1. Under Create Template, select Upload a template to Amazon S3.

    2. Click Choose File and select the downloaded CloudFormation template file.

    3. Enter a stack name, NAT instance type, VPC ID, and subnet information and click Next.

    ūüďė

    For the NAT instance type recommended minimum is of m4.large.

    1. Complete the configuration of tags, storage, and other features as needed. Since AWS does not use swap space for storage, you need a minimum of 12 GB of RAM memory.
  11. Click CREATE.
    Once the stack creation is complete, the connector instance starts and automatically connects to the EAA Cloud.

Next, return to the Enterprise Center.

  1. In the Enterprise Center navigation menu, select Application Access > Clients & Connectors > Access and Identity Connectors.

  2. Search for your connector and click Approve next to it.

  3. Verify that the connector shows the private and public IP addresses assigned to it.
    The connector reaches out to the EAA Cloud after installation.
    The status changes to Ready. Connector is running.
    The connector can do dialouts from the datacenter to the EAA Cloud, connecting the application inside the datacenter to the Internet through the EAA Cloud and the user.

Next, add users to the cloud directory.

Add users to the cloud directory

You need to add users who can access the web application to the cloud directory.

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Identity & Users > Directories.

  3. Select Cloud Directory.

  4. In Users click Add New User (+).

  5. Enter email, first name, and last name.

  6. Click Send Invite. New users receive an email to create a password and complete their account authorization.

  7. Click Save User Changes (‚úď).
    New users are now added to the Enterprise Application Access NAME>> default directory, EAA Cloud directory.

Next, create an ‚ÄčAkamai‚Äč Identity provider (IdP).

Create an ‚ÄčAkamai‚Äč Identity provider (IdP), associate the cloud directory, and deploy the IdP

Identity providers (IdPs) manage user identity information and provide single sign-on (SSO) and multi-factor authentication (MFA).

Associate IdP to the previously created directory to allow users to authenticate to your web application.

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Identity & Users > Identity Providers.

  3. Click Add Identity provider (+).

  4. Enter a name, description, and select the provider type as ‚ÄčAkamai‚Äč, for example, IDP2.

  5. Click Continue.

  6. In Settings > General > Identity server enter a URL. Leave all other settings as defaults.

  7. Click Save.

  8. In Directories click Associate (+).
    Associate directoryAssociate directory

  9. Select the Cloud Directory and click Associate.
    The cloud directory appears under Directories.

  10. Leave the default settings in the Login portal and click Save.
    Hover over the Status of the identity provider, if there are no errors, Ready for deployment appears.
    Ready for deploymentReady for deployment

  11. Click Deploy IDP.
    Pending Changes appears. All the pending deployment changes are shown. Make sure that IDP2 is selected. If you select any other IdPs, they are simultaneously deployed.
    You can click modified, to check the changes done with the previous version.
    Pending changesPending changes

  12. Click Deploy and add a Deploy Confirmation message in the dialog box and click Deploy.
    The deployment may take several minutes to complete. When it's ready, the completed deployment flow and IdP is Deployed appear.
    IdP is deployedIdP is deployed

The cloud directory is now associated with the new identity provider. Users from to the directory can access applications associated with the identity provider.

Next, configure your web application.

Configure a web application

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Applications > Applications.

  3. Click Add Application (+).

  4. Enter the application name and description, and select New Access App in Type.

  5. Click Add Application.
    Your application opens.

  6. In App Settings for Akamai Cloud Zone select a cloud zone located closest to the datacenter where your application resides.
    App settingsApp settings

  7. In External Host enter the external host name for the application where the users can access the application. You can use your own domain or enter a ‚ÄčAkamai‚Äč domain:

    • If you select Use Akamai domain, enter a URL, for example, https://sample-web-app.go.akamai-access.com.
      If you use the ‚ÄčAkamai‚Äč domain, you don't need to configure a certificate.

    • If you select Use your domain, enter your own domain.

    ūüďė

    If you use your own domain, you need to add a certificate and associate the certificate for your own domain and set up a CNAME redirect for the application.

  8. To add connectors to the application go to Connectors.

    ūüďė

    The connector should run to deploy the application.

  9. Click Associate connector and select one or more connectors. Click Associate.
    To remove a connector click Disassociate next to it.
    The associated connector appears under the Connectors.

    ūüĎć

    More than one connector is recommended for high availability and load balancing.
    ConnectorsConnectors

  10. In the Server Settings, configure the following:

  • Verify Origin Server Certificate (off-by-default). Allows you to do the origin server certificate validation (recommended). Also, select a root CA certificate.

  • ROOT CA Certificate. Choose the root CA certificate with the full bundle you uploaded into Enterprise Center after uploading a certificate in Certificates > Certificates.

  • Application Server IP/FQDN. In Protocol select https (default) for secure web traffic or http for http traffic. In Host: Port enter a valid internal IP address for the server or the fully qualified domain name (FQDN) that you use to access this web server when inside your company's network. Also, enter an IP port number.
    Server settingsServer settings

    ūüďė

    If no port is specified, port 443 is the default port. Check the preview to make sure it's okay.

To configure multiple applications servers for load balancing, click Add New Server (+). Enterprise Application Access supports various load balancing techniques including round-robin, session or cookie stickiness, and source IP hash in Advanced.

  1. In Access enable Access.

    1. To create a new rule, click Add Rule (+).
      To edit an existing rule, click Edit Rule.
      A modal window appears.

    2. In Rule Name enter a name for the rule and click Add.

    3. In Type select Time.

    4. In Operator select either is or is not.

    5. In Value enter the value if applicable, or select the value for the access control type.

  2. Click Time to configure the time-based settings:

    1. In Start Time and End Time enter a time in hh:mm, AM-PM format.

    2. Select time zone.

    3. Select the days of the week for when you want to deny access.

  3. Click Save Rule.
    Save ruleSave rule

  4. You can optionally configure the following settings for your web application:

    • Services. Add any services like compression, URL rewrite rules, ICAP, and URL path-based policies.

    • Advanced. You can configure more advanced settings.

    • If Application-facing authentication mechanism is SAML 2.0., also configure SAML Settings.

    • If Application-facing authentication mechanism is WS-Federation, also configure WS-Federation Settings.

    • If Application-facing authentication mechanism is Open ID Connect 1.0., also configure OpenID.

Next, configure the authentication source and deploy your web application.

Configure the authentication source, and deploy the application

Assign the previously deployed identity provider (IdP) and directory to the web application and deploy your application.

  1. Log in to Enterprise Center.

  2. In the Enterprise Center navigation menu, select Application Access > Applications > Applications.

  3. Select your application to open it.

  4. In the Authentication add the authentication for your application:

    1. Enable Authentication.

    2. Select Identity provider from the list.

    3. Click Assign Directory and select one or more directories from the list.

    4. Click Associate.
      The directory appears under the Assigned Directories.
      AuthenticationAuthentication

  5. Leave History in the Application with the default configuration and click Safe.
    Hover over the Deployment symbol, if all configurations are correct, Ready for Deployment appears.
    Ready for deploymentReady for deployment

  6. To deploy the application click Deploy Application.
    Pending Changes appears. All the pending deployment changes are shown. Make sure you selected your application. If you select any others, they are simultaneously deployed.

  7. Click Deploy and add a Deploy Confirmation message in the dialog box and click Deploy.
    The deployment may take several minutes to complete. When it's ready, the completed deployment flow and App Deployed appears. App deployedApp deployed

Next, verify if you can access the application.

Verify you can access the web application from the EAA Login Portal

  1. Open a new tab and enter the external host name URL you created for the web application in the previous steps.
    For example, https://sample-web-app.go.akamai-access.com.

  2. Log in with your username and password you created and added to the cloud directory.
    You should be able to securely access the web application within the non-restricted access time.