Cardinal Key Installation

Windows

1. Download and open the installer.

   Download Cardinal Key Installer for Windows

2. Select Get Started.

   

3. Use the device name displayed at MyDevices to ensure compliance. Learn more about device names. Select Continue.

   

4. Select Download and Install.

   

5. A browser will load, enter your SUNet ID and password.

   

6. Close any open browsers, and select Configure Browsers.

   

7. Select each browser link, the respective browser will open and automatically enable Cardinal Key.

   Note: Enable Cardinal Key authentication for any browsers that are not detected.

   

8. You're done! Learn more about using your Cardinal Key and click Close.

   

macOS

1. Download and open the installer.​

   Download Cardinal Key Installer for macOS

2. Select Get Started.

   

3. Use the device name displayed at MyDevices to ensure compliance. Learn more about device names. Select Continue.

   

4. Select Download and Install.

   

5. A browser will load, enter your SUNet ID and password.

   

6. macOS Big Sur (v.11) clients must click the Install button in the Profiles pane.

   

7. Select Configure Browsers.

   

8. Select each browser link, the respective browser will open and automatically enable Cardinal Key.

   Note: Enable Cardinal Key authentication for any browsers that are not detected.

   

9. You're done! Learn more about using your Cardinal Key and click Close.

   

Features

Mac/Win

• Downloads and Installs Cardinal Key for User
• Download and Installs Cisco VPN
• Configures Firefox for Use with Cardinal Key
• Presents List of Found Browsers to User, Opening Each to Cardinal Key Cookie Enable URL

Known Bugs / Caveats / Notes

Mac/Win

• Computers must be connected to the internet. Currently, no warnings exist for scenarios in which the computer is not connected to the internet.
• Will not detect fresh installed Chrome or Firefox if they have not been opened at least once.
  • Workaround: Be sure that Chrome or Firefox has been run at least once upon running Cardinal Key Installer

Windows

• The program will self elevate by creating a temp directory in ProgramData and then executing a shortcut of the application from the desktop. This behavior will be changed and improved in future versions.
• Firefox ESR may not be detected and displayed, it will be configured for Cardinal Key, though. Manually navigate to https://login.stanford.edu/cookie/x509?action=enable.

Mac

• On Big Sur, the profile cannot be installed automatically; the user will be prompted to enable the Profile by going to System Preferences => Profiles.

Release Notes

1.0.9

• Fixed issues downloading Cardinal Key on Windows
• Updated code build against Node v14
• Updated unit tests and build automation

1.0.8

• Fixed Bug with Screen Reader on headers

• Added functionality to write cert information for BigFix upon CK install

• Updated code libraries

1.0.7

• Accessibility fixes
• UI improvements
• Fixed bug with Cloudpath site intermittently not loading

1.0.6

• Bugfix - opening profile too quickly before the download finishes results in profile deletion on macOS
• Bugfix - fails gracefully if serial number not detected on macOS
• Edge browser configuration support on macOS
• Bugfix - Firefox ESR & RR browser compatibility in Windows

1.0.5

• N/A

1.0.4 - Windows

• Adjusted installer to account for changes to CloudPath site
• Updated wording for installer wizard

1.0.3 - macOS:

• Updated wording for installer wizard
• Fixed bug where MacOS version hangs trying to find downloaded mobileconfig profile

1.0.2 - (12/4/2020)

• Added new “Done” screen with the link to Cardinal Key documentation
• Adjusted text on various screens to be more clear
• Fixed bug with hostname detection on Windows and macOS
• Added functionality to close all open browsers before installing Cardinal Key
• Added functionality to delete any existing Cardinal Keys on the Cloudflare/Cloudpath website (This only deletes Cardinal Keys setup via the Installer ~ Specifically, any key has the same name as what the program is about to set.)
• Fixed bug where multiple Firefox windows would open on macOS when setting Cardinal Key cookie

1.0.1 - (12/1/2020)

• Fixed spelling errors in the application
• Fixed bug where hostname on macOS was not the same as the bonjour name
• Fixed WebAuth window not loading on MyDevices link; changed app to open the website in native system browser or default browser
• Fixed bug on macOS where Stanford folder in ~/Library/Application Support cannot be written to; changed where dependency files are saved.