SafeNet MobilePASS Software Administration Guide
SafeNet MobilePASS Software Administration Guide
©2010 SafeNet, Inc. All rights reserved. SafeNet and SafeNet logo are registered trademarks of
SafeNet. All other product names are trademarks of their respective owners.
Software Version: All Versions
Documentation Version: 20120910
© 2012 SafeNet, Inc. All rights reserved
Preface
All intellectual property is protected by copyright. All trademarks and product names used or referred to are the copyright of
their respective owners. No part of this document may be reproduced, stored in a retrieval system or transmitted in any form or
by any means, electronic, mechanical, chemical, photocopy, recording or otherwise without the prior written permission of
SafeNet.
SafeNet makes no representations or warranties with respect to the contents of this document and specifically disclaims any
implied warranties of merchantability or fitness for any particular purpose. Furthermore, SafeNet reserves the right to revise
this publication and to make changes from time to time in the content hereof without the obligation upon SafeNet to notify any
person of organization of any such revisions or changes.
SafeNet invites constructive comments on the contents of this document. These comments, together with your personal and/or
company details, should be sent to the address below.
4690 Millennium Drive Belcamp, Maryland 21017, USA
Disclaimers
The foregoing integration was performed and tested only with specific versions of equipment and software and only in the
configuration indicated. If your setup matches exactly, you should expect no trouble, and Customer Support can assist with any
missteps. If your setup differs, then the foregoing is merely a template and you will need to adjust the instructions to fit your
situation. Customer Support will attempt to assist, but cannot guarantee success in setups that we have not tested.
This product contains software that is subject to various public licenses. The source code form of such software and all
derivative forms thereof can be copied from the following website: http://c3.safenet-inc.com/
We have attempted to make these documents complete, accurate, and useful, but we cannot guarantee them to be perfect.
When we discover errors or omissions, or they are brought to our attention, we endeavor to correct them in succeeding
releases of the product.
Technical Support
If you encounter a problem while installing, registering or operating this product, please make sure that you have read the
documentation. If you cannot resolve the issue, please contact your supplier or SafeNet support.
SafeNet support operates 24 hours a day, 7 days a week. Your level of access to this service is governed by the support plan
arrangements made between SafeNet and your organization. Please consult this support plan for further information about
your entitlements, including the hours when telephone support is available to you.
i
ii
CONTENTS
vi
Table of Contents
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
vii
Table of Contents
viii
CHAPTER MobilePASS Overview
1
In this chapter...
Overview ......................................................................................... 2
MobilePASS authentication options ................................................ 4
Evaluating MobilePASS tokens....................................................... 5
1
Chapter 1: MobilePASS Overview
Overview
Overview This guide discusses SafeNet MobilePASS® Software and Messaging tokens.
It includes administrative and end user information. Software and Messaging
tokens allow users to generate OTPs (One-Time-Passcodes) on their personal
mobile devices and Windows desktops. The Software and Messaging tokens
are compatible with SafeWord 2008 and SafeWord PremierAccess (for
Solaris), and enable secure remote access to corporate and web-based
applications. An integrated support feature allows administration directly from
the SafeWord management interface. The MobilePASS Portal allows users to
enroll, activate, and use their tokens without administrative assistance. The
MobilePASS product was integrated into SafeWord 2008 beginning in version
2.1.0.03, and in SafeWord PremierAccess (for Solaris) beginning in version
3.2.1.05.
The administrative information in this guide covers features that are configured
post token enrollment. Preenrollment administrative information is contained in
the SafeWord 2008 Administration Guide and the SafeWord PremierAccess
Administration Guide. Both documents are available from the SafeWord
documentation page at http://www3.safenet-inc.com/safeword/docs/2008.aspx
and http://www3.safenet-inc.com/safeword/docs/swpa.aspx respectively.
Deploying MobilePASS
To deploy MobilePASS, administrators generate token records, populate the
database with users, then notify users about MobilePASS. To generate token
records, refer to the SafeWord 2008 Administration Guide, which is available at
http://www3.safenet-inc.com/safeword/docs/2008.aspx or the SafeWord
PremierAccess Administration Guide, version 3.2.1, which is available at
http://www3.safenet-inc.com/safeword/docs/swpa.aspx. Figure 1 on page 3
illustrates the deployment process.
2
Chapter 1: MobilePASS Overview
Overview
Figure 1: Integrated
MobilePASS Administrator End User
deployment
6. Generate activation
2. Populate database with code from user device. If
users using auto-enrollment,
enroll with an assigned
passphrase..
9. Use MobilePASS
3
Chapter 1: MobilePASS Overview
MobilePASS authentication options
MobilePASS The integrated MobilePASS product extends token options with the addition of
MobilePASS Software tokens and MobilePASS Messaging tokens.
authentication
options MobilePASS now allows users to generate passcodes on the following mobile
devices and desktops:
Figure 2: Software
Authentication
Options
4
Chapter 1: MobilePASS Overview
Evaluating MobilePASS tokens
Evaluating SafeWord 2008 installations include four evaluation tokens (two Software and
two Messaging). SafeWord PremierAccess installations include two evaluation
MobilePASS Software tokens. The SafeWord 2008 evaluation tokens can be found in two
tokens import files (SoftwareEvalTokens.dat and MessagingEvalTokens.dat)
located in the SafeWord folder, or on a new installation of SafeWord 2008, they
are already present in the database. The SafeWord PremierAccess evaluation
token file <Admin Console Install Dir> \SoftwareEvalTokens.dat can be
imported after the SafeWord PremierAccess patch is applied. All of the
evaluation Software tokens are valid tokens that can be used like any other
licensed Software tokens. The evaluation Messaging tokens are intended for
evaluation purposes only and should not be used in production environments.
For details about the evaluation Software and Messaging tokens, refer to the
Chapter 2 of the SafeWord 2008 Administration Guide or Chapter 4 of the
SafeWord PremierAccess Administration Guide.
Note: The evaluation Software token records are included in the pool of available
token records and will be assigned to users from the pool. If you do not want
evaluation Software tokens assigned, delete the records from your database.
5
Chapter 1: MobilePASS Overview
Evaluating MobilePASS tokens
6
CHAPTER Deploying MobilePASS
2
In this chapter...
7
Chapter 2: Deploying MobilePASS
Software token enrollment
Software token Beginning with SafeWord 2008 version 2.1.0.04 and SafeWord PremierAccess
version 3.2.1.06, BlackBerry MobilePASS users can automatically or manually
enrollment activate and enroll MobilePASS tokens over their wireless network directly
from their device. If administrator-driven enrollment is preferred, refer to the
SafeWord PremierAccess Administration Guide or the SafeWord 2008
Administration Guide for details. These guides are available at http://
www3.safenet-inc.com/safeword/docs/swpa.aspx and http://www3.safenet-
inc.com/safeword/docs/2008.aspx respectively.
8
Chapter 2: Deploying MobilePASS
Assigning software tokens
Assigning You may assign software tokens to users using the Administration Console, or
you may allow users to self-enroll their software tokens using the MobilePASS
software tokens Portal. If users will enroll their tokens with the Portal, refer to “Using the
MobilePASS Portal” on page 10 of this guide.
If you are assigning software tokens to users with the Administration Console,
enrollment varies slightly depending on which operating system you are using,
and where your users are stored.
• If you are using SafeWord 2008, and your users are stored in Active
Directory, refer to Chapter 3 of the SafeWord 2008 Administration Guide for
details.
• If you are using SafeWord 2008, and your users are stored in the SafeWord
database, refer to Chapter 8 of the SafeWord 2008 Administration Guide
for details.
• If you are using SafeWord PremierAccess, refer to Chapter 4 of the
SafeWord PremierAccess Administration Guide for details.
9
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Using the The MobilePASS Portal and its Enrollment Portal provide end users with a
convenient interface for enrolling software tokens without the aid of an
MobilePASS administrator. For organizations with a large number of users, self-enrollment
Portal lightens the administrative effort when assigning tokens to users.
Users enroll their tokens using the MobilePASS Enrollment Portal, choosing
either manual or automatic activation. Once tokens are enrolled, users can
request token passcodes from their device, and use them to log into resources
protected by SafeWord.
1 Confirm the users are stored in the Active Directory database or in the
internal SafeWord database.
Note: If a user is stored in both the Active Directory and the SafeWord
database, the Portal can only be used for one database or the other. You
cannot use the Portal to enroll a user from both databases.
2 Ensure that there are sufficient software token records available for each
user who will be self-enrolling. (Refer to the SafeWord 2008 Administration
Guide or the SafeWord PremierAccess Administration Guide for more
information about generating MobilePASS tokens.)
3 Ensure that the appropriate token types and policies are being used. (For
SafeWord PremierAccess 3.2.1.06 only.)
4 Confirm the user has a MobilePASS enrollment reservation.
5 Provide users with the following:
• The URL of the MobilePASS application download site, and
instructions from this guide for installing MobilePASS on their device.
• The URL for the MobilePASS Portal:
https://<servername:port>/portal/enroll. By default, port 5444 is
used.
• Instructions for using the MobilePASS Portal. See “Using the
Enrollment Portal” on page 16.
10
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Disabling enrollment
You may choose to disable the software token enrollment feature entirely, or
you can disable the manual feature, leaving automatic activation enabled.
11
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Note: The device nickname feature is global, and applies to all future MobilePASS
enrollments until the feature is set to false.
12
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Administrators who choose to enroll their users token devices for them, can
also assign those tokens nicknames to distinguish them when multiple tokens
are assigned to the same user. When configured to collect token names, these
nicknames are collected and stored in the token records, providing
administrators with an easy way to identify a specific token when a user has
multiple tokens assigned to them. To enroll a token and specify a token
nickname, do the following:
1 In the Administration Console, highlight the user name, and then select
Tools > MobilePASS Enrollment.
2 Select Enroll Now.
3 Select the appropriate token policy, and then click Next.
4 On the device where MobilePASS is installed, start MobilePASS, choose
the manual activation, and then enter the policy string that was displayed
on the Administration Console wizard.
Figure 3: Select Device
Name
5 Return to the Admin Console and select a device nickname from the
predefined list, or specify your own name by selecting Other (Please
Specify) and then click Next.
6 A summary screen appears. Click Finish.
7 Enter the Activation Code provided by the device into the field on the
Administration Console, and then click Next.
13
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Figure 4: Actions
Performed
1 In the Administration Console, highlight the user name, and then select
Tools > MobilePASS Enrollment.
2 Select User will self enroll.
3 Select the appropriate token policy, and then click Next.
4 Enter a MobilePASS Enrollment Passphrase that the user will be required
to present when they enroll on the Enrollment Portal, and then click Next.
The Enrollment summary window appears with the enrollment status as
pending for this user.
5 Inform the user that they may now download and install MobilePASS, and
enroll their token device manually. Ensure the user knows their enrollment
passphrase, and the Enrollment Portal URL. Additionally, provide the user
with the following information explaing how to manually enroll and name
their token device.
14
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
15
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
To manually activate, enroll, and test tokens using the MobilePASS Enrollment
Portal, do the following:
16
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
Figure 7: Select
Activation Type window
Figure 8: Pre-
authentication window
Note: You will use your Windows credentials or your SafeWord user ID and
passphrase depending upon how SafeWord is set up.
17
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
6 If your device supports policy string entries, enter the Policy String that
displays on the Token Enrollment window into the Policy field on the device,
and then click Continue. If your device does not support policy string entry,
click the Continue button on the device. A MobilePASS Activation Code
appears on the device.
Figure 10: Enter
Activation Code window
7 Enter the Activation Code from the device into the Enter your activation
code field on the Enrollment Portal window, select a nickname for your
device (optional), and then click the Enroll Software Token button.
18
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
9 (Conditional) Enter a SoftPIN in the Enter your PIN field, and then re-enter it
in the Re-enter your PIN field. This SoftPIN must be appended to the end of
the MobilePASS passcode each time you authenticate.
10 Click the Enroll Software Token button. The Test Software Token window
appears with a successful enrollment message.
Figure 12: Test Token
window
11 Leave this window open, return to the device, and then click the Confirm
Activation button. If your administrator has chosen to enforce device PINs,
the Set Device PIN window appears on the device. Continue to the next
step. If device PINs are not enforced, a successful enrollment message
appears along with a passcode. Skip to step 13 on page 20.
19
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
12 (Conditional) Enter and re-enter a device PIN, and then click the Set PIN
button.
Figure 14: Time-sync
Token with Passcode
13 On the Enrollment Portal, enter the Passcode from the device into the Enter
software token passcode field. If you are required to use a SoftPIN, append
your SoftPIN to the end of the passcode.
14 Click the Test Software Token button. The Successful Enrollment Test
window appears.
20
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
21
Chapter 2: Deploying MobilePASS
Using the MobilePASS Portal
3 Scroll to the bottom of the file and add the following parameter and value:
AllowMobilePassReEnroll=true
4 Save and close the file.
5 Restart the Admin Server. Users can now reenroll without assistance from
the administrator.
SafeWord PremierAccess users are stored in the SafeWord database, and can
reenroll their tokens without administrative assistance if they have a maximum
of one MobilePASS token assigned to them. If a user has more than one
MobilePASS token assigned to them, the administrator must reenroll tokens for
the user. To allow SafeWord PremierAccess users to reenroll without
administrative assistance, a new parameter must be added to the
smswebapp.ini file. The parameter must be set to true. To add the parameter,
do the following:
22
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
Using iPhone iPhone MobilePASS allows users to generate passcodes directly on their
iPhones, iPod touch devices, and iPads. MobilePASS is compatible with
MobilePASS devices running iOS 4.2.0 or higher.
If the administrator will install MobilePASS on the device, proceed to the next
section “Installing iPhone MobilePASS” on page 23.
If the end user will install and enroll their own sofware token, provide the user
with the following:
• URL for the Apple App Store to download the MobilePASS application:
http://itunes.apple.com/app/safenet-mobilepass/id364682261?mt=8
• URL for the MobilePASS Enrollment Portal:
https://<servername:port>/portal/enroll
• MobilePASS installation and Enrollment Portal information.
• Credentials the user will use when activating on the Enrollment Portal (can
be user’s Windows credentials or their SafeWord domain credentials).
23
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
Note: You must complete the activation process or you will continue to be
prompted to complete activation each time you launch MobilePASS.
3 The Activation Code window appears with your 20-digit activation code.
Copy the Activation Code.
4 Open a browser and navigate to the MobilePASS Enrollment Portal using
the URL provided by your administrator.
5 Log in and select Authenticate. The Activation Code window appears.
24
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
6 Enter the activation code from MobilePASS into the Activation Code field on
the Enrollment Portal, and then click Enroll Software Token If your device
does not support policy strings, ignore the policy string that displays. The
Test Token window appears indicating successful enrollment.
7 Return to the iPhone MobilePASS application, and click the Confirm
Activation button.
8 You are asked if you want to continue with the MobilePASS activation. Click
Yes. The Set Device PIN window appears.
Figure 19: Set Device
PIN window
9 Enter a device PIN, and then reenter it. The Successful Activation window
appears displaying your first passcode.
25
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
10 Enter the passcode from the device into the Enter software token passcode
field on the Enrollment Portal, and then click Test Software Token. The
successful token enrollment window appears.
Figure 21: Successful
Token Enrollment window
26
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
If MobilePASS was closed before confirming activation on the device, when the
device is opened again, a confirmation message appears requesting the
completion of activation. In that case, do the following:
27
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
Generating passcodes
To generate passcodes for authentication:
1 Open the iPhone MobilePASS application and enter your device PIN.
2 Tap the Information i character in the lower right corner of the screen. The
MobilePASS Information windows appears with MobilePASS details.
Figure 24: MobilePASS
Information window
28
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
4 A message indicating that you are about to reset the token appears. You
will need to re-activate the token before you can use it again.
5 Select Reset Token. A Welcome to MobilePASS window appears.
Important: Unless the administrator has enabled the reenrollment feature, the user
cannot reenroll their token until the administrator removes that token from the
user’s record. Any previously-assigned tokens must be manually removed by the
administrator before the user can reset and reactivate (enroll) them. If the token is
not removed from the user’s record first, the activation will fail.
1 Open the MobilePASS application on the device, and enter the current
device PIN.
2 Tap the Information i character in the lower right corner of the screen. The
MobilePASS Information windows appears with MobilePASS details.
29
Chapter 2: Deploying MobilePASS
Using iPhone MobilePASS
Note: The Attack-Lock feature will reset your token if you enter the wrong device
PIN ten (10) times consecutively. When the token is reset, you will need to
reactivate it.
30
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
Understanding The most recent release of BlackBerry MobilePASS (beginning with SafeWord
PremierAccess version 3.2.1.06) includes the option to generate passcodes
BlackBerry using policy-enforced challenge-response (asynchronous) mode, time-
MobilePASS synchronous mode, or event-synchronous mode authentication on BlackBerry
MobilePASS devices. These options are set in the Administration Console,
with some configuration in either the .jad file or in the BES policy depending
upon the kind of deployment that will be used. BlackBerry MobilePASS can be
downloaded and installed directly to devices running BlackBerry OS version
4.3 and higher. The sections that follow describe how to configure and deploy
MobilePASS BlackBerry.
Note: The BES policy configuration is not available when deploying with
Desktop Manager.
• MobilePASS.cod
• MobilePASS.jad
• MobilePASS.alx.
31
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
Note: Administrators may also install the BlackBerry MobilePASS software onto
the device, and then distribute the device to the user. This method is convenient
when there are a small number of users.
32
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
• DisableSafeNetMobilePASSPolicy = False
• EnforceSafeNetMobilePASSPolicy = False
33
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
To configure the authentication policy via the BES policy, do the following:
2 Expand the Policy node in the BlackBerry solution management pane, and
select your IT policy rule. If you have not created an IT policy, create one
using the information contained in “Configuring BlackBerry auto-enrollment
via the BES policy” on page 37.
3 When the policy has been edited with the authentication policy parameters,
save the configuration, log out, and close the BlackBerry Admin Console.
34
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
These parameters can be used either in the .jad file, or set via BES policy to
customize your users auto-enrollment experience.
Note: By default, if no parameters are added, the user will be prompted to either
manually or automatically enroll.
• SafeNetMobilePassActivationMethod: Prompt
• SafeNetMobilePassActivationURL:
• SafeNetMobilePassModifyURL: true
• SafeNetMobilePassActivationFailover: true
Important: The default mode values will be used by the MobilePASS client if no
other values pairs are specified in the .jad file or in the BES policy.
35
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
36
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
3 (Optional) Enter a name for the policy in the Name field, and then click the
Save button.
4 From the BlackBerry solution management pane, select Create an IT policy
rule.
Figure 28: Create an IT
policy rule window
37
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
38
Chapter 2: Deploying MobilePASS
Understanding BlackBerry MobilePASS
39
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
Activating
MobilePASS
BlackBerry Downloading and installing BlackBerry MobilePASS
If BlackBerry MobilePASS is deployed via the BES, the BES delivers the
MobilePASS application to the device automatically along with the IT policy. If
you are not using BES deployment, install BlackBerry MobilePASS onto the
BlackBerry device by doing the following:
40
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
41
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
4 Enter the URL of the Enrollment Portal, and the port on which it listens in
the following format https://<servername:port>/portal/enroll, and then click
the Activate button. The User ID and Passphrase window appears.
Figure 36: User ID and
Passphrase window
5 Enter your user ID and the passphrase provided by your administrator, and
then click Submit. The Activating window appears. When it completes, the
device PIN window appears.
42
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
6 Enter and re-enter your desired device PIN, and then click the Set PIN
button. The Successful Activation window appears with a passcode for use.
Figure 38: Time Sync
token with passcode
window
43
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
Generating passcodes
To generate a new MobilePASS passcode, open MobilePASS.
1 Enter your device PIN (if required), and then click Generate Passcode.
2 (Conditional) If the token is a challenge-response mode token, enter the
challenge that was provided, and then click the Generate Passcode button.
Figure 40: Passcode
window
44
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
7 Enter your current device PIN, then enter and re-enter a new PIN.
8 Select Change PIN. A new window appears displaying a new passcode. The
device PIN has successfully been changed.
Note: If you are using a token that does not support MobilePASS token policies,
the Attack-Lock feature will reset your token when you enter the wrong device PIN
ten (10) times consecutively. When the token is reset, you will need to reactivate it.
If you are using a MobilePASS token that supports policies, the number of attempts
allowed before attack lockout varies depending upon the policy being used.
45
Chapter 2: Deploying MobilePASS
Activating MobilePASS BlackBerry
5 Click Reset Token. A new window appears informing you that you are
about to reset your token.
6 Click Reset Token. The Confirm Reset window appears.
7 To confirm the reset, click Yes. You must now reactivate MobilePASS. To
reactivate, refer to “Activating and enrolling software tokens manually” on
page 16.
46
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
Using J2ME The latest release of the integrated MobilePASS product includes J2ME
MobilePASS. J2ME MobilePASS runs on select mobile devices that are
MobilePASS enabled with Sun’s Java 2 Micro Edition Platform or Micro Edition Support
(CLDC 1.1/MIDP 2.0). Once J2ME MobilePASS is installed and activated on
the device, users can generate SafeWord strong authentication passcodes
directly from their device.
Note: The location of the J2ME MobilePASS icon may vary depending upon the
installation settings of your device.
Tip: Your J2ME MobilePASS screens and menu items may not match the screen
shots displayed in this guide.
47
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
48
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
d Enter the 20-digit activation code that was copied from the device.
e Click Enroll Software Token. The Test Software Token window
appears.
f Return to the device. A Confirmation window appears.
Figure 47: Confirmation
window with scroll bar
4 You may need to scroll down to read the entire confirmation. When you
have read the confirmation, click Yes. The Create a device PIN window
appears.
Figure 48: Create a
device PIN window
49
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
6 Highlight the Re-enter PIN field, and re-enter the same device PIN there.
7 Click Set PIN.
Figure 50: Successful
Activation window
50
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
Generating passcodes
To generate passcodes, open MobilePASS. The Enter device PIN window
appears.
51
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
1 Open MobilePASS.
2 Enter your device PIN, and then click OK. The Passcode window appears.
Figure 54: Change
device PIN Option window
3 Select Options, highlight Change PIN, then click OK. The Change device
PIN window appears.
52
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
4 Enter your current device PIN in the Enter current device PIN field.
5 Highlight the Enter PIN field, and enter a new device PIN.
6 Highlight the Re-enter PIN field, and re-enter the new device PIN.
7 Click OK. A new passcode appears, and your device PIN has been
changed.
Note: The Attack-Lock feature will reset your token if you enter the wrong device
PIN ten (10) times consecutively. When the token is reset, you will need to
reactivate it.
1 Open MobilePASS.
2 Enter your device PIN.
3 Click OK. A passcode appears.
53
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
4 Click Options > About, and then click OK. The About MobilePASS
window appears.
Figure 57: About
MobilePASS window
5 Select Reset Token. A new window appears informing you that you are
about to reset your token.
54
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
55
Chapter 2: Deploying MobilePASS
Using J2ME MobilePASS
8 Highlight Yes, and then click OK. You are returned to the Activation window.
Figure 61: Activation
window
9 Click Next, and then reactivate MobilePASS. If you need assistance, refer
to “Activating J2ME MobilePASS” on page 48.
56
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
Using Android Google Android is the latest mobile device for which the MobilePASS product
is available. MobilePASS Android users can generate one-time-use passcodes
MobilePASS directly on their Android mobile device, and use those passcodes to
authenticate to SafeWord-protected applications and resources. Android
MobilePASS is compatible with Google Android versions 1.6 and 2.x.
1 Start the Android Market application by clicking or touching the Market icon
on the Android Gallery. The Market appears displaying the applications that
are available.
Figure 62: Android
Market
2 Enter MobilePASS in the Search field, and then select the Search icon.
Figure 63: Search for
MobilePASS
57
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
7 Click or tap Activate Now to begin the activation. Continue to the next
section, “Activating Android MobilePASS” on page 59.
58
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
7 On the Activation Code window, click or tap the Confirm Activation button.
The Set device PIN - Enter New device PIN window appears.
Figure 68: Set device
PIN - Enter New device
PIN window
59
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
8 Enter a device PIN to use with this token, and then click or tap OK. The Re-
Enter PIN window appears.
Figure 69: Re-Enter
device PIN window
9 Confirm the device PIN by re-entering it. Click or tap OK. A new passcode
appears with the message that you have successfully activated
MobilePASS.
Figure 70: Successful
Activation window
60
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
Generating passcodes
To generate passcodes:
1 Open Android MobilePASS. If your token requests a device PIN, the device
PIN challenge window appears.
Figure 71: Enter your
device PIN window
61
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
4 Click or tap OK. The Enter your device PIN appears. This window includes
the number of attempts you have made to enter your device PIN. If you do
not enter the correct device PIN in 10 attempts, the Attack Lock feature will
force you to reset the token.
Note: When the Attack Lock feature forces you to reset a token, the token must
be reactivated.
5 Enter your device PIN, and then click or tap OK. A new passcode appears.
62
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
View A View B
5 On the Options window, click or tap Advanced Options. A new window
appears with the Change PIN option displayed.
Figure 76: Advanced
Options window
6 Click or tap Change PIN. The Change device PIN window appears.
63
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
Enter Current device PIN Enter New device PIN Re-enter New device PIN
7 To change the current device PIN:
a Enter the current device PIN that is associated with this token in the
Enter Current PIN window, and then click or tap OK.
b Enter a new device PIN in the Enter New PIN window, and then click or
tap the Change PIN button.
c Re-enter the new device PIN in the Enter New PIN window, and then
click or tap the Change PIN button. The Successful PIN change window
appears.
Figure 78: Successful
device PIN Change
window
64
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
1 Open Android MobilePASS. If your token requires a device PIN, enter the
device PIN at the challenge. A Passcode appears.
2 Select the Android Menu button on the device. The Options window
appears.
3 Select the Advanced Options button. A new window appears with the
Reset Token option displayed.
Figure 79: Reset Token
window
65
Chapter 2: Deploying MobilePASS
Using Android MobilePASS
66
Chapter 2: Deploying MobilePASS
MobilePASS Messaging
67
Chapter 2: Deploying MobilePASS
MobilePASS Messaging
68
CHAPTER Using the Legacy
3 MobilePASS Factory
In this chapter...
Overview ....................................................................................... 70
Messaging setup ........................................................................... 71
Using MobilePASS Messaging...................................................... 72
Using the stand-alone MobilePASS Factory ................................. 73
Installing the MobilePASS Factory ................................................ 76
Viewing and adding MobilePASS licenses.................................... 78
Customizing the MobilePASS Factory .......................................... 81
Resetting token serial numbers..................................................... 83
Importing token data to SafeWord................................................. 83
What’s Next? ................................................................................. 84
Understanding MobilePASS packages ......................................... 85
Deploying the software.................................................................. 87
Installing MobilePASS on end user devices.................................. 91
Customizing specific device options.............................................. 92
69
Chapter 3: Using the Legacy MobilePASS Factory
Overview
Overview SafeNet recommends that you use the latest version of MobilePASS that is
integrated with SafeWord 2008 and SafeWord PremierAccess. The earlier
legacy version described in this chapter offers support for MobilePASS clients
on older versions of BlackBerry and Windows Mobile (up o 6.x) devices. It also
allows Messaging use for users in the SafeWord user database. If you do not
have these needs, please skip this chapter, and use the current version of
MobilePASS. If you choose to use the earlier version, the following information
describes how to use the stand-alone MobilePASS Factory. The MobilePASS
Factory allows you generate records for the authenticator type called
Messaging, that uses SMS or SMTP to provide authenticating passwords to
users’ mobile devices. Before these authenticators can be assigned to your
users, you will need to generate them using MobilePASS Factory and then
import them into your SafeWord installation (see “Importing token data to
SafeWord” on page 83).
This field can also be populated by the user during the authenticator
generation step in the MobilePASS Factory.
70
Chapter 3: Using the Legacy MobilePASS Factory
Messaging setup
Messaging setup The core messaging servlet is installed with the MobilePASS Factory, however
there are a few items that need to be configured before you can use it.
userDBType=securecomputing.nbt.tokenasplugin.SWUserDBMapper
71
Chapter 3: Using the Legacy MobilePASS Factory
Using MobilePASS Messaging
Using When a user needs a password, they use the browser on their cell phone or
PC to connect to the appropriate URL to request a password.
MobilePASS
Messaging The URL will be something similar to:
https://hostname:5443/MPapp
The web page will prompt the user for their name, then deliver the password
after the page is submitted. If using a cell phone, it may be convenient to store
a link with all the necessary parameters so that, when a password is needed,
the user only has to select the link or icon on their phone and there will be no
other data entry required. Below is an example link:
https://hostname:5443/MPapp/PasswordRequest.do?name=joe
Note: In the example above, joe would be replaced by an actual user’s name.
72
Chapter 3: Using the Legacy MobilePASS Factory
Using the stand-alone MobilePASS Factory
Using the stand- The stand-alone MobilePASS Factory, can be installed either on the same
machine as SafeWord, or on a different machine. After installation, the stand-
alone alone MobilePASS can be customized to fit your organization’s needs and
MobilePASS generate platform-specific packages.
Factory You will import token records into SafeWord and assign authenticators to
users. Users are notified that they may authenticate using MobilePASS, and
they obtain their relevant package(s). After installing MobilePASS on their
device, your users can begin authenticating using MobilePASS-generated
passcodes. Figure 84 shows the token deployment process using the stand-
alone MobilePASS management feature.
73
Chapter 3: Using the Legacy MobilePASS Factory
Using the stand-alone MobilePASS Factory
• Valid SafeWord 2008 license with the Enterprise Solution Pack enabled.
• An Internet connection is recommended in order to obtain the latest
updates of MobilePASS automatically.
The following component specifications are required for running the MPF:
74
Chapter 3: Using the Legacy MobilePASS Factory
Using the stand-alone MobilePASS Factory
Evaluating MobilePASS
MobilePASS ships with a license that can be used to generate five
authenticators for evaluation purposes. This license automatically loads during
MobilePASS startup, unless a valid user license is detected. Since these
authenticators are meant for evaluation purposes only, MobilePASS generates
their import records using the same key for all evaluation customers.
Important: As the evaluation import records all share the same key, they should
not be used in a production environment.
75
Chapter 3: Using the Legacy MobilePASS Factory
Installing the MobilePASS Factory
Installing the The MobilePASS Factory can be downloaded from the SafeNet Web site. After
installation, the MobilePASS Factory, a standalone component, is used to
MobilePASS generate MobilePASS device packages for end users.
Factory
Downloading and installing the MobilePASS Factory
To download the MobilePASS Factory, browse to
http://.c3.safenet-inc.com.Table 3 is a checklist for downloading and installing.
As noted earlier, MobilePASS can be installed on the same server where
SafeWord is installed, or it can be installed on a different machine in the
network.
Task Description
76
Chapter 3: Using the Legacy MobilePASS Factory
Installing the MobilePASS Factory
• The MPF is available from Start > Programs > Aladdin > MobilePASS >
MobilePASS Factory.
• MobilePASS configuration files (mobilepass.ini, mpdefaultparam.ini,
messaging.ini, and webconfig.ini) are present in
<install_dir>\MobilePass\data\config.
Tip: For support information, use the Windows Add or Remove Programs tool to
locate MobilePASS in the list of currently installed programs. Select Click here for
support information.
77
Chapter 3: Using the Legacy MobilePASS Factory
Viewing and adding MobilePASS licenses
Viewing and If MobilePASS detects a valid license, the details of that license are available
for viewing from the MPF, and an additional license can also be added from the
adding MPF. To check the current license information, continue to Viewing the current
MobilePASS MobilePASS license. If addtional licenses are needed, continue to “Adding an
additional license” on page 79.
licenses
1 From the Start menu, select Programs > Aladdin > MobilePASS >
MobilePASS Factory.
78
Chapter 3: Using the Legacy MobilePASS Factory
Viewing and adding MobilePASS licenses
2 When the Welcome window appears, select View current license or add
another license.
In Figure 86, the upper portion of the License Management window shows
the current MobilePASS license information, and the lower portion provides
tools for adding additional licenses. The MobilePASS license can be used
for any of the supported device packages. To add an additional license,
refer to Adding an additional license.
1 Open the MobilePASS Factory by selecting Start > Programs > Aladdin >
MobilePASS > MobilePASS Factory.
2 When the Welcome window appears, select View current license or add
another license.
The lower portion of the window is the Add Additional License tool.
79
Chapter 3: Using the Legacy MobilePASS Factory
Viewing and adding MobilePASS licenses
80
Chapter 3: Using the Legacy MobilePASS Factory
Customizing the MobilePASS Factory
Customizing the After installation, files are written into the <install_dir>\MobilePass\data\config
directory that control and allow customization of MobilePASS. Microsoft
MobilePASS Notepad or a similar text editor can be used to edit these files.
Factory
For example: you could display your own company logos, icons, names, and
symbols in the MobilePASS interface, or you can customize the appearance of
the Windows Desktop tokens, and require that PINs be appended to the
passcodes for authentication. Table 4 and the sections below it summarize the
MobilePASS configuration files, and further customizing information is included
in each of the configuration files.
messaging.ini The config file for message delivery and user redirect.
Important: These files can be renamed arbitrarily. The property names (the names
to the left of the equal sign) inside the file must not be modified.
messaging.ini
This file contains configurations for determing whether Short Message Service
(SMS) or Simple Mail Transfer Protocol (SMTP) will be used for password
delivery. It includes configurations that determine which SafeWord Admin
server will be used for the routing information for password delivery, and
parameters to control user re-directs after password transmission.
mobilepass.ini
This is the main configuration file for MobilePASS. The token record output file,
and the name of the configuration file containing the token programming
parameters are configured here. If parameters in this file are changed, the
MPF service must be restarted.
mpdefaultparam.ini
81
Chapter 3: Using the Legacy MobilePASS Factory
Customizing the MobilePASS Factory
Important: Specific PIN modes or other configuration parameters that affect how
end users authenticate, should be conveyed to those users.
webconfig.ini
This file contains html pages that are used with MobilePASS. All aspects of
these pages are customizable. Unique corporate images and icons, user
messages, and user data collection fields can be displayed on these pages.
The actual web pages that can be customized are located in
<install_dir>\data\templates\html. If parameters in this file are changed, the
MPF service must be restarted.
• Local mode: In this mode, the PIN is required in order to generate the next
passcode. Hence, the user is prompted for one before a passcode can be
generated (local mode is the recommended PIN mode.)
• Append mode: In this mode, PINs are used in exactly the same fashion as
they would be with a hardware authenticator. A PIN would be assigned to
the user’s authenticator via the SafeWord 2008 Management Console or
Active Directory Users and Computers (ADUC). It would then be appended
to the passcode at authentication time. With this approach, a PIN is not
required in order for MobilePASS to generate a passcode.
1 Launch the Services tool by selecting Start > Programs > Administration
Tools > Services.
2 Locate and highlight the MobilePASS Factory in the list of services.
3 Select Restart the service option in the upper left corner of the window.
82
Chapter 3: Using the Legacy MobilePASS Factory
Resetting token serial numbers
There are a variety of reasons for which you may need to reset the license
counter. For example, if all licensed serial numbers have been used and an
employee who had been assigned a serial number in that range leaves the
company, you could reset the counter to the departing employee’s serial
number. To do this, you would go to license_counter.ini, set the next serial
number to the desired serial number in the range, and restart the MPF service.
The authenticator could then be assigned to someone else.
Tip: To reset the counter and force the MobilePASS Factory to generate tokens
using the first serial number, delete the data/config/license_counter.ini file, and
then restart the MPF. Reset the counter to begin with the first serial number or any
number in the series.
Importing token MobilePASS can produce two types of token import records (depending on
whether they were batch or user-generated) that must be imported into the
data to SafeWord SafeWord server before users can authenticate. Those files are:
Note: If the mpimport.dat file is renamed, the name must also be changed in
mobilepass.ini.
The basic process for importing token data files using the SafeWord 2008
Management Console is as follows:
1 Launch the console (Start > Programs > Aladdin > SafeWord > SafeWord
2008 Management Console).
2 Select File > Import, then choose Software/Hardware Authenticators.
3 Browse to (locate) the token data file, select an Admin Group into which
you want to import the files.
83
Chapter 3: Using the Legacy MobilePASS Factory
What’s Next?
What’s Next? At this point, MobilePASS is ready to be deployed to end users. You may
choose to deploy authenticators in two manners:
• You can generate a batch of authenticators and send them to end users as
device-specific packages.
• You can provide end users with the end user authenticator download page
URL and users can generate, download, and install their own
authenticators.
“Deploying the software” on page 87, provides instructions for both deployment
methods.
84
Chapter 3: Using the Legacy MobilePASS Factory
Understanding MobilePASS packages
Understanding You deploy MobilePASS to end users in the form of device-specific packages.
The packages contain the necessary files for installing MobilePASS. Installing
MobilePASS the software will vary by device type, and end users should consult their
packages device’s operating instructions when they install MobilePASS.
Important: Some of the device package information described in this chapter will
need to be distributed to end users.
• Windows Desktops
• BlackBerry devices
• J2ME devices
• Smartphones
• Pocket PCs
Important: The mpconfig.ini file must always be installed in the same directory
as the MobilePASS executable.
85
Chapter 3: Using the Legacy MobilePASS Factory
Understanding MobilePASS packages
Important: The mpconfig.ini file must always be in the same directory as the
MobilePASS executable.
Important: The mpconfig.ini file must always be in the same directory as the
MobilePASS executable.
86
Chapter 3: Using the Legacy MobilePASS Factory
Deploying the software
If PINs will be required for use with passcodes, you will need to convey that
information to the end users. PIN requirements are based on the token
parameter configurations set in the mpdefaultparam.ini.
Security Alert: For security purposes, you should distribute device packages to
end users separately from authenticator PIN information.
To generate a batch of authenticators, from Start > Programs > Aladdin >
MobilePASS > MobilePASS Factory.
87
Chapter 3: Using the Legacy MobilePASS Factory
Deploying the software
88
Chapter 3: Using the Legacy MobilePASS Factory
Deploying the software
The MPF processes the request and generates an import.dat file. The data
is placed in a uniquely-named directory based on the selected platform, the
number of authenticators, and the generation date and time.
89
Chapter 3: Using the Legacy MobilePASS Factory
Deploying the software
Note: Before allowing end users to generate and download MobilePASS device
packages, you must ensure the MobilePASS license has sufficient authenticators
available for all the end users.
1 On the MPF Welcome window, click the View the end user authentication
download page option.
The MobilePASS Authenticator Download page displays, and allows users
to generate and download their own authenticators.
2 Copy and save the URL (in the Address field at the top of the window), and
send this URL to end users along with instructions to launch this page,
select their desired platform, enter their user name, and select the
Generate Authenticator button.
MobilePASS processes the request, and displays the successful activation
as shown in Figure 92.
90
Chapter 3: Using the Legacy MobilePASS Factory
Installing MobilePASS on end user devices
Important: If a user forgets their PIN, you can refer to the audit.log file, which is
stored in the Output folder. This file contains a list of all the authenticators that were
successfully generated from the end user download page. The user name and the
authenticator serial number and PIN associated with it are contained in the file.
3 Tell your users to note and memorize their PIN, and then select the link(s)
to download MobilePASS for their device.
In Figure 92, selecting MobilePASS for Smartphones downloads the soft-
ware to the end user’s computer.
4 The users should consult their device’s user guide for instructions on how
to install MobilePASS.
Installing Once the MobilePASS package contents have been saved to the user’s
computer, MobilePASS can be installed on the user’s device. End users should
MobilePASS on refer to their device user guides for specific installation instructions.
end user devices
91
Chapter 3: Using the Legacy MobilePASS Factory
Customizing specific device options
Customizing In addition to the general configuration options that are available for the
MobilePASS Factory, certain device options can also be customized. The
specific device sections that follow describe these options.
options
Note: The MobilePASS Factory service must be restarted after customizing the
options for the device-specific packages.
Important: Custom skin and button files can be renamed, but in the mpconfig.ini
file, everything must be case sensitive and labels should not be modified.
When you are finished customizing the token options, the MPF service must be
restarted.
92
Chapter 3: Using the Legacy MobilePASS Factory
Customizing specific device options
93
Chapter 3: Using the Legacy MobilePASS Factory
Customizing specific device options
On some J2ME-enabled devices, the MobilePASS icon may either not appear
or may appear larger than desired. To change the icon for best display size, do
the following:
94
INDEX
I PIN behavior,changing 82
PINs 89, 91
importing records to SafeWord 83 requirements 74, 76
install MobilePASS 23 MobilePASS Factory 4, 81
installing MobilePASS 91 MobilePASS Factory service 82
iPhone MobilePASS MobilePASS for BlackBerry 85
activating 24 MobilePASS for J2ME 86
change PIN 29 MobilePASS for Pocket PCs 86
generating passcodes 28 MobilePASS for Smartphones 86
installing 23 MobilePASS for Windows Desktops 85
resetting 28 MobilePASS Messaging 81
iPhone/iPod touch devices 4 MobilePASS Portal 10
MobilePASS Route 70
mobilepass.ini 81
J MobliePASS
end users
J2ME devices 4
downloading authenticators 90
J2ME MobilePASS 47
mpconfig.ini 92
activating 48
mpdefaultparam.ini 81
Change PIN 52
changing PINs 52
deploying 47 O
generating passcodes 51
installing 47 Over the Air (OTA) deployment 31
resetting the token 53
R
M
reenroll software tokens
Mac OS 4 configuring to allow 21
Messaging 70 resetting
Messaging token 4 iPhone MobilePASS token 28
messaging.ini 71, 81 resetting license_counter.ini 83
MobilePASS
adding additional licenses 79
and PINs 87 S
compatibility 74
serial numbers 89
component specifications 74
SMS 70, 81
deploying 87
SMTP 70, 81
downloading 76
Software token 4
end user authenticator download page
90
end user download page URL 90 T
import.dat file 89
installing 76 test software token 19
installing on end user devices 91 token
installing on iPhone/iPod touch devices interface windows 92
23 token serial numbers 83
license_counter.ini 83
licenses 87
packages for end users 89
96
Index
V
Vista 4
W
webconfig.ini 82
Windows Phone 4
Windows XP 4
97
Index
98
SafeNet MobilePASS®
©2010 SafeNet, Inc. All rights reserved. SafeNet and SafeNet logo are registered trademarks of
SafeNet. All other product names are trademarks of their respective owners.