SkillsAdd

smithery.ai

azure-setup-guide

Research and generate Azure deployment guide with EasyAuth (Google + Facebook) and CosmosDB. This skill searches for current documentation and screenshots to produce an up-to-date setup guide at .docs/azure-setup-guide.md.

First seen Apr 17, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

azure-rbac Shared topics
microsoft/azure-skills 489K installs
microsoft-foundry Shared topics
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-ai Shared topics
microsoft/azure-skills

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybr…

568.2K installs
azure-deploy Shared topics
microsoft/azure-skills

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deploymen…

568.2K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 9,644 B
  • docs SUMMARY.md 247 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Azure Setup Guide Skill

This skill researches and generates a comprehensive Azure deployment guide for the finans application. It actively searches for the latest documentation to ensure instructions are current.

Stack Components

  • Azure App Service (Free F1 tier preferred)
  • EasyAuth (Azure App Service Authentication)
  • Google OAuth login
  • Facebook Login
  • Azure CosmosDB (NoSQL database)

Credentials Location

OAuth credentials are stored in backend/.env:

  • GOOGLECLIENTID / GOOGLECLIENTSECRET
  • FACEBOOKAPPID / FACEBOOKAPPSECRET
  • COSMOSDBENDPOINT / COSMOSDBKEY

Reference these when configuring EasyAuth instead of creating new credentials.

When to Use

Use this skill when:

  • Setting up a new Azure environment for finans
  • Updating deployment documentation after Azure Portal changes
  • Verifying current setup steps against latest Azure UI
  • Onboarding new developers who need deployment guidance

Workflow

Phase 1: Research Current Documentation

Search for the latest setup procedures:

  1. Azure App Service Authentication (EasyAuth)

- Search: "Azure App Service authentication 2024 2025 configure Google Facebook" - Search: "Azure EasyAuth setup guide latest" - Look for Azure Portal UI screenshots and current menu paths

  1. Google OAuth Configuration

- Search: "Google Cloud Console OAuth setup 2024 2025" - Search: "Google OAuth web application redirect URI Azure" - Verify current Google Cloud Console menu structure

  1. Facebook Login Configuration

- Search: "Facebook Developer Portal app setup 2024 2025" - Search: "Facebook Login OAuth redirect URI configuration" - Verify current Facebook Developer Portal menu structure

  1. Azure CosmosDB Setup

- Search: "Azure CosmosDB create database container 2024 2025" - Search: "CosmosDB Node.js SDK connection setup" - Verify current Portal paths and CLI commands

  1. Azure CLI Commands

- Search: "az webapp auth update syntax 2024" - Search: "az cosmosdb create CLI 2024" - Verify command flags haven't changed

Phase 2: Compile Guide

After research, write the guide to .docs/azure-setup-guide.md with:

  1. Prerequisites section - Azure CLI, accounts needed
  2. Resource Group creation
  3. App Service Plan - Free F1 tier
  4. Web App creation
  5. CosmosDB setup - Account, database, containers (users, portfolios)
  6. Google OAuth setup - Step-by-step with current menu paths
  7. Facebook Login setup - Step-by-step with current menu paths
  8. EasyAuth configuration - CLI and Portal methods
  9. Environment variables - Connection strings, secrets
  10. Deployment steps - Build, package, deploy
  11. Testing section - Verify auth URLs work
  12. Troubleshooting - Common issues and fixes
  13. Cleanup commands - Delete resources when done

Phase 3: Verification

After writing the guide:

  • Confirm all CLI commands use current syntax
  • Verify Portal menu paths match latest Azure UI
  • Include both CLI and Portal alternatives where possible
  • Note any recent changes from previous guide versions

Base Template

Use this as the foundation, updating with researched information:

Finans App - Azure Deployment Guide

Stack: App Service + EasyAuth + Google/Facebook Login + CosmosDB Tier: Free (F1) - suitable for development and testing

Prerequisites

  • Azure CLI installed and logged in (az login)
  • Azure subscription with Contributor access
  • Google Cloud Console account
  • Facebook Developer account
  • Node.js 20.x LTS

Verify Azure login:

az account show --query "{Name:name, SubscriptionId:id}" -o table

Step 1: Create Resource Group

az group create --name finans-rg --location norwayeast

Step 2: Create App Service Plan (Free Tier)

az appservice plan create \
  --name finans-plan \
  --resource-group finans-rg \
  --location norwayeast \
  --sku F1 \
  --is-linux

Free Tier Limits:

  • 1 GB storage
  • Shared compute
  • No custom domains or SSL
  • Good for development/testing

Step 3: Create Web App

az webapp create \
  --name finans \
  --resource-group finans-rg \
  --plan finans-plan \
  --runtime "NODE|20-lts"

Get app URL:

az webapp show --name finans --resource-group finans-rg --query defaultHostName -o tsv

Step 4: Create CosmosDB Account

4.1 Create Account (Serverless - Cost Effective)

az cosmosdb create \
  --name finans-cosmos \
  --resource-group finans-rg \
  --locations regionName=norwayeast \
  --capabilities EnableServerless \
  --default-consistency-level Session

4.2 Create Database

az cosmosdb sql database create \
  --account-name finans-cosmos \
  --resource-group finans-rg \
  --name finans-db

4.3 Create Containers

Users container (partition key: /id):

az cosmosdb sql container create \
  --account-name finans-cosmos \
  --resource-group finans-rg \
  --database-name finans-db \
  --name users \
  --partition-key-path /id

Portfolios container (partition key: /userId):

az cosmosdb sql container create \
  --account-name finans-cosmos \
  --resource-group finans-rg \
  --database-name finans-db \
  --name portfolios \
  --partition-key-path /userId

4.4 Get Connection String

az cosmosdb keys list \
  --name finans-cosmos \
  --resource-group finans-rg \
  --type connection-strings \
  --query "connectionStrings[0].connectionString" \
  -o tsv

Step 5: Configure Google OAuth

[RESEARCH CURRENT STEPS - Google Cloud Console menu structure may have changed]

  1. Navigate to Google Cloud Console → APIs & Services → Credentials
  2. Create OAuth consent screen (External, app name: finans)
  3. Create OAuth 2.0 Client ID:

- Type: Web application - Redirect URI: https://finans.azurewebsites.net/.auth/login/google/callback

  1. Save Client ID and Client Secret

Step 6: Configure Facebook Login

[RESEARCH CURRENT STEPS - Facebook Developer Portal menu structure may have changed]

  1. Navigate to developers.facebook.com → My Apps → Create App
  2. Select app type: Consumer
  3. Add Facebook Login product
  4. Configure:

- Site URL: https://finans.azurewebsites.net - Valid OAuth Redirect URI: https://finans.azurewebsites.net/.auth/login/facebook/callback

  1. Set Privacy Policy URL
  2. Switch app to Live mode
  3. Save App ID and App Secret

Step 7: Enable EasyAuth

CLI Method

# Enable authentication
az webapp auth update \
  --name finans \
  --resource-group finans-rg \
  --enabled true \
  --unauthenticated-client-action RedirectToLoginPage \
  --token-store true

# Add Google provider
az webapp auth google update \
  --name finans \
  --resource-group finans-rg \
  --client-id {GOOGLE_CLIENT_ID} \
  --client-secret {GOOGLE_CLIENT_SECRET} \
  --yes

# Add Facebook provider
az webapp auth facebook update \
  --name finans \
  --resource-group finans-rg \
  --app-id {FACEBOOK_APP_ID} \
  --app-secret {FACEBOOK_APP_SECRET} \
  --yes

Portal Method

[RESEARCH CURRENT PORTAL PATH - Azure Portal UI may have changed]

  1. Azure Portal → App Services → finans → Authentication
  2. Add identity provider → Google
  3. Add identity provider → Facebook
  4. Configure unauthenticated access

Step 8: Configure App Settings

az webapp config appsettings set \
  --name finans \
  --resource-group finans-rg \
  --settings \
    COSMOS_DB_ENDPOINT="https://finans-cosmos.documents.azure.com:443/" \
    COSMOS_DB_KEY="{PRIMARY_KEY}" \
    COSMOS_DB_DATABASE="finans-db" \
    NODE_ENV="production"

Step 9: Deploy Application

Build & Package

pnpm --filter frontend build
pnpm --filter backend build

Deploy

az webapp deploy \
  --name finans \
  --resource-group finans-rg \
  --src-path deploy.zip \
  --type zip

Step 10: Verify Deployment

Test URLs:

  • App: https://finans.azurewebsites.net
  • Google login: https://finans.azurewebsites.net/.auth/login/google
  • Facebook login: https://finans.azurewebsites.net/.auth/login/facebook
  • User info: https://finans.azurewebsites.net/.auth/me
  • Logout: https://finans.azurewebsites.net/.auth/logout

Troubleshooting

Common Issues

"Reply URL does not match"

  • Check redirect URI matches exactly including trailing slash

"/.auth/me returns null"

  • User not logged in or session expired
  • Check AppServiceAuthSession cookie

Facebook app not working

  • Ensure app is in Live mode (not Development)
  • Privacy Policy URL must be accessible

View Logs

az webapp log tail --name finans --resource-group finans-rg

Cleanup

Delete all resources:

az group delete --name finans-rg --yes --no-wait

Output Requirements

After completing research and compilation:

  1. Create .docs/ directory if needed
  2. Write complete guide to .docs/azure-setup-guide.md
  3. Report any steps that couldn't be verified
  4. Note any significant changes from previous documentation
  5. Confirm file creation with path

Notes

  • Always prefer free tier options where available
  • Include both CLI and Portal methods
  • Use norwayeast region for GDPR compliance
  • Serverless CosmosDB for cost efficiency