Molaprise Business Card App

Setup & Support Administration Guide

🛠 I. Deployment (For Azure Administrators)

This guide will walk you through deploying and using the Molaprise Business Card application, a solution for centralized, digital business card hosting. The app is deployed as an Azure Solution Template that places all resources within your Azure subscription.

A. Prerequisites

  • Azure Subscription: You must have an active Azure subscription with Owner or Contributor rights.
  • Permissions: Global Administrator consent for the initial sign-in is required on first use.
  • Required Parameter: User Principal Names (UPNs) of the administrators who need access to the Branding/Admin page.

B. Deployment Steps

  1. Find the Offer: Navigate to the Azure portal Marketplace and search for “Molaprise Business Card.”
  2. Start Deployment: Click “Create” to launch the Solution Template wizard.
  3. Basic Settings:
    • Select your Subscription and a Resource Group.
    • Choose an Azure Region (Note: If deployment fails, try a different region with available resources).
  4. Application Settings:
    • App Name (Required): Enter a unique name (e.g., my-business-cards-us). This forms the web app URL.
    • Admin UPNs (Required): Enter a comma-separated list of admin emails (e.g., admin@yourdomain.com).
    • Dataverse Environment URL: Pro Version Only Enter your D365 environment URL (e.g., https://myd365.crm.dynamics.com).
  5. Review and Create: Click “Review + Create” and then “Create.” The ARM template automatically registers redirect URIs.
  6. Access the App: Once complete (5-10 min), navigate to the deployed Web App resource and click the URL.
Azure Deployment Interface
🔐 II. First-Time Sign-In & Admin Consent

The app uses Microsoft Entra ID (formerly Azure AD) for authentication and requires Microsoft Graph API access to read profile info (like job titles).

Admin Consent (Crucial Step): Because the app is multi-tenant, a Global Administrator must see the “Accept” button and grant Organization-wide Consent. This ensures all subsequent users can sign in without seeing the prompt. Tenant admin will get prompted for consent automatically when sign into the app.

Manual Consent for Pro Version

  1. Navigate to Enterprise Applications in the Azure portal.
  2. Locate the MolapriseBusinessCardPro application.
  3. Go to Security > Permissions and click “Grant admin consent for Default Directory.”
Admin Consent Screen
📊 Setup Permission for Dataverse Pro Only

To allow the application to upload contacts to Dataverse, perform the following setup:

  1. In Enterprise Applications, locate MolapriseBusinessCardPro and copy the Application ID.
  2. Go to the Power Platform Admin Center.
  3. Navigate to your environment > Settings > Users + permissions > Application users.
  4. Click “Add an app” and paste the Application ID.
  5. Assign the Salesperson role to the application user so it can submit contacts.
Dataverse Setup
📱 III. Using the Application
A. The Home Page (Your Card): The default page (/) shows your personal business card based on your Azure AD profile (name, title, email, phone).
B. The Admin Branding Page: Accessible only to Admin UPNs at /admin/branding. Use this to upload your Company Logo and set default company website/phone info.
C. Public Profile Sharing: Profiles are accessible via [YourAppURL]/profile/{alias}. Users can share their QR code (found on the home page) which links directly to this profile.
🩺 IV. Support & Troubleshooting
Issue Resolution
403 Forbidden on /admin/branding The account is not in the Admin UPNs list specified during deployment. Update the list via the Azure portal deployment parameters.
Login error after consent Verify the user account is active in Entra ID. Check the App Service Log Stream in Azure for detailed error messages.
Profile info is incomplete The app retrieves info from Microsoft Graph. Ensure jobTitle and mobilePhone are populated in Microsoft Entra ID.