SCIM2ClientUtil: Bereichsbezogen

Die SCIM2ClientUtil- API bietet Dienstprogrammmethoden, um die eindeutigen Bezeichner von externen Anbietersystemen abzurufen und diese Informationen dann beim Aufrufen der SCIM2Client- API zu verwenden.

Diese API wird im Namespace sn_auth ausgeführt und erfordert die Installation des Plugins „SCIM v2 - ServiceNow Cross-domain Identity Management Client“ (com.snc.integration.scim2.client), um auf die API zugreifen zu können.

Weitere Informationen zu SCIM finden Sie unter System für domänenübergreifendes Identitätsmanagement (SCIM).

SCIM2ClientUtil - getProviderIdByFilter(String provider, String resourceName, String filter)

Gibt den eindeutigen Bezeichner einer angegebenen Ressource aus einem angegebenen externen Anbietersystem für eine eindeutige Ressourcen-ID in einer Instanz ServiceNow mithilfe eines Filterausdrucks zurück, um die gewünschte Ressource zu beschreiben.

Diese API ist nützlich beim Zuordnen von ServiceNow -Feldern zu SCIM-Feldern, bei denen der Ressourcenbezeichner im externen Anbietersystem benötigt wird. Vor dem Aufrufen dieser Methode muss ein eindeutiges Feld für die Ressource in der Systemattributzuordnung definiert werden, die sich in der Tabelle „SCIM-Provider-Ressourcenzuordnung“ [sys_scim_provider_resource_mapping ] befindet.

Weitere Informationen zur Zuordnung von Anbieterressourcen finden Sie unter Create a SCIM Provider Resource Mapping.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Anbieter	Zeichenfolge	Name des konfigurierten SCIM-Service Providers Tabelle: Im Namensfeld der Tabelle „SCIM-Provider“ [sys_scim_provider].
resourceName	Zeichenfolge	Name des Ressourcentyps, z. B. Benutzer oder Gruppe. Tabelle: Im Feld resource_name der Tabelle „SCIM-Provider-Ressourcenzuordnung“ [sys_scim_provider_resource_mapping]
filter	Zeichenfolge	Filterausdruck, der auf die zurückgegebenen Ergebnisse angewendet werden soll. Weitere Informationen zu den verfügbaren Filterparametern und dem zugehörigen Format finden Sie im folgenden Abschnitt im Dokument der Internet Engineering Task Force: System für domänenübergreifendes Identitätsmanagement: Protokoll https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2.2

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Eindeutiger Ressourcenbezeichner, der vom externen Service Provider verwendet wird. Löst eine Ausnahme aus, wenn beim Abrufen der Informationen ein Problem auftritt.

Das folgende Beispiel zeigt, wie der Ressourcenbezeichner des Anwenders mit dem Filter 'username eq "abel.tuter" abgerufen wird.

var response = sn_auth.SCIM2ClientUtil.getProviderIdByFilter('SNOW Provider','User','username eq "abel.tuter"'); 
gs.info('response: ' + response);

Ausgabe:

 "005d500b536073005e0addeeff7b12f4

Das folgende Beispiel zeigt, wie Sie ein Skript verwenden, um den Ressourcenbezeichner des Managers mithilfe des Filters 'userName eq "' + manager + '"' abzurufen.

(function getValue(resourceGR) {
  try {
    var manager = resourceGR.manager.user_name;
    return sn_auth.SCIM2ClientUtil.getProviderIdByFilter('SCIM Provider Demo', 'User', 'userName eq "' + manager + '"');
  } catch (e) {
    gs.error('Unable to get attribute value using script' + e);
    // Handle failure scenario here
  }
})(resourceGR);

Ausgabe:

  "125d500b535973005e0addeeff8c12a2"

SCIM2ClientUtil - getProviderIdByResourceId(Zeichenfolge provider, Zeichenfolge resourceName, Zeichenfolge resourceId)

Gibt den eindeutigen Bezeichner einer angegebenen Ressource aus einem angegebenen externen Anbietersystem für eine eindeutige Ressourcen-ID in einer ServiceNow -Instanz zurück.

Diese API ist nützlich beim Zuordnen von ServiceNow -Feldern zu SCIM-Feldern, bei denen der Ressourcenbezeichner im externen Anbietersystem benötigt wird. Vor dem Aufrufen dieser Methode muss ein eindeutiges Feld für die Ressource in der Systemattributzuordnung definiert werden, die sich in der Tabelle „SCIM-Provider-Ressourcenzuordnung“ [sys_scim_provider_resource_mapping] befindet.

Weitere Informationen zur Zuordnung von Anbieterressourcen finden Sie unter Ressourcenzuordnung für SCIM-Anbieter erstellen.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Anbieter	Zeichenfolge	Name des konfigurierten SCIM-Service Providers Tabelle: Im Namensfeld der Tabelle „SCIM-Provider“ [sys_scim_provider].
resourceName	Zeichenfolge	Name des Ressourcentyps, z. B. Benutzer oder Gruppe. Tabelle: Im Feld resource_name der Tabelle „SCIM-Provider-Ressourcenzuordnung“ [sys_scim_provider_resource_mapping]
resourceId	Zeichenfolge	Sys_id der in der Instanz ServiceNow (dem Client) gespeicherten Ressource. Tabelle: Im Feld primary_table der Tabelle „SCIM-Provider-Ressourcenzuordnung“ [sys_scim_provider_resource_mapping]

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Eindeutiger Ressourcenbezeichner, der vom externen Service Provider verwendet wird. Löst eine Ausnahme aus, wenn beim Abrufen der Informationen ein Problem auftritt.

Das folgende Beispiel zeigt, wie Sie den Ressourcenbezeichner des Benutzers mit der sys_id f282abf03710200044e0bfc8bcbe5d12 abrufen.

var response = sn_auth.SCIM2ClientUtil.getProviderIdByResourceId('SNOW Provider','User','f282abf03710200044e0bfc8bcbe5d12'); 
gs.info('response: ' + response);

Ausgabe:

  "005d500b536073005e0addeeff7b12f4"