Using VMware Identity Manager Apps Portal

Transcription

1 Using VMware Identity Manager Apps Portal VMware Identity Manager 2.4 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see EN

2 Using VMware Identity Manager Apps Portal You can find the most up-to-date technical documentation on the VMware Web site at: The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: Copyright VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc.

3 Contents About Using the Apps Portal 5 1 Getting Started in Your Apps Portal 7 Browser Requirements 8 Sign In to Your Account 8 Sign Out of Your Account 8 Accessing ThinApp Packaged Windows Applications 8 Accessing View Desktops 9 Accessing Citrix Published Applications and Desktops from Your My Apps Page 9 2 Working in Your Apps Portal 11 Add Applications to Your Apps Portal 11 Remove Applications from Your Apps Page 12 Organizing Your Apps Page 12 3 Using VMware Identity Manager Desktop 15 Installing Identity Manager Desktop 16 Connecting to Your Apps Portal from Identity Manager Desktop 17 Logging out from Identity Manager Desktop 18 Disconnecting from the Identity Manager Server 18 Uninstalling Identity Manager Desktop 19 Migrating from Workspace for Windows to Identity Manager Desktop 19 Unlink Your Windows Computer from Your Apps Portal 19 Troubleshooting Identity Manager Desktop 19 Index 21 VMware, Inc. 3

4 Using VMware Identity Manager Apps Portal 4 VMware, Inc.

5 About Using the Apps Portal This guide describes how to use your apps portal to access your resources. From the portal, you can access your company's Apps Center to use resources that your organization has enabled for your use. Intended Audience This information is intended for users who have an account in their company's resource service center set up for them by their system administrator. VMware, Inc. 5

6 Using VMware Identity Manager Apps Portal 6 VMware, Inc.

7 Getting Started in Your Apps Portal 1 Your company has created a corporate workspace that makes it easy for you to access your organizations applications. You sign in to your user app portal to securely access applications that have been enabled for your use. You can access these applications without reentering your sign-in credentials. When you sign in, your user apps page displays the applications that you are entitled to. You can click on an app to open it. Apps that are Web applications open up in a browser window. Some apps require that a client application is installed on your computer before you can use it. If the client application is not installed, you are prompted to install it. To install the Identity Manager Desktop, see Chapter 3, Using VMware Identity Manager Desktop, on page 15. This chapter includes the following topics: Browser Requirements, on page 8 Sign In to Your Account, on page 8 Sign Out of Your Account, on page 8 Accessing ThinApp Packaged Windows Applications, on page 8 Accessing View Desktops, on page 9 Accessing Citrix Published Applications and Desktops from Your My Apps Page, on page 9 VMware, Inc. 7

8 Using VMware Identity Manager Apps Portal Browser Requirements For the best experience when working in your My Apps portal, make sure you have the latest version of your browser. Supported Browsers to Access the User's My Apps Portal End users can access the user apps portal from the following browsers. Mozilla Firefox (latest) Google Chrome (latest) Safari (latest) Internet Explorer 11 Microsoft Edge browser Native browser and Google Chrome on Android devices Safari on ios devices NOTE In Internet Explorer 11, JavaScript must be enabled and cookies allowed to authenticate through VMware Identity Manager. Sign In to Your Account You sign-in to your My Apps Portal to access apps that your company has entitled you to. You stay signed in until your session expires or you quit the application. Prerequisites Verify that you know your company's URL to access your apps portal. Typically, your administrator sends you a welcome with this information. 1 To sign to your account, open a browser window and enter the URL. 2 Enter your user name and your password. 3 Click Sign in. Sign Out of Your Account When you are finished working in your My Apps Portal pages in the browser, you should sign out to prevent other users from viewing your account. 1 Click the down arrow next to your name. 2 Click Sign Out and close the browser. Accessing ThinApp Packaged Windows Applications Windows applications enabled for your use that are packaged as ThinApp applications can be accessed only on computers running Windows with the VMware Identity Manager Desktop application installed. When you install Identity Manager Desktop and log in to your portal the first time, the application checks your entitlements and downloads the ThinApp packaged applications to which you have been given access. 8 VMware, Inc.

9 Chapter 1 Getting Started in Your Apps Portal To install the desktop application, see Installing Identity Manager Desktop, on page 16. When the Identity Manager Desktop is installed, desktop and Start menu shortcuts are added to your computer. The application icon is. Accessing View Desktops When a View desktop is enabled for your use, you can launch your View desktop directly from your apps portal. If the Horizon Client software is installed on your computer, you can open your View desktop directly or, if the Horizon Client is not installed, you can choose to open the View desktop in a Web browser. The Horizon Client offers more features and better performance than viewing your desktop in a Web browser. When you access your View desktop, you are not working in your apps portal account. Accessing Citrix Published Applications and Desktops from Your My Apps Page Citrix published resources that are enabled for your use can be launched from your apps portal. The user name and password you use to sign in to your portal is used to authenticate you on these apps. You must have Citrix Receiver installed to use Citrix published resources. Ask your system administrator for information about downloading the Citrix Receiver. VMware, Inc. 9

10 Using VMware Identity Manager Apps Portal 10 VMware, Inc.

11 Working in Your Apps Portal 2 You can access a catalog of resources that your organization has enabled for your use from your account. You can use your computer or mobile device to securely access company applications from a Web browser. You can add application to your apps page from the App Center and you can remove apps that you do not use from your apps page. You can mark apps that you frequently use as favorites for quick access on your computer or mobile devices. This chapter includes the following topics: Add Applications to Your Apps Portal, on page 11 Remove Applications from Your Apps Page, on page 12 Organizing Your Apps Page, on page 12 Add Applications to Your Apps Portal You can manage which applications appear in your apps page. Applications that are available to you are listed in the App Center. You can view all apps available to you in the App Center or you can view specific categories of apps. 1 On your apps page, click App Center. 2 If you want to see specific types of apps, select the category from the column on the left. 3 To see a description of the app before adding the app, hover the cursor over the app to click the information icon. 4 Click Add App to add the app to your apps page. VMware, Inc. 11

12 Using VMware Identity Manager Apps Portal What to do next If the app does not have licensing requirements, it is added to our account and is labeled as New. Apps that require the administrator to enable for your use are labeled as Pending. When you open some applications the first time, you might need to register the application to activate the license your organization reserved for you. After the applications are registered you can launch them from your apps page. NOTE If you reinstall an app that you previously removed on your computer or mobile device, clear your browser's cookies and cache before reinstalling the app. If you do not, when you launch the app, it might not open. Remove Applications from Your Apps Page Applications that you do not use can be removed from your apps page. 1 On your apps page, point to the application to remove. 2 Click the X in the right corner to remove the app. The application is removed from the page. When you remove an application, it is still available in the App Center and can be added back at any time. Organizing Your Apps Page You can organize your apps page so that the applications you frequently use can be easily found. You can mark an app as a favorite, display apps by specific categories that your admin set up, and change the display order of the apps on the page. You can right-click an app on your to mark the app as a favorite, move it to the top or bottom of the page, remove the app from the page, or launch the app. Display Apps by Categories on Your Apps Page Your company can organize apps by categories to make it easier to find similar apps or apps that work together. You can view apps by category from the App Center page and you can set up your apps page to display your apps by the categories that you select. 1 To find apps by category on your apps page, click Categories. 2 Select the categories to display in your page. If the category has apps associated with it, the apps display on your page. 12 VMware, Inc.

13 Chapter 2 Working in Your Apps Portal What to do next Organize your apps by either selecting apps to add to your favorite list, or by displaying your frequently used apps at the beginning of your apps list. See Organize Your Apps Page, on page 13. Mark Apps as Favorites To make locating your apps faster, you can mark your favorite apps so that they display in your favorites list. Your favorite apps display on any of your devices that can open the app. 1 On your apps page, right-click the app. 2 Click Make Favorite. A star displays on apps that are marked as favorites. 3 To see only favorite apps, click Favorites. Organize Your Apps Page When you are working in the apps page, you can drag and drop the icons to rearrange the order of the apps. u Select an application to move and drag and drop it to the new location on the page. To quickly move the app to the top or bottom of the page, right-click the app and select the Move to Top or Move to Bottom arrow. What to do next You can also mark apps that you use frequently as a favorite. See Mark Apps as Favorites, on page 13. Change Your View Access Preferences To start working in your View desktop from your apps page, you can select to open the Horizon Client on your computer or launch the View desktop in a browser. By default your View desktop is configured to open in the Horizon Client. If you do not have the Horizon Client installed, you can change the default to open View in a browser. 1 On your apps page, click the down arrow next to your name and select Preferences. 2 To always open View Desktops in a browser, select Browser. 3 Click Save. When you open your View Desktop from your apps page, the desktop is launched from a browser. Reset Your View Desktop When you launch your View desktop from your apps page and if your desktop stops responding, you reset the desktop from your apps portal. Your View administrator must have enabled this feature. If you do not have this feature, contact your View administrator to reset your desktop. 1 Sign in to your apps portal. VMware, Inc. 13

14 Using VMware Identity Manager Apps Portal 2 Right-click on the View desktop that is not responding and click Reset Desktop. Resetting the desktop shuts down your View desktop. All unsaved work is lost. When you are notified that the desktop has been reset you can launch it again. 14 VMware, Inc.

15 Using VMware Identity Manager 3 Desktop If your administrator has provided you any applications that are packaged as VMware ThinApp applications, you require the VMware Identity Manager Desktop application to access and use the ThinApp applications. Identity Manager Desktop is a Windows application that syncs the ThinApp packages to your Windows system, after verifying your entitlements. When you install Identity Manager Desktop and connect to the service for the first time, it checks your entitlements and downloads the ThinApp applications to which you have been given access. The download method is determined by install options that are typically set up by administrators. Download methods include file copy over the network and HTTP download. In some cases, your administrator might have set the option to stream ThinApp applications from a network share. After the ThinApp applications are installed, they appear in your Start > All Programs menu or on your desktop, depending on the application. Keep Identity Manager Desktop running and connected to the service so that any new or updated applications are synced to your system. The sync occurs at regular intervals. The default sync interval is 5 minutes but it might have been modified by your administrator. The Identity Manager Desktop menu, displayed by clicking the icon in the taskbar, displays the next scheduled sync time. If you disconnect from the service, applications are synced the next time you connect and sign in to your apps portal. When you start a ThinApp application, Identity Manager Desktop checks with the service whether you are entitled to it. You might not be able to start the application if the Identity Manager Desktop is not connected to the service. This chapter includes the following topics: Installing Identity Manager Desktop, on page 16 Connecting to Your Apps Portal from Identity Manager Desktop, on page 17 Logging out from Identity Manager Desktop, on page 18 Disconnecting from the Identity Manager Server, on page 18 Uninstalling Identity Manager Desktop, on page 19 Migrating from Workspace for Windows to Identity Manager Desktop, on page 19 Unlink Your Windows Computer from Your Apps Portal, on page 19 Troubleshooting Identity Manager Desktop, on page 19 VMware, Inc. 15

16 Using VMware Identity Manager Apps Portal Installing Identity Manager Desktop If your administrator has provided you access to ThinApp packaged applications, you must install Identity Manager Desktop on your Windows system to use these applications. Prerequisites Verify that you meet the following requirements before installing the application: Supported operating systems: Windows Vista, Windows 7, Windows 8, Windows 8.1, Windows 10, Windows Server 2008, Windows Server The installer for Identity Manager Desktop includes both 32 and 64-bit versions. The appropriate version is selected automatically. Disk space: 15 MB for the Identity Manager Desktop application and 2837 KB for the ThinApp Package support feature. If ThinApp packages are installed locally, additional space is required. Administrator privileges on the Windows system NOTE Before installing Identity Manager Desktop, close all open applications. 1 Download Identity Manager Desktop from My VMware. a b c d Using a browser, sign in to your Apps portal. On the top-right of the page, click the down arrow next to your login name and select Download. Click Download Desktop Client for Windows to download the Identity Manager Desktop. Save the file to your computer. 2 Double-click the executable file that you downloaded. 3 In the Setup wizard, click Next. 4 Accept the VMware End User License Agreement, and then click Next. 5 Select the features you want to install. All features, and the space requirements for each, are listed. Currently, only ThinApp Packaged Application support is available. 16 VMware, Inc.

17 Chapter 3 Using VMware Identity Manager Desktop a b To check whether you have enough disk space to install the application and the selected features, click Disk Usage. Click Browse and select the location for the installation. The default location is C:\Program Files\VMware\Identity Manager Desktop. 6 Click Next. 7 Click Install. 8 When the installation is complete, click Finish to exit the Setup wizard. The Identity Manger Desktop application starts and its icon ( ) appears in the task bar, unless you deselected the Launch Identity Manager Desktop option in the Setup wizard. The application is also added to the Start menu and you can start it by selecting Start > All Programs > VMware > Identity Manager Desktop. What to do next Sign in to your apps portal. Connecting to Your Apps Portal from Identity Manager Desktop After you install the Identity Manager Desktop application on your Windows system, sign in to your apps portal and access the ThinApp applications to which you are entitled. 1 If Identity Manager Desktop is not running, from the Windows Start menu, select All Programs > VMware > Identity Manager Desktop. The application's icon ( ) appears in the Windows task bar. 2 Click the icon and select Connect to server. 3 Enter the Identity Manager server URL and click OK. For example: VMware, Inc. 17

18 Using VMware Identity Manager Apps Portal 4 Click the icon again and select Log in. If Kerberos has been configured on your server, you will be logged in automatically. Otherwise, proceed with the following steps. 5 Select your domain and click Next. 6 Enter your user name and password, and click Sign in. 7 Click the icon and select Open my Identity Manager Portal to view and start the ThinApp applications to which you are entitled. NOTE The sign in process might be different if your service has been configured for alternate authentication methods. When you click a ThinApp application in the your apps portal, it is added to your system's Start menu and Program Files folder, or to your desktop, depending on the application. The application is either downloaded to your system or run from the network share, as configured by your administrator. Note that an application that appears in the user portal might not be available on your system until the next time the Identity Manager Desktop client syncs with the service. The Identity Manager Desktop syncs the applications to your Windows system at regular intervals. If your administrator entitles you to a new application, or provides an update, it appears on your system after the next sync. Logging out from Identity Manager Desktop You can log out without disconnecting from the service. When you are logged out, ThinApp packaged applications are not synced to your computer. Any updates are synced the next time you log in. Because Identity Manager Desktop syncs with the server at regular intervals, you might not see updates until the next sync. 1 In the taskbar, click the Identity Manager Desktop icon ( ). 2 Select Log out. Disconnecting from the Identity Manager Server You can disconnect the Identity Manager Desktop application from the server. 1 In the taskbar, click the Identity Manager Desktop icon ( ). 2 Select Unlink from server. 18 VMware, Inc.

19 Chapter 3 Using VMware Identity Manager Desktop Uninstalling Identity Manager Desktop You can uninstall Identity Manager Desktop from your Windows system using the standard Windows method for uninstalling programs. If a problem occurs, you can view the uninstall log file at %TEMP%\hws-desktop-client-uninstall.log. Prerequisites You have administrator privileges on your Windows system. 1 Click the Start button. 2 Select Control Panel > Programs and Features. 3 Select Identity Manager Desktop and click Uninstall at the top of the page. Migrating from Workspace for Windows to Identity Manager Desktop If you have the old Windows desktop client, Workspace for Windows, installed on your system, the Identity Manager Desktop installer migrates your data and settings from the old application to the new one by default. If you install VMware Identity Manager Desktop from the command-line, you can use the /v MIGRATE_ACTION=value option, where value is MOVE, COPY, or NONE, to specify the action for migrating the older application's data and settings. If you install using an install script provided by your administrator, this option might already be set. IMPORTANT Properties set for Identity Manager Desktop during installation take precedence over any migrated values for those properties. The following data and settings are migrated. Cached ThinApp Packages Downloaded ThinApp packages are copied from %LOCALAPPDATA%\VMware\Horizon ThinApp\PackageCache to the Identity Manager Desktop cache location, %LOCALAPPDATA%\VMware\Identity Manager Desktop\ Desktop\thinapp. Folder names within the cache folder are also altered. Unlink Your Windows Computer from Your Apps Portal You can unlink your Windows computer from your account. This action disables the device from accessing your account unless you, or another user, signs in again. 1 In your apps portal page, click the down arrow next to your name and select Devices. 2 In the Unlink this computer box, click OK. The device is immediately disabled from your account. You must re-enter your account information on your computer to re-link with your account. Troubleshooting Identity Manager Desktop To troubleshoot errors, you can view the log files for Identity Manager desktop and its installer. You can also collect a diagnostic bundle to send to your service administrator. VMware, Inc. 19

20 Using VMware Identity Manager Apps Portal View Identity Manager Desktop Log Files Log files capture certain information about how the Identity Manager Desktop application is running. Log files for the Identity Manager Desktop application and its components are saved in the %LOCALAPPDATA %\VMware\Identity Manager Desktop folder. The ten most recent log files are saved. Log files for the installer are saved in the %TEMP% folder. These log files are named vmmsi.log-timestamp and vminst.log-timestamp. By default, only errors are logged. For troubleshooting, it might be necessary to change the log level settings in the Windows registry. Your system administrator can help you modify the log file output. Collect Diagnostic Information for Identity Manager Desktop If you are having trouble using Identity Manager Desktop and are unable to resolve the problem yourself, you can collect diagnostic information to send to your system administrator. This information helps an administrator or support engineer diagnose and resolve problems. 1 In the task bar, click the Identity Manager Desktop icon ( Desktop. ) and select About Identity Manager 2 In the About Identity Manager Desktop dialog box, click Collect diagnostic information. System information and log files are collected and saved to a zip file. 3 Make a note of the location of the zip file and send the file to your system administrator. You can review the contents of the zip file before sending it. You can also review the privacy policy by clicking the icon, selecting About Identity Manager Desktop, and clicking Privacy Policy. 20 VMware, Inc.

21 Index A adding applications 11 apps by categories 12 apps portal 5, 7 arrange apps on my page 13 B browsers 8 C catalog 11 Citrix published apps 9 D diagnostic information bundle 20 F favorites 13 H Horizon Client 9 R remove applications 12 reset View 13 right-click to organize My Apps page 12 S secure access 11 sign in 8 sign out 8 T ThinApp 8, 17 U uninstall Identity Manager Desktop 19 unlink 19 V View, reset 13 View desktop 9 View preferences 13 I Identity Manager Desktop collect diagnostic information 20 connect to service 17 disconnect 18 install 16 log files 19, 20 migration 19 uninstall 19 Identity Manager desktop, log out 18 Internet Explorer 9 9 L log files 19, 20 log in 8 M mark apps as favorite 13 migrating Workspace for Windows to Identity Manager Desktop 19 O organize My Apps page 12, 13 VMware, Inc. 21

22 Using VMware Identity Manager Apps Portal 22 VMware, Inc.