https://github.com/briandenicola/password-vault
This project is a demo on how to use Azure Functions with HTTP Triggers, Cosmosdb, and a VUE SPA application protected by Azure AD
https://github.com/briandenicola/password-vault
azure-functions cosmosdb dotnet entra-id python python3 vue
Last synced: 6 months ago
JSON representation
This project is a demo on how to use Azure Functions with HTTP Triggers, Cosmosdb, and a VUE SPA application protected by Azure AD
- Host: GitHub
- URL: https://github.com/briandenicola/password-vault
- Owner: briandenicola
- License: mit
- Created: 2019-01-06T04:37:35.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-02-13T20:42:13.000Z (8 months ago)
- Last Synced: 2025-04-12T08:52:53.979Z (6 months ago)
- Topics: azure-functions, cosmosdb, dotnet, entra-id, python, python3, vue
- Language: C#
- Homepage:
- Size: 393 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
This repository demonstrates the integration of Azure Functions with HTTP Triggers, Cosmos DB, and a Vue.js Single Page Application (SPA) secured by Azure EntraID (Azure AD). It illustrates the construction of a secure, scalable, and serverless application using modern front-end frameworks and cloud services.
[](https://codespaces.new/briandenicola/password-vault?quickstart=1)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/briandenicola/password-vault)
## Prerequisites
* A POSIX-compliant system, such as:
* [GitHub Codespaces](https://github.com/features/codespaces)
* Azure Linux VM (Standard_B1s VM recommended)
* Windows 11 with [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install)
* [.NET 8 SDK](https://dotnet.microsoft.com/download)
* [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)
* [Git](https://git-scm.com/)
* [Taskfile](https://taskfile.dev/#/)
* [Terraform](https://www.terraform.io/)
### Optional Tools
* [Windows Terminal](https://aka.ms/terminal)
* [Zsh](https://ohmyz.sh/)
> **Note:** GitHub Codespaces comes pre-configured with all necessary tools. Use this [link](https://codespaces.new/briandenicola/password-vault?quickstart=1) to open the project in GitHub Codespaces.
> **Note:** The script [./.devcontainer/post-create.sh](./.devcontainer/post-create.sh) can be used to install the tools on a Linux VM.
## Task Automation
Deployment is automated using [Taskfile](https://taskfile.dev/#/), simplifying the deployment process without a CI/CD pipeline. The Taskfile provides a consistent way to execute commands and scripts.
### Taskfile Commands
* `task up` : Builds the complete environment
* `task down` : Destroys all Azure resources and cleans up Terraform
* `task deploy-api` : Builds and deploys the API to Azure Functions
* `task deploy-maintenance` : Deploys the maintenance function
* `task deploy-ui` : Builds and deploys the UI to Azure Static Web Apps
* `task host-key` : Retrieves the host key for the Azure Function
* `task init` : Initializes Terraform
* `task plan` : Creates a Terraform plan
### Taskfile Configuration
The [TaskFile](../TaskFile.yaml) is located in the root of the repository and includes default values that can be customized:
| Name | Usage | Default Value |
|------|-------|---------------|
| TAG | Value used in Azure Tags | password-vault |
| DEFAULT_REGION | Default region to deploy to | canadacentral |
| COSMOSDB_FREE_TIER | Use the Cosmos DB free tier | false |
| DEPLOY_MAINTENANCE | Deploy Azure Functions for Keep Alives | false |
| ADD_CUSTOM_DOMAIN | Add a custom domain to Azure Static Web Apps | false |
| APP_REQUIRES_AUTHENTICATION | Require authentication for the UI | true |
## Environment Setup
* An Azure subscription (MSDN subscription is sufficient)
* An account with owner permissions on the Azure subscription and Global Admin on the Azure AD tenant
* **Warning:** Follow this [guide](https://learn.microsoft.com/en-us/azure/developer/terraform/get-started-cloud-shell-powershell?tabs=bash) to configure Terraform with a Service Principal.
## Navigation
[Return to Main Index 🏠](../README.md) ‖
[Next Section ⏩](./docs/entra.md)