LogoLogo
LogoLogo
  • Welcome
    • Navigation
  • RealmJoin Deployment
    • Onboarding
    • Required Permissions
    • Infrastructure Considerations
      • Multi User Devices
    • Migration to RealmJoin vNext
  • User, Group and Device Management
    • Overview
    • User Profile
    • Organization Details
    • User, Group and Device Lists
      • Advanced Search
      • User Details
      • Group Details
      • Device Details
    • User and Group Settings
      • Available RealmJoin Policies
  • App Management
    • Packages
      • Package Store
        • Application Store Details
      • Package Management
      • Package Details
      • Package Assignments
        • Package Migration
      • Package Settings
      • Packaging Requests
        • Organic Packages
    • AVD Templates
  • Automation
    • Connecting Azure Automation
      • Required Permissions
      • Runbook Parameters
    • Runbooks
      • Runbook Customization
      • Runbook Permissions
      • Naming Conventions
      • Runbook Scheduling
      • Runbook Logs
        • Runbook Job Details
      • Runbooks Changelog
    • Requirements
    • Remediation Scripts
  • RealmJoin Agent
    • Features
      • Local Admin Password Solution (LAPS)
        • KeyVault
        • Application Insights
      • Notifications
      • AnyDesk Integration
        • AnyDesk configuration
      • App Deployment using the Agent
        • RealmJoin ESP
    • Deploying the Agent
    • User Interface
  • Logs
    • Connecting Azure Log Analytics Workspace
    • Audit Log
  • RealmJoin Settings
    • Overview
    • General
    • Roles and Permissions
      • Pre-defined Roles
      • Custom Roles
        • Available Permissions
    • Group Namespaces
    • Workplace Cloud Storage
    • Self Service Forms
  • Developer Reference
    • RealmJoin API
      • Authentication
    • Interacting with Runbooks
    • Simulating a Runbook Environment
    • Local Admin Password Management
  • Other
    • FAQ
      • Security
    • Troubleshooting
      • Package Installation Issues
        • Collecting Logfiles
        • Logfiles Structure
        • Analysing chocolatey.log
        • Troubleshooting failed chocolatey packages
        • Troubleshooting failed craft packages
        • Fixes for common issues
        • Intunewin Debugging
      • LAPS Issues
        • LAPS account passwords cannot be retrieved
        • Requested LAPS Accounts are not being created
    • Changelog
  • Legal
    • Licensing
    • Support
  • RealmJoin Website
Powered by GitBook
On this page
  • Overview
  • Setup
  • Create Storage Account
  • Migration from Azure Web App
  • Favorites
  • Microsoft Edge or Google Chrome on Windows
  • Microsoft Edge or Google Chrome on macOS
  • Backgrounds and Other Files
  • Outlook Signatures
  • Create or edit signature
  • Distribute signature

Was this helpful?

Edit on GitHub
  1. RealmJoin Settings

Workplace Cloud Storage

Last updated 11 months ago

Was this helpful?

Overview

Modern Workplace devices are getting policies and configurations via Microsoft Intune. Some of these settings rely on files available by URL or in special formats like JSON or XML. This RealmJoin feature is intended to manage those files via an easy-to-use interface for administrators.

Currently the following types are supported:

  • Managed Favourites (Microsoft Edge and Google Chrome)

  • Backgrounds and other files

  • Outlook signatures

This native integration in RealmJoin makes the separate app (Azure Web App) from GitHub or Azure Marketplace obsolete:

The feature of managing Enterprise Mode Site Lists is covered by Microsoft 365 admin center. So, existing or new site lists need to be added as described here: . The resulting site list ID is then published via an Intune policy to Microsoft Edge.

Setup

Please contact RealmJoin support to activate this feature for your tenant.

Create Storage Account

  1. This feature requires a blob storage on Azure. Please create a new storage account:

  1. Adjust the settings like name, region and redundancy based on your needs.

  1. Enable the setting "Allow enabling anonymous access on individual containers" needs to be enabled (tab "Advanced"). This is required for stored files like backgrounds which have to be accessible anonymously

If the setting "Allow enabling anonymous access on individual containers" is not enabled during creation of the storage account, RealmJoin will display the error "Error uploading file. Please try again". If so, please move to "Settings" of your storage account and set "Allow Blob anonymous access" to "Enabled".

  1. If you don't have any special requirements please use the default values for the other tabs like "Networking" and "Data protection".

  2. Once created successfully, please go to the new storage account and navigate to "Access keys". Please copy the "Connection string" under "key1":

  1. Navigate to RealmJoin Portal (as administrator)

  2. Open settings and switch to the tab "Workplace cloud storage".

  3. Paste in the previously copied connection string into "Access key (Connection string) for Azure Storage account" and click on "Save":

Migration from Azure Web App

Connect existing storage account

Please navigate to the corresponding and already existing storage account and add the access key to RealmJoin (as described in the previous section). Afterwards, your existing data will automatically be displayed in RealmJoin.

Clean-up

The web app (that provides the admin portal) is no longer needed. So, navigate to the resource group and delete the following resources on Azure:

  • App Service

  • App Service plan (connected to the App Service)

Pay attention to not delete the storage account.

Please also delete the obsolete Enterprise App in Entra ID (naming might be different):

Favorites

RealmJoin allows you to add and maintain several favorite lists via a simple UI. Afterwards, they can be exported or copied in formats like JSON or XML.

  1. Navigate to the favorites feature in the main menu and create a new list. The newly create list will get an ID that can be changed on your needs (just for internal identification of the corresponding list).

  1. Add desired links or create sub-folders. The name of the first folder (default name: "Favorites Bar") will be the name of the folder in favorites bar - visible to the user (most customers change this to their company name).

  1. Afterwards, you can export the list in different formats:

    • JSON (Microsoft Edge or Google Chrome on Windows)

    • XML file (Microsoft Edge or Google Chrome on macOS)

    • URL with XML (Microsoft Edge Legacy)

Microsoft Edge or Google Chrome on Windows

Create a new settings catalog profile with the setting "Configure favorites" and paste in the JSON:

For Google Chrome, the setting is called "Managed Bookmarks".

Microsoft Edge or Google Chrome on macOS

Create a new configuration profile (template) of type "Preference file". As "Preference domain name" enter "com.microsoft.Edge". Upload the XML generated via RealmJoin:

For Google Chrome set "Preference domain name" to "com.google.chrome" and use the corresponding XML. Only difference between Microsoft Edge and Google Chrome XML is the first line:

<key>ManagedBookmarks</key> instead of <key>ManagedFavorites</key>

Backgrounds and Other Files

Navigate to the organization section in the menu. Switch to tab "Backgrounds" or "Other Files". Now, simply upload desired files (background images, configuration files, public certificates etc.). They will be added to the blob storage and get public accessible URLs. Use those URLs in your configuration profiles (e.g.: set background image via Intune), scripts etc.

Do not upload sensitive files as they become reachable via public URLs.

Outlook Signatures

This feature allows you to add templates for Outlook signatures. In conjunction with a RealmJoin software package (Windows only) the desired template is downloaded to your managed clients and added to Outlook Desktop. In addition, you can add variables in the template that are replaced with user properties (like name, email, job title or phone number).

Create or edit signature

  1. Navigate to the organization section in the menu and switch to tab "Signatures".

  2. Simply create or edit a signature in the WYSIWYG editor. Variables are added directly into the text.

  3. Copy the public link to use in signature distribution

Supported variables

  • Graph_User_BusinessPhone

  • Graph_User_City

  • Graph_User_CompanyName

  • Graph_User_Country

  • Graph_User_Department

  • Graph_User_DisplayName

  • Graph_User_GivenName

  • Graph_User_Id

  • Graph_User_JobTitle

  • Graph_User_Mail

  • Graph_User_MobilePhone

  • Graph_User_FaxNumber

  • Graph_User_OfficeLocation

  • Graph_User_PostalCode

  • Graph_User_State

  • Graph_User_StreetAddress

  • Graph_User_Surname

  • Graph_User_onPremisesExtensionAttributes_extensionAttribute1

  • ...

  • Graph_User_onPremisesExtensionAttributes_extensionAttribute15

Distribute signature

  1. Search the RealmJoin Package Store for "RealmJoin Outlook Signature":

  1. Configure the package as described in the Technical Help and paste the copied URL to your template:

  1. The package provides several other options like distribution of multiple signatures, automatic renewal via task, setting of default signature etc.

If you are currently using the separate web app from or Azure Marketplace, you can easily migrate to native RealmJoin integration.

Please note that managing Enterprise Mode Site Lists is not possible via RealmJoin. Please migrate your lists to Microsoft 365 admin center before the following steps as describe in .

GitHub
Overview
M365 Workplace Cloud Storage
Publish enterprise site list to the cloud