|
Benötigte Berechtigungen: IT-Admin |
|
Zur Erstellung der App-Registrierung in Microsoft Entra ID wird ein Paket bereitgestellt, das eine Einrichtung über ein Skript ermöglicht und diesen Prozess automatisiert. Das Paket beinhaltet zwei PowerShell-Skripte – ein Skript zur Erstellung der App-Registrierung und ein optionales Skript, das nur ausgeführt wird, wenn empower® Mails Online eingerichtet werden soll. Die dritte Datei ist eine Konfigurationsdatei, die dazu verwendet wird, wichtige Parameter für das Registrierungs-Skript im Voraus festzulegen, um den Prozess zu beschleunigen. |
|
|
Das Paket kann unter folgendem Link heruntergeladen werden: |
|
|
Insgesamt enthält das Paket die folgenden drei Dateien: |
|
|
Anmerkung
Die PowerShell-Skripte sind mit dem Microsoft Graph PowerShell Module Version 2.1.9.0 kompatibel.
|
Die Datei ist wichtig für den Aufbau des Skripts. Sie enthält wichtige Informationen zur Konfiguration. |
Anmerkung
Wenn Sie das Paket heruntergeladen haben, können Sie Datei selbst Ihren Anforderungen entsprechend vorbereiten.
|
Der Inhalt der Konfigurationsdatei sieht wie folgt aus: |
|
{
"tenantID": "Tenant ID from Entra ID"
"appName": "empower",
"hostname": "https://",
"useMailsOnline": false,
"useSCIM": false,
"oneTimePasswordServiceUri": "https://oneoffsecret.com/"
}
|
|
|
Die Werte werden wie folgt definiert: |
|
|
Anmerkung
Wenn Sie nicht in der empower® Cloud hosten, müssen Sie vor Ausführung des Skripts alle erforderlichen Informationen (Tenant ID, Basis-URL) selbst einsammeln.
|
Um das PowerShell-Skript ausführen zu können, müssen die folgenden Voraussetzungen erfüllt sein: |
|
|
|
|
Um das Skript über PowerShell auszuführen, gehen Sie wie folgt vor: |
|
|
|
|
Die App-Registrierung kann dann im Tab App-Registrierungen im Azure-Portal eingesehen werden. |
Wichtig
Das Einmal-Passwort für das Client Secret ist nur einmal sichtbar und der Link läuft nach einem Monat ab.
Speichern Sie das Client Secret sicher ab.
Wichtig
Die Einstellung useSCIM wird aus der Konfigurationsdatei nur ausgelesen. Im Skript selbst werden Sie nicht gefragt, ob Sie SCIM verwenden möchten.
Die Einstellung wird verwendet, um die Berechtigungen zu definieren, die der App-Registrierung erteilt werden.
Zusätzlich müssen Sie weitere manuelle Änderungen an der App-Registrierung vornehmen, nachdem diese erstellt wurde.
Für weitere Informationen siehe SCIM in Microsoft Entra ID einrichten.
Anmerkung
Wenn die Datei config.json im Voraus nicht an Ihre Anforderungen angepasst wurde, müssen Sie alle Werte manuell eingeben.
|
Um das Skript über Cloud Shell auszuführen, gehen Sie wie folgt vor: |
|
|
|
|
Die App-Registrierung kann dann im Tab App-Registrierungen im Azure-Portal eingesehen werden. |
Wichtig
Das Einmal-Passwort für das Client Secret ist nur einmal sichtbar und läuft nach einem Monat ab.
Speichern Sie das Client Secret sicher ab.
Anmerkung
Wenn Sie die Datei config.json nicht hochladen oder sie im Voraus nicht an Ihre Anforderungen angepasst wurde, müssen Sie alle Werte manuell eingeben.
|
Wenn Sie in der empower® Cloud hosten, müssen Sie dem empower® Support Team weitere Informationen zur Verfügung stellen. Schicken Sie dem empower® Support hierfür die Datei AppRegistrationInfo.json. Zusätzlich zu den Informationen aus der Datei AppRegristrationInfo.json, stellen Sie nach Einrichtung der App-Registrierung dem empower® Support Team die folgenden Informationen zu Verfügung: |
|
|
Anmerkung
Sie erhalten von empower® eine Erinnerung bevor Ihr Client Secret abläuft.
Anmerkung
Für weitere Informationen zur Erstellung von Benutzergruppen in Microsoft Entra ID siehe Verwalten von Microsoft Entra-Gruppen und -Gruppenmitgliedschaften.
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.