MikeNeilson / tokn

Electron app for integrating local scripts with CWBI Keycloak Authentication/Authorization

TOKN

Enable CAC or Login.gov based authentication for local scripts for API access

This is a little helper app designed to run in the application tray letting users log into CWBI authentication services so that tokens can be used by local scripts to access authenticated web APIs.

User Setup

User Setup Guide

Development

To clone and run this repository you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
git clone https://github.com/USACE/tokn.git
# Go into the repository
cd tokn
# Install dependencies, make sure dev dependencies get installed
npm install
# Run the app
npm start

Note: If you're using Linux Bash for Windows, see this guide or use node from the command prompt.

Release Builds

npm version [major|minor|patch]
git push --follow-tags

then merge new feature branch into main

Resources for Learning Electron

• electronjs.org/docs - all of Electron's documentation
• electronjs.org/community#boilerplates - sample starter apps created by the community
• electron/electron-quick-start - a very basic starter Electron app
• hokein/electron-sample-apps - small demo apps for the various Electron APIs

Packaging for distribution

npm run make

License

CC0 1.0 (Public Domain)