Dropper/README.md

36 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2020-02-22 04:14:17 +00:00
# Dropper
2020-02-22 04:38:09 +00:00
Dropper is an uploading/downloading application to push and pull data from devices.
2020-02-22 04:31:22 +00:00
# Notes
* Need python 2+
* Set the fields in static/google-api-data.json file to use the google drive picker api.
2021-02-14 01:17:11 +00:00
* You will need Keycloak setup to use this application.
* DNS over HTTPS can affect hosts file usage so make sure to disable that if using Firefox and editing hosts file.
2021-02-14 01:29:36 +00:00
* If using HTTPS, you will need to add your certificate information to httplib2's (located in your venv folder under site-packages) 'cacerts.txt' file. Otherwise, you'll get "itsdangerous.exc.BadSignature:" error trying to login or out.
2020-02-22 04:31:22 +00:00
2021-02-14 01:17:11 +00:00
# Setup
You will need Keycloak setup to use this application. The file 'client_secrets.json' has the predefined structure setup so you can use it for reference- modify accordingly. If you use the same realms and clients in Keycloak, you'll still need to change the 'client_secret' key; the one shown is an example of what you need to get from Keycloak (CHANGE and KEEP this SECRET if using on a public facing site!). In addition, use the hosts file on your computer to setup redirects for 'www.ssoapps.com' (Keycloak) and 'www.dropper.com' (Dropper App).
``` NOTE: These need to be set for loadPicker... (See: Dropper/dropper/static/google-api-data.json)
2020-02-22 04:31:22 +00:00
// The Browser API key obtained from the Google API Console.
// Replace with your own Browser API key, or your own key.
let developerKey = '';
// The Client ID obtained from the Google API Console. Replace with your own Client ID.
let clientId = ""
// Replace with your own project number from console.developers.google.com.
// See "Project number" under "IAM & Admin" > "Settings"
let appId = "";
```
# Images
![1 Default view starting out. ](images/pic1.png)
![2 Upload view pre-uploaded. ](images/pic2.png)
![3 Upload view post-upload. ](images/pic3.png)
![4 Google drive api uploader view. ](images/pic4.png)
# TODO
Nothing...