Fonctions d'attribut

Présentation

Pour configurer les attributs avancés des règles, accédez à Répertoire > Attributs dans la console d'administration. Mettez ensuite en correspondance ces attributs dans la configuration de l'application, comme vous le feriez pour tous les autres types d'attributs.

Pour plus d'informations et d'exemples sur l'utilisation des codes de fonction dans les workflows avancés, consultez les guides d'orchestration.

Objets de domaine

Le terme, objets de domaine, est une phrase fourre-tout permettant d'indiquer tous les objets possibles accessibles dans une fonction personnalisée d'un attribut.

Utilisateur Cloud Directory

Pour chaque utilisateur qui s'authentifie, Verify un compte utilisateur est créé dans Cloud Directory. Ce compte est représenté sous la forme d'un objet SCIM. Dans les exemples suivants, le compte utilisateur Cloud Directory suivant est utilisé.

L'objet SCIM suivant est le compte utilisateur.

{
  "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
}

Remarque : dans l'objet SCIM, deux attributs personnalisés sont définis : car et hobbies. Ces attributs sont des extensions de schéma qui peuvent être configurées via la console d'administration. Des valeurs peuvent être ajoutées à l'objet utilisateur via l'API Verify Users.

Syntaxe	Descriptif	Exemples
user.$property	Accédez à $property. . et [".."] peuvent être utilisés.	user.name.familyName + ", " + user.name["givenName"] Résultat : Hill, Jessica
user.$values.filter(x, $condition)	$values : Une liste. La fonction filter extrait des valeurs basées sur $condition.	user.emails.filter(x, x.type == "work")[0].value Résultat : jessica@jke.com
user.getCustomValues($attrName)	Fonction permettant d'obtenir les valeurs d'attributs personnalisés sous forme de liste. $attrName: Le nom de l'attribut dans l'objet utilisateur renvoie la valeur null si cet attribut n'existe pas.	user.getCustomValues("car") Résultat : ["Ford Mustang Mach-E","Maruti Suzuki 800"]
user.getCustomValue($attrName)	Fonction permettant d'obtenir la première valeur d'attribut personnalisé de la liste. $attrName: Nom de l'attribut dans l'objet utilisateur. Renvoie une chaîne vide (« ») si l'attribut n'existe pas.	user.getCustomValue("hobbies") Résultat : Reading
user.getManager()	Fonction permettant d'obtenir les informations relatives au responsable de l'utilisateur actuel. La fonction renvoie le compte utilisateur du responsable (sous la forme d'un objet SCIM). Si aucun responsable n'est spécifié pour l'utilisateur, un objet JSON vide est renvoyé. Si un objet gestionnaire est renvoyé, il peut être utilisé comme l'objet utilisateur, c'est-à-dire que les différentes fonctions peuvent être appelées sur cet objet.	user.getManager().name.formatted Résultat : Jacob Jones
user.getRoles()	Fonction permettant d'obtenir les droits de l'utilisateur actuel. La fonction renvoie la liste des droits de l'utilisateur sous la forme d'un objet JSON. Si la liste des droits est renvoyée, elle peut être utilisée comme un objet JSON.	user.getRoles().resources[0].name Résultat : Basic access
user.getFIDO2Registrations($search)	Fonction permettant d'obtenir les inscriptions à FIDO2 de l'utilisateur actuel. La fonction renvoie la liste des inscriptions sur FIDO2 attribuées à l'utilisateur. Il est possible de fournir des paramètres $search de recherche. Vous trouverez ici la liste des paramètres de recherche pris en charge : https://docs.verify.ibm.com/verify/reference/getfidoregistrations_v20	user.getFIDO2Registrations("enabled=true").fido2[0].enabled Résultat : true
user.getFIDO2RegistrationByID($id)	$idFonction permettant d'obtenir les informations d'inscription sur FIDO2 de l'utilisateur actuel dont l'identifiant est.	user.getFIDO2RegistrationByID("e8bf1dac-8245-452b-b7c4-8a700a1eb078").fido2[0].id Résultat : e8bf1dac-8245-452b-b7c4-8a700a1eb078
user.getDynamicGroups()	Fonction permettant d'obtenir les groupes dynamiques de l'utilisateur actuel. La fonction renvoie la liste des groupes dynamiques de l'utilisateur sous la forme d'un objet JSON.	user.getDynamicGroups().resources[0].name Résultat : Security department manager

Fonctions de gestion des utilisateurs

Les fonctions suivantes sont disponibles dans CELx lorsqu'il est nécessaire d'effectuer des opérations de lecture, de création et de mise à jour sur les utilisateurs du Cloud Directory.

Ces fonctions renvoient un objet « map » tel que défini ci-dessous. Cela offre une certaine souplesse pour la gestion des erreurs dans la fonction CELx. error Une chaîne vide signifie que l'opération s'est déroulée avec succès.

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

Syntaxe	Descriptif	Exemples
findUsers($filter)	La fonction renvoie une liste des utilisateurs qui correspondent au filtre indiqué. $filter: Chaîne de caractères définissant les critères de recherche selon le format spécifié dans l'API GET Users. Le nombre d'utilisateurs dans la réponse à la recherche est limité à 10. Si aucun utilisateur n'a été trouvé, une liste vide est renvoyée.	findUsers('emails ew "@jke.com"')
findUsers($filter, $attributes)	La fonction renvoie une liste des utilisateurs qui correspondent au filtre indiqué. Chaque utilisateur correspondant renvoie les attributs spécifiés dans l'argument $attributes . $filter: La chaîne de caractères qui définit les critères de recherche. $attributes: Le tableau de chaînes de caractères de type « scimNames » qui doit être renvoyé dans le résultat. Reportez-vous au format des paramètres de requête défini dans l'API GET Users. Le nombre d'utilisateurs dans la réponse à la recherche est limité à 10. Si aucun utilisateur n'a été trouvé, une liste vide est renvoyée.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"])
findUsers($filter, $attributes, $count)	La fonction renvoie une liste d'utilisateurs correspondant au filtre indiqué, dans la limite de $count. Chaque utilisateur correspondant ne renvoie que les attributs spécifiés dans l'argument $attributes . $filter: La chaîne de caractères qui définit les critères de recherche. $attributes: Un tableau de chaînes de caractères contenant les « scimNames » à renvoyer dans le résultat. $count: Nombre entier permettant de spécifier le nombre maximal d'utilisateurs à renvoyer, avec une limite de 10. Toute valeur supérieure à 10 est ignorée et remplacée par 10. Reportez-vous au format des paramètres de requête défini dans l'API GET Users. Si aucun utilisateur n'a été trouvé, une liste vide est renvoyée.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"], 3)
findUser($filter)	La fonction renvoie un seul utilisateur correspondant au filtre indiqué. $filter: La chaîne qui définit les critères de correspondance selon le format défini dans l'API GET Users. Une erreur est renvoyée si plusieurs utilisateurs ont été trouvés ou si aucun utilisateur n'a été trouvé.	findUser('emails eq "jessica@jke.com"')
findUser($filter, $attributes)	La fonction renvoie un seul utilisateur correspondant au filtre indiqué. L'utilisateur ne renvoie que les attributs spécifiés dans l'argument $attributes . $filter: Chaîne de caractères définissant les critères de correspondance. $attributes: Tableau de chaînes de caractères contenant les éléments de l' scimNames s qui doivent être renvoyés dans le résultat. Reportez-vous au format des paramètres de requête défini dans l'API GET Users. Une erreur est renvoyée si plusieurs utilisateurs ont été trouvés ou si aucun utilisateur n'a été trouvé.	findUser('emails eq "jessica@jke.com"', ["emails", "name.givenName"])
getUser($uid)	$uidLa fonction renvoie l'utilisateur associé à l'élément donné. Une erreur est renvoyée si l'utilisateur n'existe pas.	getUser("504K8664N6")
createUser($m)	Cette fonction crée un utilisateur avec les valeurs d'attributs indiquées. $m: Une liste répertoriant l'ID ou le nom des attributs ainsi que la valeur souhaitée par l'utilisateur. Les identifiants des attributs se trouvent dans la réponse de l'API GET Attributes. L'identifiant et le nom de l'attribut peuvent être utilisés indifféremment. Les valeurs des email attributs et username sont obligatoires. Les autres valeurs sont facultatives. Pour définir le mot de passe du nouvel utilisateur, ajoutez une propriété dans $m dont le nom password est et dont la valeur correspond au mot de passe en clair. En cas de réussite, l'objet SCIM de l'utilisateur créé est renvoyé dans result.	createUser({'3':'jessica@jke.com', 'userName':'Jessica', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'Manager', 'hobbies':['Reading', 'Swimming'], '6': 'Jessica', '7': 'Doe'})
createUser($m, $opts)	Cette fonction crée un utilisateur avec les valeurs d'attributs indiquées et des options supplémentaires. $m: Une liste répertoriant l'ID ou le nom des attributs ainsi que la valeur souhaitée par l'utilisateur. $opts: Une liste des options supplémentaires pouvant être spécifiées lors de la création d'un utilisateur. Les identifiants des attributs se trouvent dans la réponse de l'API GET Attributes. L'identifiant et le nom de l'attribut peuvent être utilisés indifféremment. Les valeurs des email attributs et username sont obligatoires. Les autres valeurs sont facultatives. Pour définir le mot de passe du nouvel utilisateur, ajoutez une propriété dans $m portant le nom password et dont la valeur correspond au mot de passe en clair. Les propriétés suivantes sont actuellement autorisées dans $opts : notifyType : cette propriété indique le type de notification à envoyer à l'utilisateur. La valeur par défaut est EMAIL. notifyPassword : valeur booléenne indiquant si le mot de passe de l'utilisateur est inclus dans la notification qui lui est envoyée. La valeur par défaut est true. Cet attribut ne s'applique pas si notifyType est défini sur NONE. notifyManager : valeur booléenne indiquant si une notification doit être envoyée au responsable de l'utilisateur (s'il y en a un) lorsque le mot de passe de l'utilisateur est défini ou modifié. La valeur par défaut est false. Cet attribut ne s'applique pas si notifyType est défini sur NONE. acceptInitialPassword : si cette option est définie sur « true », l'utilisateur n'est pas obligé de modifier son mot de passe lors de sa première connexion. En cas de réussite, l'objet SCIM de l'utilisateur créé est renvoyé dans result.	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)	Cette fonction met à jour l'utilisateur indiqué avec les valeurs d'attribut spécifiées. $uid: L'identifiant de l'utilisateur à mettre à jour. $m: Une liste répertoriant l'ID ou le nom des attributs ainsi que la valeur souhaitée par l'utilisateur. Les identifiants des attributs se trouvent dans la réponse de l'API GET Attributes. L'identifiant et le nom de l'attribut peuvent être utilisés indifféremment. Une mise à jour réussie renvoie success une chaîne de caractères comme résultat. L'objet utilisateur n'est pas renvoyé.	updateUser('6050007SGF', {'3':'jessica@redbank.com', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'President', 'mobile_number': '502513585', 'work_country': 'Singapore'})

Donnée d'identification de la source d'identité

Lorsqu'un utilisateur se connecte à Verify, les attributs d'identification de la source d'identité sont ajoutés à la session de connexion et peuvent être consultés dans une fonction personnalisée. Considérez que l'utilisateur se connecte avec un fournisseur d'identité fédéré SAML et que l'assertion SAML contient une instruction d'attribut appelée userRoles et définie sur marketing et helpdesk.

L'attribut idsuser est disponible sous la forme d'une mappe avec une clé de chaîne et une valeur de tableau de chaînes. Par exemple :

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

Syntaxe	Descriptif	Exemples
idsuser.$property	Accédez à $property. La valeur de idsuser est toujours un tableau de chaînes.	idsuser.userRoles[1] Résultat : helpdesk
idsuser.getValue($property)	Renvoie la valeur de $property sous forme de chaîne. Si le tableau de valeurs comporte plusieurs entrées, le premier élément est renvoyé. Si $property n'existe pas, une chaîne vide est renvoyée.	idsuser.getValue('userRoles') Résultat : "Marketing"
idsuser.getValues($property)	Renvoie toutes les valeurs de $property sous forme de tableau de chaînes. Si $property n'existe pas, un objet nil est renvoyé.	idsuser.getValues('userRoles') Résultat : ["Marketing", "helpdesk]"

Contexte de demande HTTP

Lorsqu'un utilisateur se connecte à IBM Verify, le contexte de la requête entrante HTTP est accessible dans une fonction personnalisée. Si l'utilisateur se connecte avec un flux OAuth et que le client envoie les informations client-ip et user-agent , requestContext peut extraire les informations. Il peut être utilisé pour appeler un noeud final externe pour déterminer le score de risque de l'utilisateur.

requestContext est disponible sous la forme d'une mappe avec une clé de chaîne et une valeur de tableau de chaînes. Par exemple :

{
  "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"]
}

Tableau 1. HTTP contexte de la requête

Syntaxe	Descriptif	Exemple
requestContext.$property	Accédez à $property. La valeur de requestContext est toujours un tableau de chaînes.	requestContext.devicePlatform[1] Résultat : MACOS
requestContext.getValue($property)	Renvoie la valeur de $property sous forme de chaîne. Si le tableau de valeurs comporte plusieurs entrées, le premier élément est renvoyé. Si $property n'existe pas, une chaîne vide est renvoyée.	requestContext.getValue('x-forwarded-for') Résultat : 116.15.12.181
requestContext.getValues($property)	Renvoie toutes les valeurs de $property sous forme de tableau de chaînes. Si $property n'existe pas, un objet nil est renvoyé.	requestContext.getValues('x-forwarded-for') Résultat : ["116.15.12.181"]

Contexte d'attribut

L'objet de contexte inclut des paires clé/valeur de certaines propriétés de l'attribut qui peuvent être utilisées lors de l'écriture de fonctions. Les valeurs de ces propriétés sont valides uniquement lors de la recherche de cet attribut. Cet objet est accessible à l'aide de la clé ctx.

Les propriétés suivantes sont disponibles avec l'objet de contexte :

Syntaxe	Descriptif	Exemples
ctx.currentValue	Accédez à la valeur d'attribut évaluée avant l'exécution de cette fonction. Le type de données de cette valeur est spécifié lors de la configuration des attributs. Si la valeur ne peut pas être transtypée en type de données, cet élément a la valeur null.	ctx.currentValue.toUpper

Opérateurs standard

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

Fonctions standard

"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')

Fonctions UUID

genUUID()

Fonctions de type et de conversion

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)

Client HTTP

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(...)

Risque adaptatif

Utilisez des fonctions de risque d'accès adaptatif pour accéder au niveau de risque de session utilisateur en cours et aux données d'autorisation associées.

Une règle d'accès adaptatif doit être évaluée au moins une fois dans la session avant d'utiliser l'attribut personnalisé pour vérifier que les données sont renseignées, sinon la valeur “NOT_AVAILABLE” est renvoyée.

Les fonctions de gestion des risques liés à l'accès adaptatif permettent d'accéder aux conditions de la politique d'accès correspondantes affichées dans l'éditeur de politiques, comme décrit dans la section « Gestion des règles de politique d'accès adaptatif ».

Les détails relatifs aux indicateurs de risque sont décrits dans la section « Indications de risque ».

Les indicateurs clés des données sur les risques sont structurés comme JSON et sont illustrés dans l'exemple suivant. Vous pouvez accéder à cette structure JSON à l'aide de la fonction risk.getAdaptiveSessionData().

L'utilisation de la fonction risk.getRawAdaptiveSessionData() permet d'accéder à la réponse complète des données de risque adaptatives liées à la session utilisateur.

{
  "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

Application

Dans certains cas d'utilisation (provisionnement et rapprochement), l'objet app peut être utilisé dans les règles CELx. Cet objet représente le JSON de l'application utilisé pour la synchronisation des comptes.

app.getSupportingData()

OAuth

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

Fonctions JWT

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

Fonctions de débogage

Les fonctions de débogage permettent d'évaluer une expression tout en générant un journal de trace. Le journal de trace sera généré si une règle est exécutée alors que le mode de trace est activé. Pour plus d'informations sur l'activation du mode de trace et la consultation des journaux de trace, consultez la section « Paramètres de trace » dans les chapitres « Création d'un flux » et « Gestion de la vue de trace ».

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)})

Fonctions de mise en cache

Les fonctions de mise en cache permettent d'exploiter la mémoire cache dans le service Rule. Il existe deux types de fonctions de mise en cache : celles basées sur la session et celles qui ne le sont pas. Les fonctions de mise en cache basées sur les sessions utilisent session, tandis que les fonctions de mise en cache non basées sur les sessions utilisent cache. Les valeurs stockées dans le cache à l'aide des fonctions de mise en cache basées sur la session sont associées à une session utilisateur.

La mémoire cache globale (session et hors session) est soumise à une limite de taille maximale. Cette limite peut varier en fonction de la configuration du locataire. Une fois le cache plein, toute tentative d'ajout d'une entrée dans le cache entraînera une erreur.

{
  "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."}}

Fonctions cachées