Quick Start - [Vault Vision](https://vaultvision.com) ================== This Vault Vision setup guide will get your user authentication and login management system up and running in less than a minute. ## Create an Account at Vault Vision Navigate to [Register](https://manage.vaultvision.com/register) and create an account. ## Try out your development sandbox Each Vault Vision account is provisioned a development sandbox [Tenant](/tenants.md) during registration. You will see the image below right after you signup or you can access it again by just visiting the [Management Panel](https://manage.vaultvision.com): ![vv-manage-popin-sandbox.png](img/vv-manage-popin-sandbox.png) Click the "**Open Sandbox in a New Window**" button to load the example application running on our servers: ![vv-sandbox.png](img/vv-sandbox.png) Click signup to create your first [User](/users.md). You can then test logging out or updating your settings: ![vv-sandbox-logged-in.png](img/vv-sandbox-logged-in.png) Feel free to explore the other options in the sandbox before moving on: ![vv-sandbox-options.png](img/vv-sandbox-options.png) ## Run your own example application locally We provide example auth applications written in Node, Go and Python with more to come. ```{note} Our system is built on open protocols that support every programming language. [Get in touch](https://vaultvision.com/contact-us/) with us if you would like support integrating with a programming language we don't currently provide an example for. ``` ### Get your configuration values Access the development sandbox popin again by visiting the [Management Panel](https://manage.vaultvision.com) and click the "**Display .env file**" button to get your configuration values for our open source example projects. Download or copy it locally into a file named `.env`, we will use it in the examples we configure next: ![Sandbox](img/vv-manage-popin-sandbox-env.png) ### Run the [Go auth example](https://github.com/vaultvision/go-auth-example) Get the source code from the [go-auth-example](https://github.com/vaultvision/go-auth-example) repository: ```bash git clone https://github.com/vaultvision/go-auth-example cd go-auth-example ``` Configure the app by placing the `.env` file we obtained previously into the root of the repo folder: ``` vi .env ``` Run the example on localhost: ```bash go run main.go ``` Visit [http://localhost:8090](http://localhost:8090) in your browser. ### Run the [Node auth example](https://github.com/vaultvision/node-auth-example) Get the source code from the [node-auth-example](https://github.com/vaultvision/node-auth-example) repository: ```bash git clone https://github.com/vaultvision/node-auth-example cd node-auth-example ``` Configure the app by placing the `.env` file we obtained previously into the root of the repo folder: ``` vi .env ``` Install dependencies: ```bash npm install ``` Run the example on localhost: ```bash npm run dev ``` Visit [http://localhost:8090](http://localhost:8090) in your browser. ### Run the [Python auth example](https://github.com/vaultvision/python-auth-example) Get the source code from the [python-auth-example](https://github.com/vaultvision/python-auth-example) repository: ```bash git clone https://github.com/vaultvision/python-auth-example cd python-auth-example ``` Configure the app by placing the `.env` file we obtained previously into the root of the repo folder: ``` vi .env ``` Install dependencies: ```bash python -m venv .venv # Or python3 for some systems .venv/bin/pip install --upgrade pip .venv/bin/pip install -r requirements.txt ``` Run the example on localhost: ```bash .venv/bin/python app.py ``` Visit [http://localhost:8090](http://localhost:8090) in your browser. ### Run the [React js boilerplate example](https://github.com/vaultvision/react-boilerplate-vv) ```{note} Prefer to watch a video? [React application user authentication setup](https://www.youtube.com/watch?v=K7It1YuXyBc) ``` - clone this github repo containing our React js boilerplate project - Copy over the env vars from the [Vault Vision Management Panel](https://manage.vaultvision.com/go#applications) into a NEW .env file located at the root of the project. You can copy this file as an example , or simply rename it .env and populate it with your correct env vars. - Run the npm start command to launch a local instance ``` npm run start ``` ### Run the [HTML boilerplate example](https://github.com/vaultvision/html-boilerplate) - clone this github repo containing our HTML boilerplate project - Copy over the env vars from the [Vault Vision Management Panel](https://manage.vaultvision.com/go#applications) into one of these files: or - Run the npm start command to launch a local instance ``` npm run start ``` ## Testing your local example With your local example running you can now see how you can use the same credentials to login to multiple applications hosted on different domains written in entirely different programming languages. Feel free to explore multiple programming languages using the same .env file.