24U SimpleHASP Plug-In 1.1

This ReadMe file contains important information about 24U SimpleHASP Plug-In, such as system requirements, installation guide, quick start, troubleshooting, license notice, contact information, and copyright statement.
 


1. Introduction

24U SimpleHASP Plug-In is a FileMaker Pro plug-in that allows you to take advantage of USB hardware keys to protect your intellectual property and your client's data. SimpleHASP is compatible with HASP HL keys from Aladdin Knowledge Systems, the worldwide market leader in hardware -based anti-piracy solutions.
HASP HL keys are USB hardware keys (dongles) and are available in 5 different flavours (models), including network keys and a key with a built-in clock. HASP HL keys can be ordered from Aladdin Knowledge Systems or their resellers. You can also order a free demo key for testing before you are ready to configure your own keys.

More information can be found on HASP HL pages on Aladdin


     

2. System requirements

Recommended configuration:

  Power Macintosh G4 with Mac OS X 10.4.3, and FileMaker Pro 7v3 or newer
  or
  Macintosh with Intel processor, FileMaker Pro 8.5.
  or
  Pentium PC with Windows XP SP2 or newer, and FileMaker Pro 7v3 or newer.
 

Minimum requirements:

  Power Macintosh G3 with Mac OS X v10.2.8 or later, and FileMaker Pro 7v1
  or
  Macintosh with Intel processor, FileMaker Pro 8.5.
  or
  300MHz Pentium PC or higher, Microsoft Windows 2000, and FileMaker Pro 7v1

HASP HL Keys:



3. Installation

To install 24U SimpleHASP Plug-In, follow these steps:

On Macintosh:

  1. If you did not do this yet, download and mount the 24U SimpleHASP Plug-In image.
  2. Open the 24U SimpleHASP Plug-In image.
  3. Move the "SimpleHASP.fmplugin" file to your FileMaker Pro "Extensions" folder.
If HASP HL Drivers were not already installed:
  1. Make sure no HASP HL key is connected to the computer.
  2. Mount HDD_Installer_MacOSX.dmg image inside SimpleHASP image in folder SimpleHASP Extras/Support/HASP HL Drivers.
  3. Run AKSUSB Install.pkg and follow instructions.
  4. Mount LM_Setup_Mac.dmg in the same folder and run HASP LM Install.pkg. This installation is necessary only for net HASP Keys but it is recommended for all keys.
  5. Reconnect HASP HL key into the computer

On PC:

  1. If you did not do this yet, download and unzip the 24U SimpleHASP Plug-In archive.
  2. Open the 24U SimpleHASP Plug-In folder.
  3. Move the "SimpleHASP.fmx" file to your FileMaker Pro "Extensions" folder.
If HASP HL Drivers were not already installed:
  1. Make sure no HASP HL key is connected to the computer.
  2. Move to previously unzipped 24U SimpleHASP Plug-In direcotry and find HASPUserSetup.exe in SimpleHASP Extras/Support/HASP HL Drivers/HASP_HL_driver_setup.
  3. Run HASPUserSetup.exe and follow instructions.
  4. Go back to the folder HASP HL Drivers and to HASP_LM_setup and run lmsetup.exe. This installation is necessary only for net HASP Keys but it is recommended for all keys.
  5. Reconnect HASP HL key into the computer

 

 

4. Quick Start

Make sure you have at least one HASP HL key before begin.

24U SimpleHASP Plug-In is designed to be very easy to use. To start using the plug-in, simply open the "24uSimpleHASPTutorial.fp7" file and go through it step by step trying all the plug-in's functions. Do not forget to install Aladdin HASP HL Drivers as described in previous chapter and to insert HASP HL key into computer USB port or check if network key is inserted in computer in local area network.

To configure your own HASP HL Keys in your own solution follow these steps:

  1. Purchase HASP HL keys from Aladdin and SimpleHASP from 24U Software
  2. Configure your keys with 24U SimpleHASP Utility
  3. Test your configured keys with 24U SimpleHASP Sample Solution
  4. Implement HASP HL protection into your own solution

If you are new to FileMaker Pro plug-ins, start by checking the UsingFMPlugIns.html file inside the "Documentation" folder. It briefly explains what plug-ins are, why they are useful, and how they are usually used. You can also find the most up-to-date version of this document at http://www.24uSoftware.com/support/UsingPlugins.
 

5. Troubleshooting

Before you contact our technical support regarding problems or difficulties using 24U SimpleHASP Plug-In, please check if your issue is not listed below:

Function returns some number, what does it mean?
If there is an error, the function returns error code according to the HASP HL manual. Please see the manual of your key. If the function returns -50, it means that there are wrong parameters of the function.

Brief list of HASP HL error codes and their meaning
1 Your request exceeds the HASP HL memory range.
2 You have requested an unknown feature_id.
3 Your system is out of memory.
5 Access to feature is denied.
6 The legacy decryption function cannot work on the feature.
7 The HASP HL key is no longer available.
11 The installed driver is too old to execute the function.
12 A real-time clock (rtc) is not available.
14 The required driver is not installed.
22 You have passed an invalid vendor code.
23 The used hardware does not support the encryption type.
27 Program is running remotely on a Terminal Server.
31 The requested feature is no longer available.

The manual can be found on Alladin Support Pages. Error codes are described on page 252.

Plug-in does not work on Intel Mac.
This can be due to old version of HASP HL drivers. Please download new drivers from Aladdin website. Drivers from distribution disk image are universal binary and should work on Intel Macs.

What mean "feature_id", "vendor_code" and "fileid" parameters in Plug-In functions parameters.
vendor_code is a unique code assigned by Aladdin to their customers to identify them for HASP HL keys. HASP keys which you have ordered have assigned unique vendor_code which is stored on Master Key. Tutorial and Examples for 24U SimpleHASP Plug-In use special DEMO vendor_code which work with DEMO HASP HL Key which can be ordered from Aladdin for free. To test your own vendor_code insert it to text field in the beginning of the tutorial.
Mater Key is a special HASP HL key that contains the unique codes and identifiers assigned to you by Aladdin that are used with the HASP HL system. This key must not leave your possession. It is required to extract the Vendor Code data used by Vendor Center tools for protecting and licensing software. Master key is a part of HASP HL set from Aladdin.
feature_id If you have solution with several modules, each module chan be protected separately by assigning it a specified number. Use 0 if you don't have more modules to protect
fileid is a file identifier inside HASP HL key memory. The default value is 0xFFF0 hexa or 65520 in decimal. Use this value for most of operations with the HASP HL Key.

I still can't find out the reason for error messages.
Make sure correct HASP HL key is inserted inside USB slot. This plug-in is designed for HASP HL keys. If you have older HASP 4 keys, it will not work.

If your problem is not listed above or if the recommended solution does not work for you, please contact our technical support at http://www.24uSoftware.com/support.php for assistance.


 

6. Shareware Notice

Please note that 24U SimpleHASP Plug-In is SHAREWARE. That means it is not free and you have to pay a license fee if you want to keep it. You can install 24U SimpleHASP Plug-In and try it out for the period of 14 days. After this period, 24U SimpleHASP Plug-In can stop working and require a registration code. You will get your registration code after you pay for your license.

You can freely distribute 24U SimpleHASP Plug-In as long as you distribute the original compacted archive untouched and you don't charge money for the distribution. If you want to distribute 24U SimpleHASP Plug-In on a physical medium, such as CD-ROM, or if you want to distribute it in other form than the original compacted archive, you must ask for our permission. If you are a solution developer you can also bundle 24U SimpleHASP Plug-In with your products and sublicense it to your customers, provided you have purchased a developer license.

Please find detailed registration instructions in the file named "HowToRegister.html".
 

7. Contact Information

You can contact us at one of the following addresses. We prefer being contacted via e-mail, but you can use any other method if e-mail is not good enough for you.

E-mail:   info@24uSoftware.com   general information about our products and our company
eval@24uSoftware.com free evaluation codes registration
sales@24uSoftware.com paid licenses ordering and registration
support@24uSoftware.com technical support and bug reports
 
WWW: http://www.24uSoftware.com/
 
Phone: +420-224 910 892
Fax: +420-242 487 778
 
Snail mail: 24U Software
Skochovická 88
252 45  Zvole u Prahy
Czech Republic


8. Copyright

The software 24U SimpleHASP Plug-In is copyright ©2000-2007 24U Software. All rights reserved.

Portions of the software are 1984-2007 FileMaker, Inc. All rights reserved.