Ausführung der Konnektoren¶

Es gibt mehrere Methoden, eine Bereitstellungssequenz auszuführen:

über Batch- oder PowerShell-Dateien mit Befehlszeilen, die die ausführbare Datei HPPRunCli aufrufen
über die Oberfläche zur Verwaltung der Jobs
über die SIP-Webdienste

Bereitstellungssequenzen mit HPPRUNCLI.exe ausführen¶

In einer Batch- oder PowerShell-Datei ist die ausführbare Datei HppRunClie.exe aufzurufen, gefolgt von den folgenden Optionen:

Optionen	Funktion	Pflicht (Y/N)
-sec [Sequence Name]	Option, mit der die auszuführende Sequenz angegeben wird.	Y
-cfg [Config_file_name]	Option, mit der die zu verwendende Konfigurationsdatei angegeben wird.	N. Standardmäßig wird die Datei hpp.ini verwendet.
-obj [Val_attribute1\|Val_attribute2\|…]	Option, mit der der Wert des Abgleichsattributs angegeben wird, um die Sequenz einzeln auszuführen. Sind mehrere Attributwerte anzugeben, müssen sie in der Reihenfolge aufgeführt werden, in der die Exporte auszuführen sind.	N
-seq [Directory_nm]	Option, mit der der Name des Ausgabeverzeichnisses der Protokolldateien angegeben wird.	N

Bereitstellungssequenzen über die Oberfläche zur Verwaltung der Jobs ausführen¶

Von der Seite zur Einsicht der Job-Instanzen der Bereitstellungssequenzen aus lässt sich ein Job einzeln oder in großer Zahl ausführen.

Um einen Job in großer Zahl zu starten, klicken Sie auf die Schaltfläche „“.

Wählen Sie den oder die gewünschten Jobs aus und klicken Sie dann auf „Validate“, um die Jobs in die Warteschlange zu stellen.

Um einen Job einzeln zu starten, klicken Sie auf die Schaltfläche „“.

Wählen Sie den gewünschten Job aus und geben Sie dann den Wert ein, mit dem das Objekt ausgewählt wird, auf dem der Job ausgeführt werden soll.

Achtung: Enthält der Job derzeit mehrere Sequenzen, muss das Abgleichsattribut in allen Sequenzen denselben Wert haben, damit er im Einzelmodus ausgeführt werden kann.

Bereitstellungssequenzen über die SIP-Webdienste ausführen¶

Beispiel für ein Skript, das einen Bereitstellungsjob über ein PowerShell-Skript ausführt:

$urlGenToken = "https://[URL_serveur_SID]:44350/connect/token"
$BodyJsonPostToken = "grant_type=password&client_id=sip&client_secret=sip&username=[login_cpt]&password=[mot_de_passe_compte]"
$MonHeader = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "[URL_serveur_SID]:44350"
    }

$MonHeaderReq = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "[URL_serveur_SID]:44350"
        "Authorization" = "Bearer $($token_gen)" 
    }

try {

    $result = Invoke-RestMethod -Uri $urlGenToken -Method Post -Headers $MonHeader -Body $BodyJsonPostToken 
    $token_gen = $result.access_token
    #ajouter logs
}
catch {
    $token_gen = ""
    #ajouter logs
}

if ($token_gen -ne "")
{
    $job_code = [code_du_job_à_exécuter]
    $MonHeaderReq = @{
        "Content-Type" = "application/x-www-form-urlencoded"
        "accept" = "Application/Json"
        "Host" = "sid.iam-test.ght49.intra:44355"
        "Authorization" = "Bearer $($token_gen)"
    }
    $urlExecutionJob="https://sid.iam-test.ght49.intra:44355/scim/v2/job/run/$job_code"

    try {
        $res = Invoke-RestMethod -Uri $urlExecutionJob -Method Post -Headers $MonHeaderReq  
        #ajouter logs
    }
    catch {
        #ajouter logs et traitement
    }
}

Um einen wegen einer Importschwelle angehaltenen Bereitstellungsjob über ein PowerShell-Skript fortzusetzen, ist ebenso die Kennung der Job-Instanz abzurufen, indem die Route /scim/v2/job-instance/ aufgerufen wird (Methode GET).

Weitere Angaben finden Sie in der Swagger-Dokumentation: https://[SIP_Server_URL]:44355/swagger/

Den neuen Konnektor der vorgelagerten Einspeisung ausführen (ab 7.0 SP3)¶

Ab der Version 7.0 SP3 lassen sich Identitäten über einen neuen Konnektor der vorgelagerten Einspeisung Rollen und/oder Berechtigungen zuweisen.

Die Verknüpfungen Identitäten – Rollen und Identitäten/Rollen – Berechtigungen, die aus einer autoritativen Quelle erstellt und/oder gelöscht werden, verwaltet ein neuer Verknüpfungstyp in der Datenbank. Der Export der Verknüpfungen Identitäten – Rollen und Identitäten/Rollen – Berechtigungen aus dem Identity-Repository gibt daher nur die von SIP zugewiesenen Rollen und Berechtigungen zurück.

Einen Verknüpfungskonnektor Identitäten - Rollen konfigurieren¶

Um einen Verknüpfungskonnektor Identitäten - Rollen zu konfigurieren, ist mindestens Folgendes anzulegen:

Ein Export aus einer autoritativen Quelle, der die folgenden Angaben enthalten muss:
UID der Identität (erforderlich)
- Code der zuzuweisenden Rolle (erforderlich) – einzelner Wert.
- Anfangsdatum der Rolle (optional)
- Enddatum der Rolle (optional)
Ein Export des Identity-Repositorys des Typs PERSON_ROLES, in dem die Personentypen und die Codes der Repositorys anzugeben sind, für die die Verknüpfungen Identität-Rolle erstellt werden sollen.
Eine Synchronisierungsregel, um die Vorgänge Matching, Erstellung, Änderung und Löschung festzulegen
- Vergleichen Sie in der Matching-Regel die UID der Identität und den Code der Rolle
- In der Erstellungsregel sind die UID der Identität und der Code der Rolle zwingend anzugeben. Anfangs- und Enddatum sind optional
- In der Änderungsregel ist die ID der Verknüpfung Person-Rolle zwingend anzugeben, entnommen aus dem Export des Identity-Repositorys. Änderbar sind nur die Datumsangaben
- In der Löschregel ist die ID der Verknüpfung Person-Rolle zwingend anzugeben, entnommen aus dem Export des Identity-Repositorys.
- Syntax der Identity-Codes, die in den Synchronisierungsregeln zu verwenden sind:
  - person = UID der Identität
  - role = Code der Rolle
  - startdate = Anfangsdatum der Rolle
  - enddate = Enddatum der Rolle
  - id = ID der Verknüpfung Identität-Rolle (Feld id der Tabelle sid.PersonRoles)
Ein Import in das Identity-Repository des Typs PERSON_ROLES. Sie können die Option zum Deaktivieren der laufenden Kontenberechnung aktivieren, um die Importdauer bei großen Datenmengen zu beherrschen. Wurde die Option aktiviert, ist ein Import ACCOUNTCALC durchzuführen, um die Konten des betroffenen Repositorys neu zu berechnen.

Einen Verknüpfungskonnektor Identitäten - Rollen konfigurieren¶

Ein Export aus einer autoritativen Quelle, der die folgenden Angaben enthalten muss:
- UID der Identität (erforderlich)
- Code der Rolle (erforderlich) – einzelner Wert.
- Code der Berechtigung, die der Verknüpfung Identität/Rolle zuzuweisen ist (erforderlich) – einzelner Wert
- Anfangsdatum der Berechtigung (optional)
- Enddatum der Berechtigung (optional)

Achtung

Die Verknüpfung Identität/Rolle muss bereits bestehen, damit der Verknüpfungskonnektor Identität/Rolle – Berechtigungen ordnungsgemäß funktioniert

Ein Export des Identity-Repositorys des Typs PERSON_RIGHTS, in dem die Personentypen und die Codes der Repositorys anzugeben sind, für die die Verknüpfungen Identität/Rolle-Berechtigung erstellt werden sollen.
Eine Synchronisierungsregel, um die Vorgänge Matching, Erstellung, Änderung und Löschung festzulegen
- Vergleichen Sie in der Matching-Regel die UID der Identität, den Code der Rolle und den Code der Berechtigung.
- In der Erstellungsregel sind die UID der Identität, der Code der Rolle und der Code der Berechtigung zwingend anzugeben. Anfangs- und Enddatum sind optional
- In der Änderungsregel ist die ID der Verknüpfung Person/Rolle - Berechtigung zwingend anzugeben, entnommen aus dem Export des Identity-Repositorys. Änderbar sind nur die Datumsangaben.
- In der Löschregel ist die ID der Verknüpfung Person/Rolle - Berechtigung zwingend anzugeben, entnommen aus dem Export des Identity-Repositorys.
- Syntax der Identity-Codes, die in den Synchronisierungsregeln zu verwenden sind:
- person = UID der Identität
  - role = Code der Rolle
  - right = Code der Berechtigung
  - startdate = Anfangsdatum der Berechtigung
  - enddate = Enddatum der Berechtigung
- id = ID der Verknüpfung Identität-Rolle-Berechtigung (Feld id der Tabelle sid.PersonRights)
Ein Import in das Identity-Repository des Typs PERSON_RIGHTS. Sie können die Option zum Deaktivieren der laufenden Kontenberechnung aktivieren, um die Importdauer bei großen Datenmengen zu beherrschen. Wurde die Option aktiviert, ist ein Import ACCOUNTCALC durchzuführen, um die Konten des betroffenen Repositorys neu zu berechnen.