devices/ms/Files/README

Summary

Maintainability
Test Coverage
/*
 * *****************************************************************************
 * Contributions to this work were made on behalf of the GÉANT project, a 
 * project that has received funding from the European Union’s Framework 
 * Programme 7 under Grant Agreements No. 238875 (GN3) and No. 605243 (GN3plus),
 * Horizon 2020 research and innovation programme under Grant Agreements No. 
 * 691567 (GN4-1) and No. 731122 (GN4-2).
 * On behalf of the aforementioned projects, GEANT Association is the sole owner
 * of the copyright in all material which was developed by a member of the GÉANT
 * project. GÉANT Vereniging (Association) is registered with the Chamber of 
 * Commerce in Amsterdam with registration number 40535155 and operates in the 
 * UK as a branch of GÉANT Vereniging.
 * 
 * Registered office: Hoekenrode 3, 1102BR Amsterdam, The Netherlands. 
 * UK branch address: City House, 126-130 Hills Road, Cambridge CB2 1PQ, UK
 *
 * License: see the web/copyright.inc.php file in the file structure or
 *          <base_url>/copyright.php after deploying the software
 */

This directory contains additional files for Windows installer modules.

  README - you are reading it now

Various utilities to be included in the installer code:
  GEANTLink - GIT submodule link to the GEANTLink binary
  WLANSetEAPUserData - EAP credential loading utility from https://github.com/rozmansi/WLANSetEAPUserData
  check_wired.cmd - utility to check status of wired 802.1X subsystem
  wlan_test.exe - utility for checking wireless status of Windows
  install_wired.cmd - install wired profile - a wrappr around netsh

Graphics:
  cat32.ico - CAT EXE icon
  cat_150.bmp - CAT header image
  cat_bg.bmp - default background

The NSIS code
   base64.nsh - NSIS module for base64 encoding/decoding (for license, see inline)
   strrep.nsh - NSIS search/replace macro copied from http://nsis.sourceforge.net/StrRep
   common.inc - common NSIS code for all modules
   eap_w8.inc - W8 and higher specific code
   geant_link.inc - NSIS code snippet for inclusion of GEANTLink
   peap_tls.inc - PEAP/TLS code for Vista/W7 installers
   pwd.inc - EAP-PWD code (calling Aruba installer)


Some explanation about constnts used in the NSIS code (not full)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  DEBUG_CAT - turn on the debugging messages code - this one is set manually in the code

The constants below are set by the Windows module when it generates the actual installer

  WIRED - install things for wired interfaces as well
  CRED - turn on the credentials installation code
  PASSWORD_BASED_CRED - username/password based credentials like PAP od MSCHAPv2
  TLS_CRED - credenials based on certificate
  SILVERBULLET - use the SilverBullet installation specifics
  SB_FINGERPRINT - SilverBullet user certificate SHA-1 fingerprint
  SB_USERNAME - SilverBullet username