Sample App

We’ve set up a very simple sample app, so that you can demo UserClouds Authentication in less than 5 minutes. We've simplified the code to the bare minimum, so please do apply actual software engineering practices to any code you derive from this!

1. Clone the sample code / repo

• Python: git clone ssh://[email protected]/userclouds/gettingstarted-python.git
• Go: git clone ssh://[email protected]/userclouds/gettingstarted-golang.git

More languages coming to our GitHub soon! To request a language or share a client you wrote, please email us at [email protected] .

2. Run the sample app locally

Make sure you have Git and Python / Go installed, then run the clone command in your Terminal. This doc assumes you are using python3 and Go 1.18+.

If you’re using Python, we'd recommend using a virtualenv to isolate dependencies (as with any Python project). We haven't included the virtualenv to avoid system-specific path issues.

python3 -m venv .  
source bin/activate  
pip3 install -r requirements.txt

3. Try it out!

Point a browser at http://localhost:8080 and click “login”. You will be redirected to a UserClouds branded login screen. Of course, this page can be customized to your branding later.

From here, you can create your own account, by clicking "Create an Account" below the login button. Once you’ve created your account, you’ll be automatically logged in and redirected back to your sample app. The app will display the parameters of the JWT validating your log-in. Nice work!