Attributfunktionen

Übersicht

Um erweiterte Regelattribute zu konfigurieren, navigieren Sie in der Admin-Konsole zu „Verzeichnis > Attribute “. Ordnen Sie diese Attribute dann in der Anwendungskonfiguration zu, ähnlich wie bei der Zuordnung aller anderen Attributtypen.

Domänenobjekte

Der Begriff 'Domänenobjekte' ist ein Sammelbegriff, der alle möglichen Objekte umfasst, auf die in der angepassten Funktion eines Attributs zugegriffen werden kann.

Cloud Directory-Benutzer

Für jeden Benutzer, der sich anmeldet, Verify wird ein Benutzerkonto im Cloud Directory angelegt. Dieser Account wird als SCIM-Objekt dargestellt. In den folgenden Beispielen wird der folgende Cloud Directory-Benutzeraccount verwendet.

Das folgende SCIM-Objekt ist der Benutzeraccount.

{
  "id": "600000A3DD",
  "userName": "google-oauth2|1033116550041553242@jke.samlfed.com",
  "emails": [
    {
      "type": "work",
      "value": "jessica@jke.com"
    }
  ],
  "meta": {
    "created": "2019-04-26T09:21:35Z",
    "location": "https://jke.cloudidentity.com/v2.0/Users/600000A3DD",
    "lastModified": "2019-04-26T09:21:35Z",
    "resourceType": "User"
  },
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
    "urn:ietf:params:scim:schemas:extension:ibm:2.0:User"
  ],
  "name": {
    "formatted": "Jessica Hill",
    "familyName": "Hill",
    "givenName": "Jessica"
  },
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "manager": {
      "value": "6030101TP6"
    }
  },
  "urn:ietf:params:scim:schemas:extension:ibm:2.0:User": {
    "userCategory": "federated",
    "twoFactorAuthentication": false,
    "realm": "jke.samlfed.com",
    "unqualifiedUserName": "google-oauth2|1033116550041553242",
    "customAttributes": [
        { 
          "name": "car",
          "values": [ "Ford Mustang Mach-E", "Maruti Suzuki 800" ]
        },
        {
          "name": "hobbies",
          "values": [ "Reading", "Running", "Gaming", "Star Wars" ]
        }
    ]
  },
  "active": true
}

Hinweis: Im SCIM-Objekt sind zwei benutzerdefinierte Attribute definiert – car und hobbies. Diese Attribute sind Schemaerweiterungen, die über die Verwaltungskonsole konfiguriert werden können. Über die Verify Users-API können dem Benutzerobjekt Werte hinzugefügt werden.

Syntax	Beschreibung	Beispiele
user.$property	Zugriff auf $property. Sowohl . als auch [".."] kann verwendet werden.	user.name.familyName + ", " + user.name["givenName"] Ergebnis: Hill, Jessica
user.$values.filter(x, $condition)	$values: Eine Liste. Von der Funktion filter werden Werte basierend auf $condition extrahiert.	user.emails.filter(x, x.type == "work")[0].value Ergebnis: jessica@jke.com
user.getCustomValues($attrName)	Funktion zum Abrufen benutzerdefinierter Attributwerte als Liste. $attrName: Der Name des Attributs im Benutzerobjekt gibt „null“ zurück, wenn das Attribut nicht vorhanden ist.	user.getCustomValues("car") Ergebnis: ["Ford Mustang Mach-E","Maruti Suzuki 800"]
user.getCustomValue($attrName)	Funktion zum Abrufen des ersten Werts eines benutzerdefinierten Attributs in der Liste. $attrName: Der Name des Attributs im Benutzerobjekt. Gibt eine leere Zeichenkette („“) zurück, wenn das Attribut nicht vorhanden ist.	user.getCustomValue("hobbies") Ergebnis: Reading
user.getManager()	Funktion zum Abrufen der Vorgesetzteninformationen des aktuellen Benutzers. Die Funktion gibt den Benutzeraccount des Managers (als SCIM-Objekt) zurück. Wenn für den Benutzer kein Manager angegeben ist, wird ein leeres JSON-Objekt zurückgegeben. Wird ein Manager-Objekt zurückgegeben, kann es wie das Benutzerobjekt verwendet werden, d. h., die verschiedenen Funktionen können auf dieses Objekt angewendet werden.	user.getManager().name.formatted Ergebnis: Jacob Jones
user.getRoles()	Funktion zum Abrufen der Berechtigungen des aktuellen Benutzers. Die Funktion gibt die Liste der Berechtigungen des Benutzers als JSON-Objekt zurück. Wenn die Liste der Berechtigungen zurückgegeben wird, kann sie als JSON-Objekt verwendet werden.	user.getRoles().resources[0].name Ergebnis: Basic access
user.getFIDO2Registrations($search)	Funktion zum Abrufen der Registrierungen unter FIDO2 des aktuellen Benutzers. Die Funktion gibt die Liste der Registrierungen auf FIDO2 zurück, die zu dem Benutzer gehören. Suchparameter $search können optional angegeben werden. Die unterstützten Suchparameter finden Sie hier: https://docs.verify.ibm.com/verify/reference/getfidoregistrations_v20	user.getFIDO2Registrations("enabled=true").fido2[0].enabled Ergebnis: true
user.getFIDO2RegistrationByID($id)	Funktion zum Abrufen der Registrierung unter FIDO2 des aktuellen Benutzers mit der ID $id.	user.getFIDO2RegistrationByID("e8bf1dac-8245-452b-b7c4-8a700a1eb078").fido2[0].id Ergebnis: e8bf1dac-8245-452b-b7c4-8a700a1eb078
user.getDynamicGroups()	Funktion zum Abrufen der dynamischen Gruppen des aktuellen Benutzers. Die Funktion gibt die Liste der dynamischen Gruppen des Benutzers als JSON-Objekt zurück.	user.getDynamicGroups().resources[0].name Ergebnis : Security department manager

Funktionen zur Benutzerverwaltung

Die folgenden Funktionen stehen in CELx zur Verfügung, falls Lese-, Erstellungs- und Aktualisierungsvorgänge für Benutzer im Cloud-Verzeichnis durchgeführt werden müssen.

Der Rückgabewert dieser Funktionen ist ein Map-Objekt, wie unten definiert. Dies ermöglicht eine flexible Fehlerbehandlung in der CELx-Funktion. Eine leere Zeichenfolge für error bedeutet, dass der Vorgang erfolgreich war.

{
"result": <result of the operation>,
"error": <error message, in case of failures>
}

Syntax	Beschreibung	Beispiele
findUsers($filter)	Die Funktion gibt eine Liste der Benutzer zurück, die dem angegebenen Filter entsprechen. $filter: Zeichenfolge, die die Suchkriterien in dem in der GET-Users-API definierten Format festlegt. Für die Suchantwort gilt eine Obergrenze von 10 Benutzern. Wird kein passender Benutzer gefunden, wird eine leere Liste zurückgegeben.	findUsers('emails ew "@jke.com"')
findUsers($filter, $attributes)	Die Funktion gibt eine Liste der Benutzer zurück, die dem angegebenen Filter entsprechen. Jeder gefundene Nutzer gibt die Attribute zurück, die im $attributes Argument angegeben sind. $filter: Die Zeichenfolge, die die Suchkriterien definiert. $attributes: Das String-Array von „ scimNames “, das im Ergebnis zurückgegeben werden soll. Beachten Sie das Format der Abfrageparameter, das in der GET-Users-API definiert ist. Für die Suchantwort gilt eine Obergrenze von 10 Benutzern. Wird kein passender Benutzer gefunden, wird eine leere Liste zurückgegeben.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"])
findUsers($filter, $attributes, $count)	Die Funktion gibt eine Liste der Benutzer zurück, die dem angegebenen Filter entsprechen, wobei die maximale Anzahl auf $count begrenzt ist. Jeder gefundene Nutzer gibt nur die Attribute zurück, die im $attributes Argument angegeben sind. $filter: Die Zeichenfolge, die die Suchkriterien definiert. $attributes: Ein String-Array mit „ scimNames “, das im Ergebnis zurückgegeben werden soll. $count: Ganzzahl zur Angabe der maximalen Anzahl der zurückzugebenden Benutzer, maximal 10. Jeder Wert über 10 wird ignoriert und auf 10 gesetzt. Beachten Sie das Format der Abfrageparameter, das in der GET-Users-API definiert ist. Wird kein passender Benutzer gefunden, wird eine leere Liste zurückgegeben.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"], 3)
findUser($filter)	Die Funktion gibt einen einzelnen Benutzer zurück, der dem angegebenen Filter entspricht. $filter: Die Zeichenfolge, die die Suchkriterien in dem in der GET-Users-API definierten Format festlegt. Es wird ein Fehler zurückgegeben, wenn entweder mehrere Benutzer gefunden wurden oder kein Benutzer gefunden wurde.	findUser('emails eq "jessica@jke.com"')
findUser($filter, $attributes)	Die Funktion gibt einen einzelnen Benutzer zurück, der dem angegebenen Filter entspricht. Der Benutzer gibt nur die Attribute zurück, die im $attributes Argument angegeben sind. $filter: Zeichenfolge, die die Suchkriterien definiert. $attributes: Ein String-Array mit den „ scimNames “, die im Ergebnis zurückgegeben werden sollen. Beachten Sie das Format der Abfrageparameter, das in der GET-Users-API definiert ist. Es wird ein Fehler zurückgegeben, wenn entweder mehrere Benutzer gefunden wurden oder kein Benutzer gefunden wurde.	findUser('emails eq "jessica@jke.com"', ["emails", "name.givenName"])
getUser($uid)	Die Funktion gibt den Benutzer zurück, der mit dem angegebenen $uid... verknüpft ist. Es wird ein Fehler zurückgegeben, wenn der Benutzer nicht existiert.	getUser("504K8664N6")
createUser($m)	Die Funktion erstellt einen Benutzer mit den angegebenen Attributwerten. $m: Eine Zuordnung von Attribut-ID/Name und dem vom Benutzer gewünschten Wert. Die Attribut-IDs sind in der Antwort der GET-Attributes-API zu finden. Die ID und der Name des Attributs können synonym verwendet werden. Die email Attributwerte und username sind obligatorisch. Die übrigen Werte sind optional. Um das Passwort des neuen Benutzers festzulegen, fügen Sie in $m eine Eigenschaft mit dem Namen password und dem Passwort im Klartext als Wert ein. resultBei Erfolg wird das erstellte SCIM-Benutzerobjekt zurückgegeben.	createUser({'3':'jessica@jke.com', 'userName':'Jessica', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'Manager', 'hobbies':['Reading', 'Swimming'], '6': 'Jessica', '7': 'Doe'})
createUser($m, $opts)	Die Funktion erstellt einen Benutzer mit den angegebenen Attributwerten und zusätzlichen Optionen. $m: Eine Zuordnung von Attribut-ID/Name und dem vom Benutzer gewünschten Wert. $opts: Eine Übersicht über weitere Optionen, die bei der Erstellung eines Benutzers angegeben werden können. Die Attribut-IDs sind in der Antwort der GET-Attributes-API zu finden. Die ID und der Name des Attributs können synonym verwendet werden. Die email Attributwerte und username sind obligatorisch. Die übrigen Werte sind optional. Um das Passwort des neuen Benutzers festzulegen, fügen Sie eine Eigenschaft mit $m dem Namen password und dem Passwort im Klartext als Wert hinzu. Die folgenden Eigenschaften sind derzeit in $opts zulässig: notifyType : Diese Eigenschaft gibt den Typ der Benachrichtigung an, die an den Benutzer gesendet werden soll. Standardmäßig ist EMAIL. notifyPassword : Ein boolescher Wert, der angibt, ob das Passwort des Benutzers in der Benachrichtigung enthalten ist, die an den Benutzer gesendet wird. Standardmäßig ist true. NONEDieses Attribut gilt nicht, wenn notifyType auf gesetzt ist. notifyManager : Ein boolescher Wert, der angibt, ob der Vorgesetzte des Benutzers (sofern einer festgelegt ist) benachrichtigt werden soll, wenn das Passwort eines Benutzers festgelegt oder geändert wird. Der Standardwert lautet false. NONEDieses Attribut gilt nicht, wenn notifyType auf gesetzt ist. acceptInitialPassword : Wenn dieser Wert auf „true“ gesetzt ist, muss der Benutzer das Passwort bei der ersten Anmeldung nicht ändern. resultBei Erfolg wird das erstellte SCIM-Benutzerobjekt zurückgegeben.	createUser({'3':'jessica@jke.com', 'userName':'Jessica', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'Manager', 'hobbies':['Reading', 'Swimming'], '6': 'Jessica', '7': 'Doe'}, {'notifyType':'NONE', 'acceptInitialPassword': 'true'})
updateUser($uid, $m)	Die Funktion aktualisiert den angegebenen Benutzer mit den angegebenen Attributwerten. $uid: Die ID des zu aktualisierenden Benutzers. $m: Eine Zuordnung von Attribut-ID/Name und dem vom Benutzer gewünschten Wert. Die Attribut-IDs sind in der Antwort der GET-Attributes-API zu finden. Die ID und der Name des Attributs können synonym verwendet werden. Bei einer erfolgreichen Aktualisierung wird als Ergebnis eine Zeichenfolge zurückgegeben success . Das Benutzerobjekt wird nicht zurückgegeben.	updateUser('6050007SGF', {'3':'jessica@redbank.com', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'President', 'mobile_number': '502513585', 'work_country': 'Singapore'})

Identitätsquellenberechtigungsnachweis

VerifyWenn sich ein Benutzer bei anmeldet, werden die Anmeldeattribute der Identitätsquelle der Anmeldesitzung hinzugefügt und können in einer benutzerdefinierten Funktion abgerufen werden. Angenommen, der Benutzer meldet sich mit einem föderierten SAML-Identitätsprovider an und die SAML-Zusicherung enthält eine Attributanweisung mit dem Namen userRoles, für die marketing und helpdesk festgelegt ist.

Das Attribut idsuser ist als Zuordnung mit einem Zeichenfolgeschlüssel und einem Zeichenfolgearraywert verfügbar. Beispiel:

{
  "userRoles": ["marketing", "helpdesk"],
  "displayName": ["Jessica J. Hill"],
  "phone": ["+12324321234"],
  "employeeId": "eid1234"
}

Syntax	Beschreibung	Beispiele
idsuser.$property	Greifen Sie auf $property zu. Der Wert in idsuser ist immer ein Array aus Zeichenfolgen.	idsuser.userRoles[1] Ergebnis: helpdesk
idsuser.getValue($property)	Gibt den Wert von $property als Zeichenfolge zurück. Wenn der Wertebereich mehrere Einträge hat, wird der erste Eintrag zurückgegeben. Wenn $property nicht vorhanden ist, wird eine leere Zeichenfolge zurückgegeben.	idsuser.getValue('userRoles') Ergebnis: "Marketing"
idsuser.getValues($property)	Gibt alle Werte von $property als Zeichenfolgearray zurück. Wenn $property nicht vorhanden ist, wird ein nil-Objekt zurückgegeben.	idsuser.getValues('userRoles') Ergebnis: ["Marketing", "helpdesk]"

HTTP-Anforderungskontext

IBM VerifyWenn sich ein Benutzer bei anmeldet, kann in einer benutzerdefinierten Funktion auf den Kontext der eingehenden Anfrage „ HTTP “ zugegriffen werden. Wenn sich der Benutzer mit einem OAuth-Ablauf anmeldet und der Client Informationen zu client-ip und user-agent sendet, kann requestContext die Informationen extrahieren. Sie können an einen externen Endpunkt gesendet werden, um den Risikoscore für den Benutzer zu bestimmen.

requestContext ist als Zuordnung mit einem Zeichenfolgeschlüssel und einem Zeichenfolgearraywert verfügbar. Beispiel:

{
  "User-Agent": ["Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405"],
  "devicePlatform": ["MACOS"],
  "x-forwarded-for": ["116.15.12.181"]
}

Tabelle 1. HTTP Anforderungskontext

Syntax	Beschreibung	Beispiel
requestContext.$property	Greifen Sie auf $property zu. Der Wert in requestContext ist immer ein Array aus Zeichenfolgen.	requestContext.devicePlatform[1] Ergebnis: MACOS
requestContext.getValue($property)	Gibt den Wert von $property als Zeichenfolge zurück. Wenn der Wertebereich mehrere Einträge hat, wird der erste Eintrag zurückgegeben. Wenn $property nicht vorhanden ist, wird eine leere Zeichenfolge zurückgegeben.	requestContext.getValue('x-forwarded-for') Ergebnis: 116.15.12.181
requestContext.getValues($property)	Gibt alle Werte von $property als Zeichenfolgearray zurück. Wenn $property nicht vorhanden ist, wird ein Nullobjekt zurückgegeben.	requestContext.getValues('x-forwarded-for') Ergebnis: ["116.15.12.181"]

Attributkontext

Das Kontextobjekt enthält Schlüssel/Wert-Paare bestimmter Eigenschaften des Attributs, die beim Schreiben von Funktionen verwendet werden können. Die Werte dieser Eigenschaften sind nur im Kontext des Lookups dieses Attributs gültig. Auf dieses Objekt kann mit dem Schlüssel ctx zugegriffen werden.

Die folgenden Eigenschaften sind für das Kontextobjekt verfügbar:

Syntax	Beschreibung	Beispiele
ctx.currentValue	Zugriff auf den ausgewerteten Attributwert vor der Ausführung dieser Funktion. Der Datentyp dieses Werts ist in der Attributkonfiguration angegeben. Wenn der Wert nicht in den Datentyp umgesetzt werden kann, wird dieser Wert auf null gesetzt.	ctx.currentValue.toUpper

Standardoperatoren

user.name.givenName == "Jessica"

idsuser.myroles[0] == "marketing"

user.name.givenName == "Jessica" || user.name.formatted.startsWith("Hill")

1 == 1 && 2 == 2

user["name"]["givenName"]

"Hello" + " " + "World"

10 - 5

5 * 2

20 / 4

1 > 2

1 < 2

1 >= 1

1 <= 1

a == b ? true : false

Standardfunktionen

"helloworld".contains("hello")

"hello world".endsWith("old")

"foo".matches("k.*")

"hello".toUpper()

"HEllO".toLower()

"hello".base64Encode()

"aGVsbG8=".base64Decode()

"hello_world!".base64URLEncode()

"aGVsbG9fd29ybGQh".base64URLDecode()

"hello".size()

"hello".substring(1,4)

"hello".split("e")

"hello".replaceAll("l","p")

"some12#$text".matchAndReplaceAll("[^a-zA-Z]+", "-")

"hello".indexOf("l")

"hello".lastIndexOf("l")

["hello", "world"].size()

["hello", "world", "helios"].filter(x,
            x.startsWith("hel"))

["hello", "world", "helios"].all(x,
            x.contains("hel"))

["hello", "world", "helios"].exists(x,
            x.contains("hel"))

["hello", "world", "helios"].exists(x,
            x.contains("hel"))

["hello", "world", "helios"].map(x, x.toUpper())

stringToJson('[{\"hello\":\"world\"},{\"key\":\"value\"}]')

jsonToString(["hello","world","helios"])

joinStrings(['hello','world','helios'], ' + ')

[[1,2],["a","b","c"]].flatten()

{
idsuser: {
"attr1":"value1",
"attr2":"value2"
}
}

sha256('hello')

sha512('hello')

hmacSha1('hello','key')

base64ToHex('Gis8Tw==')

hexToBase64('1a2b3c4f')

base64URLEncodedToHex('Gis8TV5v')

hexToBase64URLEncoded('1a2b3c4d5e6f')

has({ "hello": "world" }.hello)

has({ "email.address": "abc@email.com"}, "email.address")

jsonToString({"hello":"world"})

stringToJson("{\"hello\":\"world\"}")

jsonToFormURLEncoded({'hello':'world', 'key1':'value 1'}, true)

{"hello": "world"}.put("key1",
    "value1")

{"hello": "world"}.putAll({"key1": "value1", "test":
      true})

{"hello": "world", "key1":
    "value1"}.remove("key1")

{"hello": "world", "key1": "value1", "test":
      true}.removeAll(["key1", "test"])

idsuser.exists(x, x == "ext:idsource_attr1")

now

timestamp(1629188698)

timestamp('2021-08-17T08:24:58Z').getDate()

timestamp('2021-08-17T08:24:58Z').getDayOfMonth()

timestamp('2021-08-17T08:24:58Z').getDayOfWeek()

timestamp('2021-08-17T08:24:58Z').getDayOfYear()

timestamp('2021-08-17T08:24:58Z').getMonth()

timestamp('2021-08-17T08:24:58Z').getFullYear()

timestamp('2021-08-17T08:24:58Z').getHours()

timestamp('2021-08-17T08:24:58Z').getMinutes()

timestamp('2021-08-17T08:24:58Z').getSeconds()

timestamp('2021-08-17T08:24:58.642Z').getMilliseconds()

int(timestamp('2021-08-17T08:24:58Z'))

timestamp('2021-08-17T08:24:58Z') + duration('3600s')

formatTime(timestamp('2021-08-17T08:24:58Z'), 'Monday, 02-Jan-06 15:04:05 MST')

encodeURI('test.html?name=Jürgen&car=audi')

decodeURI('test.html?name=J%C3%BCrgen&car=audi')

encodeURI('test.html?name=Jürgen&car=audi')

decodeURIComponent('test.html%3Fname%3DJ%C3%BCrgen%26car%3Daudi')

UUID-Funktionen

genUUID()

Typ- und Konvertierungsfunktionen

type(1234)

type("hello")

bool("true")

bool("FALSE")

bytes("Hello")

double(10)/4.0

double("3.14")

int(10.0/4)

int(3.14)

int("123")

int(now)

uint(3.14)

uint("123")

string(true)

string(1234)

string(b'helllo')

string(duration('1m100ms'))

string(now)

HTTP-Client

hc.Get("https://api.jke.com/resources/" + user.name.givenName, {"Authorization":"Some token"})

hc.GetAsString("https://api.jke.com/resources/" + user.name.givenName, {"Authorization":"Some token"})

hc.GetAsJson("https://api.jke.com/resources/" + user.name.givenName, {"Authorization":"Some token"}).value

hc.Post("https://api.jke.com/resources", {"Authorization": "Some token"}, "{\"key\":\"value\"}")

hc.Patch("https://api.jke.com/resources", {"Authorization": "Some token"}, "{\"key\":\"value\"}")

hc.Put("https://api.jke.com/resources", {"Authorization": "Some token"},
      "{\"key\":\"value\"}")

hc.Delete("https://api.jke.com/resources", {"Authorization": "Some token"})

hc.Opts({"certLabel": "jkeCA","insecure":false,
"tlsMinVersion":"TLSv1.2", "followRedirects":true,"cache":true,
"cacheExpiry":"1200"}).GetAsString(...)

Adaptives Risiko

Verwenden Sie Risikofunktionen für adaptiven Zugriff, um auf die aktuelle Risikostufe der Benutzersitzung und die zugehörigen Berechtigungsdaten zuzugreifen.

Eine Richtlinie für adaptiven Zugriff muss mindestens einmal in der Sitzung vor der Verwendung des angepassten Attributs ausgewertet werden, um sicherzustellen, dass die Daten gefüllt werden. Andernfalls wird der Wert “NOT_AVAILABLE” zurückgegeben.

Die Funktionen für adaptive Zugriffsrisiken ermöglichen den Zugriff auf die entsprechenden Bedingungen der Zugriffsrichtlinie, die im Richtlinien-Editor angezeigt werden, wie unter „Verwalten von Regeln für adaptive Zugriffsrichtlinien“ beschrieben.

Einzelheiten zu den Risikoindikatoren finden Sie unter „Risikoindikatoren “.

Die Schlüsselindikatoren der Risikodaten sind als JSON strukturiert und im folgenden Beispiel zu sehen. Auf diese JSON-Struktur kann mithilfe der Funktion risk.getAdaptiveSessionData() zugegriffen werden.

Der Zugriff auf die vollständige adaptive Risikodatenantwort, die sich auf die Benutzersitzung bezieht, kann über die Funktion risk.getRawAdaptiveSessionData() erfolgen.

{
  "riskLevel": "LOW", 
  "isNewDevice": false, 
  "isRiskyDevice": false, 
  "isRiskyConnection": false, 
  "remoteIP": "122.143.222.333", 
  "country": "ISR", 
  "city": "Jerusalem", 
  "isp": "013 Netvision", 
  "isNewLocation": false, 
  "behavioralAnomaly": false,
  "userBehavioralScore":"100"
}

risk.getAdaptiveSessionLevel()

risk.getAdaptiveSessionData()

"behavioralAnomaly":false, 
"city":"Bundall", 
"country":"AUS", 
"isNewDevice":false, 
"isNewLocation":false, 
"isRiskyConnection":false, 
"isRiskyDevice":false, 
"isp":"Network Technology (AUST) P/L", 
"remoteIP":"120.29.43.158", 
"riskLevel":"LOW",
"userBehavioralScore":"100"

risk.getAdaptiveSessionData().isRiskyDevice

risk.getAdaptiveSessionData().isp

 string(risk.getRawAdaptiveSessionData()[1].message.pinpoint_assessment.risk.risk_score)

 int(risk.getRawAdaptiveSessionData()[1].message.pinpoint_assessment.risk.risk_score) > 900

 risk.getRawAdaptiveSessionData()[1].message.pinpoint_assessment.risk.risk_score > 900.0

Anwendung

Für bestimmte Anwendungsfälle (Bereitstellung und Abgleich) steht das app Objekt in den CELx-Regeln zur Verfügung. Dieses Objekt repräsentiert das Anwendungs-JSON, das für die Kontosynchronisierung verwendet wird.

app.getSupportingData()

OAuth

oauth.GetBearerToken("https://api.jke.com/token", "123456-abcd-efgh-9876-q1w2e3r4t5y6", "secret")

JWT-Funktionen

jwt.sign({'key1': 'value1', 'auth': ['lval3', 'lval4'], 'iat': 1696567390}, {'alg':'RS256','kid':'cert1'})

Debug-Funktionen

Mit Debug-Funktionen kann ein Ausdruck ausgewertet und gleichzeitig ein Trace-Protokoll erstellt werden. Das Trace-Protokoll wird erstellt, wenn eine Regel im aktivierten Trace-Modus ausgeführt wird. Weitere Informationen zum Aktivieren des Trace-Modus und zum Anzeigen von Trace-Protokollen finden Sie unter „Trace-Einstellungen“ in den Abschnitten „Erstellen eines Flows“ und „Verwalten der Trace-Ansicht “.

debug("jessica@jke.com".split("@")[1], "The email domain is $value")

debug("jessica@jke.com".split("@")[1], "The email domain is $value", {"flow":
      "login", "time": string(now)})

Cache-Funktionen

Cache-Funktionen können genutzt werden, um den Cache im Rule-Dienst zu nutzen. Es gibt zwei Arten von Cache-Funktionen: sitzungsbasierte und nicht sitzungsbasierte. cacheDie sitzungsbasierten Cache-Funktionen verwenden session, während die nicht sitzungsbasierten Cache-Funktionen verwenden. Werte, die mithilfe der sitzungsbasierten Cache-Funktionen im Cache gespeichert werden, sind an eine Benutzersitzung gebunden.

Der Gesamt-Cache (Sitzungs- und Nicht-Sitzungs-Cache) unterliegt einer maximalen Größenbeschränkung. Dieses Limit kann je nach Konfiguration des Mieters variieren. Sobald der Cache voll ist, führen alle Versuche, einen Eintrag zum Cache hinzuzufügen, zu einem Fehler.

{
  "isSuccessful": true/false, //indicates if the operation was successful or not
  "value": "<string>", // the value obtained from the operation
  "errorID": "<string>", // the error ID if any
  "errorMessage": "<string>", // the error message if any
}

session.Set("computedID", "user1@web.com", "1200")

session.Get("computedID")

session.Delete("computedID")

session.Exists("computedID")

session.GetAndDelete("computedID")

cache.Set("companyName", "DunderMifflin", "1200")

cache.Get("companyName")

cache.Delete("companyName")

cache.Exists("companyName")

cache.GetAndDelete("companyName")

{"error":{"messageId":"CSIBU2000E","messageDescription":"The length of the
              key provided exceeds the character limit of [16]."}}}

{"error":{"messageId":"CSIBU2000E","messageDescription":The length of the
              value provided for the key [exampleKey] exceeds the character limit of
              [1000000]."}}}

{"result":{"errorID":"CSIBU2040E","errorMessage":"Failed to get a value from
              the cache with the key [exampleKey].","isSuccessful":false}}

{"error":{"messageId":"CSIBU2000E","messageDescription":"Cache limit has
              been exceeded."}}

Geheime Funktionen