Sentinel Hardware Keys Developer's Guide - Customer Connection ...

More documents

Recommendations

Info

Chapter 5 – Protecting Applications Using API Contents Glossary Index Troubleshooting What’s Next? After adding the API features, you may now: Build the license template using the instructions described in the Sentinel Keys Toolkit Help. When a license template is built, the following tasks are performed: Sentinel Key is programmed with the license information. Header file is generated. Code sketch is generated. Add the Business Layer API functions into your application’s source code, The Business Layer API Help provides complete details on each function. Also, do refer to the best practices described in Chapter 7, “Implementing Secure Licensing,” on page 167. Compile your application after including the Sentinel Keys header files and libraries. You may also apply CodeCover protection to your Windows executables and data files (if the file types are supported). You can now test your protected application. We recommend testing your application to verify that it executes correctly with the appropriate Sentinel Key both attached and missing. Note: If you are testing your protected application in network environment, make sure to restart the Sentinel Keys Server after building the license template. 132 Sentinel Hardware Keys Developer’s Guide
Business Layer API - Quick Reference SFNTSetContactServer - Sets the Sentinel Keys Server to be contacted for obtaining a license. SFNTSetConfigFile - Allows to reconfigure the name and path of the client-side configuration file. SFNTGetLicense - Obtains a license from the Sentinel Key having required developer ID and license ID. SFNTQueryFeature - Performs the query-response operation and verifies the licensing controls. SFNTEncrypt - Encrypts data using the AES algorithm. SFNTDecrypt - Decrypts data using the AES algorithm. SFNTSign - Signs content using the ECSSH algorithm. SFNTVerify - Verifies the digitally signed content using the public key. SFNTSetHeartbeat - Sets the heartbeat interval for maintaining a license. SFNTCounterDecrement - Decrements the Counter value by a specified amount. SFNTReadInteger - Reads Integer, Boolean, and Counter feature values of the in the Sentinel Key. SFNTWriteInteger - Updates the Integer and Boolean feature values in the Sentinel Key. SFNTWriteRawData - Updates the Raw Data feature value in the Sentinel Key. SFNTReadRawData - Reads the Raw Data feature value in the Sentinel Key. SFNTReadString - Reads the String feature value in the Sentinel Key. SFNTWriteString - Updates the String feature value in the Sentinel Key. SFNTGetFeatureInfo - Obtains information about a feature. SFNTGetLicenseInfo - Obtains information about a license. What’s Next? Contents Glossary Index Troubleshooting SFNTGetServerInfo - Obtains information about the Sentinel Keys Server that granted license(s) to the application. SFNTEnumServer - Enumerates the Sentinel Keys Servers running within the subnet for a Sentinel Key (having the desired developer ID and license ID combination). SFNTGetDeviceInfo - Obtains information about the Sentinel Key attached to a system. SFNTReleaseLicense - Releases the license and cleans up the memory allocated to the client library resources. Sentinel Hardware Keys Developer’s Guide 133
Page 2 and 3:
Copyright © 2009, SafeNet, Inc. Al
Page 4 and 5:
Certifications European Community D
Page 6 and 7:
FCC Compliance FC Sentinel Hardware
Page 8 and 9:
Contents Sentinel Keys Server .....
Page 10 and 11:
Contents Sending Group Files to Dis
Page 12 and 13:
Contents xii Sentinel Hardware Keys
Page 14 and 15:
Conventions Used in This Guide You
Page 16 and 17:
Technical Support Technical Support
Page 18 and 19:
We Welcome Your Comments Export Con
Page 21 and 22:
Chapter 1 Introduction In this chap
Page 23 and 24:
Sentinel Keys Protect Against Softw
Page 25 and 26:
Sentinel Keys Offer Sophisticated P
Page 27 and 28:
Sentinel Keys Offer Sophisticated P
Page 29 and 30:
The Business Layer API Functions Se
Page 31 and 32:
Programming Utility Sentinel Keys T
Page 33 and 34:
Frequently Asked Questions Contents
Page 35 and 36:
Page 37 and 38:
Chapter 2 Sentinel Hardware Keys SD
Page 39 and 40:
Compiler Interfaces Sentinel Keys L
Page 41 and 42:
Distributor Key Distributor Key Con
Page 43 and 44:
Sentinel Keys Contents Glossary Ind
Page 45 and 46:
Sentinel Keys Contents Glossary Ind
Page 47 and 48:
Sentinel Keys Server Contents Gloss
Page 49 and 50:
Sentinel System Driver Sentinel Sys
Page 51 and 52:
Backward-compatibility Information
Page 53 and 54:
Command-Line CodeCover Utility Cont
Page 55 and 56:
Key Programming APIs Contents Gloss
Page 57 and 58:
GCC a For Linux Compiler/Environmen
Page 59 and 60:
Sentinel Keys License Monitor Conte
Page 61 and 62:
Sentinel Protection Installer Conte
Page 63 and 64:
Secure Update API Frequently Asked
Page 65 and 66:
authentication.) Frequently Asked Q
Page 67 and 68:
Page 69 and 70:
Chapter 3 Planning Application Prot
Page 71 and 72:
About Features, Templates, and Grou
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Planning Application Protection and
Page 81 and 82:
Page 83 and 84:
Enabling License Sharing Planning A
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91:
Part 2 Designing and Implementing P
Page 94 and 95:
Chapter 4 - Protecting Applications
Page 96 and 97:
Page 98 and 99:
Page 100 and 101: Chapter 4 - Protecting Applications
Page 156 and 157: Chapter 6 - Secure Remote Updates C
Page 186 and 187: Chapter 7 - Implementing Secure Lic
Page 200 and 201:
Chapter 7 - Implementing Secure Lic
Page 202 and 203:
Chapter 7 - Implementing Secure Lic
Page 205 and 206:
Chapter 8 License Grouping This cha
Page 207 and 208:
Creating New Groups To create a new
Page 209 and 210:
Duplicating Groups Sending Group Fi
Page 211 and 212:
Creating New Feature Instances Cont
Page 213 and 214:
Export-File Manager Export-File Man
Page 215 and 216:
For a Loaded Group Frequently Asked
Page 217 and 218:
Update Existing Licensing Values Fr
Page 219 and 220:
Stand-alone License Manager Frequen
Page 221 and 222:
Chapter 9 Programming Sentinel Hard
Page 223 and 224:
Programming Sentinel Keys using Sen
Page 225 and 226:
To create an .wps file: Programming
Page 227 and 228:
Programming Sentinel Keys using the
Page 229 and 230:
Programming Sentinel Keys using the
Page 231 and 232:
Page 233 and 234:
Utility/Executable developed out of
Page 235 and 236:
Page 237 and 238:
Page 239:
Part 4 Distributing Protected Appli
Page 242 and 243:
Chapter 10 - Redistributables for C
Page 244 and 245:
Page 246 and 247:
Page 248 and 249:
Page 250 and 251:
Page 252 and 253:
Page 254 and 255:
Page 256 and 257:
Page 258 and 259:
Page 260 and 261:
Page 262 and 263:
Appendix A - Troubleshooting Conten
Page 264 and 265:
Page 266 and 267:
Page 268 and 269:
Page 270 and 271:
Page 272 and 273:
Page 274 and 275:
Page 276 and 277:
Appendix B - Glossary Contents Glos
Page 278 and 279:
Page 280 and 281:
Page 282 and 283:
Page 284 and 285:
Page 286 and 287:
Page 288 and 289:
Page 290 and 291:
Page 292 and 293:
Page 294 and 295:
Page 296 and 297:
Appendix C - Sentinel Keys Hardware
Page 298 and 299:
Appendix D - Migration from SuperPr
Page 300 and 301:
Appendix D - Migration from SuperPr
Page 302 and 303:
Index Contents Glossary Index Troub
Page 304:
Index Contents Glossary Index Troub
show all

Sentinel Hardware Keys Developer's Guide - Customer Connection ...

Create successful ePaper yourself

Delete template?

Save as template?