Workplace Cloud Storage

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: M365 Workplace Cloud Storage

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: Publish enterprise site list to the cloud. 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

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

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

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".

If you don't have any special requirements please use the default values for the other tabs like "Networking" and "Data protection".
Once created successfully, please go to the new storage account and navigate to "Access keys". Please copy the "Connection string" under "key1":

Navigate to RealmJoin Portal (as administrator)
Open settings and switch to the tab "Workplace cloud storage".
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

If you are currently using the separate web app from GitHub 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 Overview.

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.

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).

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).

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

Navigate to the organization section in the menu and switch to tab "Signatures".
Simply create or edit a signature in the WYSIWYG editor. Variables are added directly into the text.
Copy the public link to use in signature distribution