7.2 Configuring Appmarks

Appmarks function like bookmarks in browsers. As with bookmarks, if the resource for the appmark changes, you must change the appmark to match the modified source. For example, you have an appmark for a protected resource and the protected resource changes, you must edit your appmark and select the modified protected resource again to receive the changes.

You can configure one or more appmarks for a resource. However, that appmark is specific to a single IDP cluster. You can also configure appmarks for users to use with only a browser. If you want users to use the mobile apps, you must first configure MobileAccess. For more information, see Configuring MobileAccess.

When you configure an appmark, you specify whether you want the application to launch in a desktop browser or on a supported mobile device, or both. If you configure a single appmark to display in both a desktop browser and on a mobile device, the appmark will have the same name, but you can customize the icons so they are different. Appmarks offer significant flexibility, enabling you to customize your users’ experience using different view options and variables.

When you configure a new appmark to display on a mobile device, the user must do a refresh on the application page on the mobile device before the appmark appears.

To create an appmark:

  1. In the Administration Console, click Appmarks.

  2. (Conditional) If you have not already configured an Access Manager resource, create a resource, such as a service provider or a protected resource.

  3. In the Cluster field, select the appropriate IDP cluster that hosts the protected resource.

    If you have only one IDP cluster, the Administration Console automatically selects that IDP cluster.

  4. Click the plus sign (+) to create an appmark.

  5. Create a new appmark using the information located in, Understanding Appmark Options.

  6. Click Save.

Repeat this process for each appmark you want to create. In order for the mobile appmark to work, you must configure MobileAccess. For more information, see Configuring MobileAccess.

7.2.1 Creating Multiple Appmarks for an Application

Application connectors can have multiple appmarks. For example, you might create several appmarks for different Office 365 or Salesforce applications. You can create a new appmark, or you can duplicate an existing appmark to save time, especially if you want to create several appmarks and just change one or two options on each one.

To duplicate a new appmark:

  1. In the Administration Console, click Appmarks.

  2. Click the menu on the upper left corner on the appmark you want to copy, then click Duplicate.

  3. Edit the Name field because it is pre-populated with COPY_$(DisplayName). You have the following options:

    • You can accept this default name. (However, note that “COPY_” will be part of the name.)

    • You can change the display name by manually editing the text.

  4. Specify whether the application must be accessible from a desktop browser or a mobile device, or both, and complete the appropriate fields. For more information about available options, see Understanding Appmark Options.

  5. Click Save.

7.2.2 Understanding Appmark Options

You configure appmarks in the Administration Console under Appmarks. On each appmark that you create, there is a menu on the upper left corner that allows you to edit, duplicate, or delete the appmark. Clicking Edit or clicking the appmark allows you to edit the appmark. Clicking the plus sign (+) at the top of the page, allows you to create a new appmark. When you create or duplicate an appmark, the following options are available.

Table 7-1 Appmark Options

Option

Description

Name

The display name for the appmark. If you want different display names for the appmark on the desktop browser page and on mobile devices, you must create a copy of the appmark and change the name.

Description

The description appears as hover text that users see for the appmark on the user portal page.The platforms are Desktop, iOS, and Android.

Change Image

The image that Access Manager uses for the appmark for all platforms, unless you override this image with a another image when configuring the different platforms. The maximum image size is 200 x 200 pixels and the ideal image size is 100 x 100 pixels. You can use an image from the Image Gallery or upload your own image.

Roles

(Optional) The Access Manager role that the users must have in order to see the appmark. If you do not select a role, all users can see the appmark on the user portal page. If you add a role, only users with that role can see the appmark. If you add multiple roles, users in any of those roles can see the appmark. For example, if you add Sales and Managers, the users must be in Sales or Managers, not Sales and Managers, to see the appmark.

Type

The Access Manager resource type that the appmark represents. There are many different types of resources:

  • Bookmark: The URL of a website or document.

  • Mobile App: The URL that launches the application at the mobile device. When the user opens the MobileAccess app on the mobile device and taps the appmark, MobileAccess opens the mobile app itself.

  • Service Provider: A trusted service provider such as Google or Salesforce that you configured before creating the appmark. If you have enabled the Allow any target in the Intersite Transfer Service for the service provider, you can specify a target override URL as well.

  • Protected Resource: A protected resource on a trusted Access Gateway cluster that you have created prior to creating the appmark.

    The protect resource roles control access to the appmark, not the appmark roles. The appmark roles only provide visibility of the appmark to the users.

Enable

Select the user platforms where the appmark will be visible. The platforms are Desktop, iOS, and Android.

Desktop

Allows you to override the behaviors of the desktop appmark. For example, you can add a different icon for the desktop appmark so it sizes differently than the iOS appmark. You can use an image from the Image Gallery or upload your own image.The options to override are:

  • Image

  • URL

iOS and Android.

The options are the same whether you select iOS or Android. You can add a unique image or URL for the iOS and Android appmarks so that these appmarks appear differently from the desktop appmarks.

The appmarks also have additional options not available for the user portal page.

  • Launch with: Specifies how to launch the application on the mobile device. Options include the following:

    • Chrome: When the user opens the MobileAccess app on the mobile device and taps the appmark, the MobileAccess app launches Chrome and directs it to the application. If Chrome is not installed on the mobile device, the user is taken to the App Store or Google Play to install it.

    • Internal viewer: When the user opens the MobileAccess app on the mobile device and taps the appmark, the MobileAccess app opens an embedded HTML viewer and directs it to the application. This view is similar to the Safari and Chrome options, except that the user does not have to leave the MobileAccess window. The application opens within the MobileAccess app window, and the user can tap the app name (as defined by the administrator when configuring MobileAccess) on the navigation bar in the top left corner of the screen to go back to the app home page and easily switch to another protected resource.

    • Safari (iOS only): When the user opens the MobileAccess app on a mobile device and taps the appmark, the MobileAccess app launches Safari and directs it to the application.

    • User Choice (Android only): When the user opens the MobileAccess app on a mobile device and taps the appmark, the MobileAccess app allows the user to choose what browser launches.

  • App Installer URL: (Optional) You can use this option if you selected the Mobile App type. This is the URL to install the application if it is not already installed on the mobile device.