# Workplace Cloud Storage

## Übersicht

Moderne Workplace-Geräte erhalten Richtlinien und Konfigurationen über Microsoft Intune. Einige dieser Einstellungen basieren auf Dateien, die per URL oder in speziellen Formaten wie JSON oder XML verfügbar sind. Diese RealmJoin-Funktion ist dafür gedacht, diese Dateien über eine einfach zu bedienende Oberfläche für Administratoren zu verwalten.

Derzeit werden die folgenden Typen unterstützt:

* Verwaltete Favoriten (Microsoft Edge und Google Chrome)
* Hintergründe und andere Dateien
* Outlook-Signaturen

Diese native Integration in RealmJoin macht die separate App (Azure Web App) von GitHub oder dem Azure Marketplace überflüssig: [M365 Workplace Cloud Storage](https://github.com/glueckkanja/gk-m365-workplacecloudstorage)

Die Funktion zur Verwaltung von Enterprise Mode Site Lists wird durch das Microsoft 365 admin center abgedeckt. Daher müssen vorhandene oder neue Site Lists wie hier beschrieben hinzugefügt werden: [Enterprise-Siteliste in die Cloud veröffentlichen](https://learn.microsoft.com/en-us/deployedge/edge-ie-mode-cloud-site-list-mgmt#publish-enterprise-site-list-to-the-cloud-1). Die resultierende Sitelisten-ID wird dann über eine Intune-Richtlinie an Microsoft Edge veröffentlicht.

## Einrichtung

{% hint style="info" %}
Bitte wenden Sie sich an den RealmJoin-Support, um diese Funktion für Ihren Tenant zu aktivieren.
{% endhint %}

### Storage Account erstellen

1. Diese Funktion erfordert einen Blob Storage in Azure. Bitte erstellen Sie einen neuen Storage Account:

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FKjLuRO4FX1pqFASDuA4Z%2Fimage.png?alt=media&#x26;token=9214ec21-5515-42bf-ab14-43569edf36d0" alt=""><figcaption></figcaption></figure>

2. Passen Sie die Einstellungen wie Name, Region und Redundanz an Ihre Anforderungen an.

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FNi7aftJ4vAR5jPtOxhWB%2Fimage.png?alt=media&#x26;token=fea7f15c-d6b9-4865-9348-0bde1f5f587e" alt=""><figcaption></figcaption></figure>

3. Die Einstellung "Allow enabling anonymous access on individual containers" muss aktiviert werden (Registerkarte "Advanced"). Dies ist erforderlich für gespeicherte Dateien wie Hintergründe, auf die anonym zugegriffen werden können muss

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FA5skb9EZQCfAUUJTrDel%2Fimage.png?alt=media&#x26;token=11100f64-b310-495e-8422-9ae4b8b38950" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Wenn die Einstellung "Allow enabling anonymous access on individual containers" beim Erstellen des Storage Account nicht aktiviert ist, zeigt RealmJoin den Fehler "Fehler beim Hochladen der Datei. Bitte versuchen Sie es erneut" an.\
Falls ja, wechseln Sie bitte zu "Settings" Ihres Storage Account und setzen Sie "Allow Blob anonymous access" auf "Enabled".
{% endhint %}

4. Wenn Sie keine besonderen Anforderungen haben, verwenden Sie bitte die Standardwerte für die anderen Registerkarten wie "Networking" und "Data protection".
5. Sobald die Erstellung erfolgreich abgeschlossen ist, gehen Sie bitte zum neuen Storage Account und navigieren Sie zu "Access keys". Bitte kopieren Sie die "Connection string" unter "key1":

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FU5RbRJyWcNYtCwnreVfi%2Fimage.png?alt=media&#x26;token=d7cf2013-ba2b-4c55-bcbf-cdcd11f3f5e1" alt=""><figcaption></figcaption></figure>

6. Zum RealmJoin-Portal navigieren (als Administrator)
7. Öffnen Sie die Einstellungen und wechseln Sie zur Registerkarte "Workplace cloud storage".&#x20;
8. Fügen Sie die zuvor kopierte Connection String in "Access key (Connection string) for Azure Storage account" ein und klicken Sie auf "Save":

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FZQi5TNFiIkpFMllqNAHB%2Fimage.png?alt=media&#x26;token=b3ea7f30-84f9-4821-8690-8526916d7784" alt=""><figcaption></figcaption></figure>

### Migration von der Azure Web App

Wenn Sie derzeit die separate Web-App von [GitHub](https://github.com/glueckkanja/gk-m365-workplacecloudstorage) oder dem Azure Marketplace verwenden, können Sie problemlos zur nativen RealmJoin-Integration migrieren.

{% hint style="warning" %}
Bitte beachten Sie, dass **die Verwaltung von Enterprise Mode Site Lists** ist **nicht möglich** über RealmJoin. Bitte **migrieren** Sie Ihre Listen zum Microsoft 365 admin center **vor den folgenden Schritten** wie hier beschrieben in [Übersicht](#overview).
{% endhint %}

#### Bestehenden Storage Account verbinden

Bitte navigieren Sie zu dem entsprechenden und bereits **vorhandenen Storage Account** und fügen Sie den Access Key zu RealmJoin hinzu (wie im vorherigen Abschnitt beschrieben). Anschließend werden Ihre vorhandenen Daten automatisch in RealmJoin angezeigt.

#### Bereinigung

Die Web-App (die das Admin-Portal bereitstellt) wird nicht mehr benötigt. Navigieren Sie daher zur Ressourcengruppe und löschen Sie die folgenden Ressourcen in Azure:

* App Service
* App Service Plan (mit dem App Service verbunden)

{% hint style="warning" %}
Achten Sie darauf, **nicht zu löschen** den **Storage Account**.
{% endhint %}

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FDgulvurcXKcYqYed4ylz%2Fimage.png?alt=media&#x26;token=8b57c44b-a3bf-49d8-8564-31c80e84d56c" alt=""><figcaption></figcaption></figure>

Bitte löschen Sie außerdem die veraltete Enterprise App in Entra ID (die Benennung kann abweichen):

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FI6U9J0cte7JH1AIgOYor%2Fimage.png?alt=media&#x26;token=585cafb6-86e1-4fe9-9450-101536668b9f" alt=""><figcaption></figcaption></figure>

## Favoriten

RealmJoin ermöglicht es Ihnen, mehrere Favoritenlisten über eine einfache UI hinzuzufügen und zu verwalten. Anschließend können sie in Formaten wie JSON oder XML exportiert oder kopiert werden.

1. Navigieren Sie im Hauptmenü zur Favoriten-Funktion und erstellen Sie eine neue Liste. Die neu erstellte Liste erhält eine ID, die Sie bei Bedarf ändern können (nur zur internen Identifizierung der entsprechenden Liste).&#x20;

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBJK4l6C9KbWltM3MT6Q5%2Fimage.png?alt=media&#x26;token=fe71a38f-8f67-44ed-9b4e-3732bcbcb2d9" alt=""><figcaption></figcaption></figure>

2. Fügen Sie gewünschte Links hinzu oder erstellen Sie Unterordner. Der Name des ersten Ordners (Standardname: "Favorites Bar") wird der Name des Ordners in der Favoritenleiste sein - für den Benutzer sichtbar (die meisten Kunden ändern dies in ihren Firmennamen).

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FUiMKGPOUyYiDTLc6mcj4%2Fimage.png?alt=media&#x26;token=8f31ab8c-d25a-4275-9e1f-af52735b1883" alt=""><figcaption></figcaption></figure>

3. Anschließend können Sie die Liste in verschiedenen Formaten exportieren:
   * JSON (Microsoft Edge oder Google Chrome unter Windows)
   * XML-Datei (Microsoft Edge oder Google Chrome unter macOS)
   * URL mit XML (Microsoft Edge Legacy)

### Microsoft Edge oder Google Chrome unter Windows

Erstellen Sie ein neues Katalogprofil mit der Einstellung "Configure favorites" und fügen Sie das JSON ein:

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FjjDkemAwtZo472LuQEx4%2Fimage.png?alt=media&#x26;token=9d4daa95-3efc-4790-a197-2b385ab7139e" alt=""><figcaption></figcaption></figure>

Für Google Chrome heißt die Einstellung "Managed Bookmarks".

### Microsoft Edge oder Google Chrome unter macOS

Erstellen Sie ein neues Konfigurationsprofil (Vorlage) vom Typ "Preference file". Geben Sie als "Preference domain name" "com.microsoft.Edge" ein. Laden Sie das über RealmJoin erzeugte XML hoch:

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Ft3PhLZo3gal4rae0ielw%2Fimage.png?alt=media&#x26;token=047a3e75-9d3e-4123-9e07-c84dfda65553" alt=""><figcaption></figcaption></figure>

Für Google Chrome setzen Sie "Preference domain name" auf "com.google.chrome" und verwenden Sie das entsprechende XML. Der einzige Unterschied zwischen dem XML von Microsoft Edge und Google Chrome ist die erste Zeile:

```
<key>ManagedBookmarks</key> statt <key>ManagedFavorites</key>
```

## Hintergründe und andere Dateien

Navigieren Sie im Menü zum Organisationsbereich. Wechseln Sie zur Registerkarte "Backgrounds" oder "Other Files". Laden Sie nun einfach die gewünschten Dateien hoch (Hintergrundbilder, Konfigurationsdateien, öffentliche Zertifikate usw.). Sie werden dem Blob Storage hinzugefügt und erhalten öffentlich zugängliche URLs. Verwenden Sie diese URLs in Ihren Konfigurationsprofilen (z. B. Hintergrundbild per Intune festlegen), Skripten usw.

{% hint style="warning" %}
Laden Sie **keine sensiblen Dateien hoch** da sie über öffentliche URLs erreichbar werden.
{% endhint %}

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FxS3EwKyWY1HIbCXGCq4e%2Fimage.png?alt=media&#x26;token=44b34877-a1d5-40b9-9217-24448e36dc59" alt=""><figcaption></figcaption></figure>

## Outlook-Signaturen

Diese Funktion ermöglicht es Ihnen, Vorlagen für Outlook-Signaturen hinzuzufügen. In Verbindung mit einem RealmJoin-Softwarepaket (nur Windows) wird die gewünschte Vorlage auf Ihre verwalteten Clients heruntergeladen und zu Outlook Desktop hinzugefügt. Darüber hinaus können Sie der Vorlage Variablen hinzufügen, die durch Benutzereigenschaften ersetzt werden (wie Name, E-Mail, Berufsbezeichnung oder Telefonnummer).

### Signatur erstellen oder bearbeiten

1. Navigieren Sie im Menü zum Organisationsbereich und wechseln Sie zur Registerkarte "Signatures".&#x20;
2. Erstellen oder bearbeiten Sie einfach eine Signatur im WYSIWYG-Editor. Variablen werden direkt in den Text eingefügt.
3. &#x20;Den öffentlichen Link kopieren, um ihn für die Signaturverteilung zu verwenden

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FGQl1rPPtC11CXkNZgrMB%2Fimage.png?alt=media&#x26;token=09bd2fca-7dc3-407e-b8f6-b2a01ab6b7f8" alt=""><figcaption></figcaption></figure>

#### Unterstützte Variablen

* 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

### Signatur verteilen

1. Durchsuchen Sie den RealmJoin Package Store nach "RealmJoin Outlook Signature":

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F4izvUMdILlTpSVVDRicw%2Fimage.png?alt=media&#x26;token=b50985bc-e3f5-4252-b20a-fa64e00d7683" alt=""><figcaption></figcaption></figure>

2. Konfigurieren Sie das Paket wie in der Technischen Hilfe beschrieben und fügen Sie die kopierte URL in Ihre Vorlage ein:

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FmHRPCrLTRlj8Cn0nAmhY%2Fimage.png?alt=media&#x26;token=29149eec-deca-4c73-956b-c06fa06ae868" alt=""><figcaption></figcaption></figure>

3. Das Paket bietet mehrere weitere Optionen wie die Verteilung mehrerer Signaturen, automatische Erneuerung per Task, Festlegen einer Standardsignatur usw.