Getting Fieldstone up and running

Before deploying Fieldstone, make sure you have the following:

• A Microsoft Azure account. If your firm uses Microsoft 365, you likely already have one. Go to portal.azure.com and sign in with your Microsoft work account to check.
• Your Fieldstone license key. This was emailed to you when you purchased — it looks like FLDS-XXXX-XXXX-XXXX-XXXX.
• About 15–20 minutes of uninterrupted time.

An App Registration is how you give Fieldstone permission to read data from your Microsoft environment — things like SharePoint storage and user security settings. Think of it as creating a set of keys that Fieldstone can use to access your data.

1. Go to portal.azure.com and sign in.
2. In the search bar at the top, type Microsoft Entra ID and click it in the results.
3. In the left menu, click App registrations.
4. Click + New registration at the top.
5. Fill in the form:
   
   Name: Fieldstone
   Supported account types: Select "Accounts in this organizational directory only"
   Redirect URI: Select "Web" and enter your Fieldstone dashboard URL (you'll get this after deploying in Step 4 — come back and add it then)
6. Click Register.

Fieldstone needs three values from your App Registration. Here's exactly where to find each one:

To get your Client Secret:

1. In the left menu of your App Registration, click Certificates & secrets.
2. Click + New client secret.
3. Give it a description — e.g. Fieldstone Secret — and set expiry to 24 months.
4. Click Add.
5. You'll see a new secret appear. Copy the value in the Value column immediately — it will only be shown once and disappears when you navigate away.

Once you have all three values, paste them somewhere safe (like a notes app) before moving to the next step.

Click the button below to open the Azure deployment form. Azure will automatically create everything Fieldstone needs — the dashboard, database, and security vault — inside your own Azure subscription.

Fill in the deployment form using the values you gathered in the previous steps:

1. Click Review + create at the bottom.
2. Click Create to start the deployment.
3. Wait about 5 minutes for Azure to finish. You'll see a "Your deployment is complete" message.
4. Click Go to resource group and find the App Service resource. Click on it and note the URL — it will look like fieldstone-abc123.azurewebsites.net. This is your dashboard URL.

Before you can sign in, you need to tell your App Registration where your Fieldstone dashboard lives.

1. Go back to your App Registration in the Azure portal (search for Microsoft Entra ID → App registrations → Fieldstone).
2. In the left menu click Authentication.
3. Under Redirect URIs click Add URI.
4. Paste your dashboard URL followed by /auth/callback — e.g. https://fieldstone-abc123.azurewebsites.net/auth/callback
5. Click Save.

Now go to your dashboard URL in a browser. You'll be redirected to a Microsoft sign-in page. Sign in with your Microsoft work account and accept the permissions — Fieldstone will ask for read-only access to your Microsoft data.

Your first daily digest will arrive tomorrow morning at 9am at the email address you configured.