Differences

This shows you the differences between two versions of the page.

--- software:chipmunk:setup:first_run [2025/07/01 11:40] – created support@smikar.com
+++ software:chipmunk:setup:first_run [2025/08/29 10:49] (current) – [Step 2: Deploy from Azure Marketplace] support@smikar.com
@@ Line 16: / Line 16: @@
   * ✅ Azure Blob Storage SAS URL
   * ✅ TLS Certificate files (PEM format), or plan to generate a self-signed certificate
+  * ✅ Entra ID Group name (e.g. ''chipmunkadmins'') — only members of this group will be able to access the dashboard
+If you haven’t created the admin group yet, follow the guide here:
+→ [[software:chipmunk:installation:app_registration#step_7_create_admin_group|How to create the admin group]]
 All of these values were configured or generated during the [[software:chipmunk:installation|previous setup steps]].
@@ Line 22: / Line 26: @@
 . Open the [[https://portal.azure.com|Azure Portal]]
 . Go to **Create a Resource**
 . Search for **Chipmunk - Automated User Archiving**
 . Click **Create**
 . Fill in:
    * **Subscription**, **Resource Group**
    * **Appliance Name** (e.g., ''chipmunk'')
    * **Region** and **VNet/Subnet**
 . Complete and deploy the resource
@@ Line 35: / Line 44: @@
 ===== Step 3: Access the Setup Wizard =====
-Once the appliance has finished deploying, open your browser and go to: //http://chipmunk.yourdomain:3000//
+Once the appliance has finished deploying, open your browser and go to:
+''http://chipmunk.yourdomain:3000'' //(port 3000 is only required for initial setup)//
+→ You’ll see the **Chipmunk Setup Wizard**.
-→ You’ll see the **Chipmunk Setup Wizard**
 ===== Step 4: Enter Configuration Details =====
@@ Line 44: / Line 53: @@
 The setup wizard will prompt you to enter:
-  * **Tenant ID** (from Azure App Registration)
+  * **Tenant ID** – from Azure App Registration.
-  * **Client ID** (Application ID)
+  * **Client ID** – Application ID.
-  * **Client Secret**
+  * **Client Secret**.
-  * **Blob SAS URL** (from Storage Setup)
+  * **Blob SAS URL** – from Storage setup.
-  * **Azure AI Endpoint and Key** (optional, for document summarisation)
+  * **Azure AI Endpoint and Key** – //(optional, for document summarisation)//.
-  * **TLS Certificate** (upload PEM files if not using self-signed)
+  * **TLS Certificate** – upload PEM files if not using self-signed.
-  * **DNS hostname** for this appliance
+  * **DNS hostname** for this appliance – e.g., ''chipmunk.yourdomain''.
+  * **Admin Group Name** – the exact name of your Entra ID security group (e.g., ''chipmunkadmins'').
-Double-check each value before submitting.
+Only users who are members of this group will be able to log in to the Chipmunk dashboard.
 ===== Step 5: Finish Setup & Restart =====
-. Click **Submit**
+  - Click **Submit**.
-. Chipmunk will apply your configuration and restart the appliance
+  - Chipmunk will apply your configuration and restart the appliance.
-. Wait **2 full minutes** for the system to restart and apply TLS settings
+  - Wait **2 full minutes** for the system to restart and apply TLS settings.
-After restart, your browser will be redirected to: //https://chipmunk.yourdomain//
+After restart, your browser will be redirected to:
+''https://chipmunk.yourdomain'' //(HTTPS on port 443 for all normal access after setup)//
 You may need to **accept a certificate warning** if you chose the self-signed certificate option.
@@ Line 70: / Line 80: @@
 You can now:
-  * Monitor backups
+  * Monitor archives
   * View archived users
   * Restore data as needed
@@ Line 85: / Line 95: @@
 Need help? Visit [[software:chipmunk:support|Support]] or contact [[support@smikar.com]]
-{{tag>chipmunk setup first_run configuration wizard tls deployment marketplace}}
+{{tag>chipmunk setup first_run configuration wizard tls deployment marketplace entra group}}