속성 기능

개요

고급 규칙 속성을 구성하려면 관리 콘솔에서 디렉터리 > 속성 으로 이동하십시오. 그런 다음 다른 모든 속성 유형을 매핑하는 것과 마찬가지로 애플리케이션 구성에서 이러한 속성을 매핑하십시오.

도메인 객체

용어, 도메인 오브젝트는 속성의 사용자 정의 함수에서 액세스할 수 있는 가능한 모든 오브젝트를 표시하는 데 사용되는 캐치올 구문입니다.

Cloud Directory 사용자

Verify에 대해 인증하는 모든 사용자에 대해 사용자 계정이 클라우드 디렉토리에 작성됩니다. 이 계정은 SCIM 오브젝트로 표시됩니다. 다음 예제에서 다음 Cloud Directory 사용자 계정이 사용됩니다.

다음 SCIM 오브젝트가 사용자 계정입니다.

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

참고: SCIM 객체에는 두 개의 사용자 정의 속성인 car 와 hobbies가 정의되어 있습니다. 이러한 속성은 관리 콘솔을 통해 구성할 수 있는 스키마 확장입니다. 사용자 객체에는 Users API를 Verify 통해 값을 추가할 수 있습니다.

구문	설명	예
user.$property	$property에 액세스하십시오. . 및 [".."] 둘 다 사용할 수 있습니다.	user.name.familyName + ", " + user.name["givenName"] 결과: Hill, Jessica
user.$values.filter(x, $condition)	$values: 목록입니다. filter 함수는 $condition을(를) 기반으로 값을 추출합니다.	user.emails.filter(x, x.type == "work")[0].value 결과: jessica@jke.com
user.getCustomValues($attrName)	사용자 정의 속성 값을 목록으로 반환하는 함수. $attrName: 사용자 객체의 속성이 존재하지 않으면 해당 속성의 이름이 null을 반환합니다.	user.getCustomValues("car") 결과: ["Ford Mustang Mach-E","Maruti Suzuki 800"]
user.getCustomValue($attrName)	목록에서 첫 번째 사용자 정의 속성 값을 가져오는 함수. $attrName: 사용자 객체 내 속성의 이름입니다. 해당 속성이 존재하지 않으면 빈 문자열("")을 반환합니다.	user.getCustomValue("hobbies") 결과: Reading
user.getManager()	현재 사용자의 관리자 정보를 가져오는 함수. 함수는 관리자의 사용자 계정을 리턴합니다(SCIM 오브젝트로). 사용자에 대한 관리자가 지정되지 않은 경우 비어 있는 JSON 오브젝트를 리턴합니다. 매니저 객체가 반환되면, 이 객체는 사용자 객체와 마찬가지로 사용할 수 있으며, 즉 이 객체에 대해 다양한 함수를 호출할 수 있습니다.	user.getManager().name.formatted 결과: Jacob Jones
user.getRoles()	현재 사용자의 권한을 가져오는 함수. 이 함수는 사용자의 권한 목록을 JSON 객체 형태로 반환합니다. 권한 목록이 반환되면, 이를 JSON 객체로 사용할 수 있습니다.	user.getRoles().resources[0].name 결과: Basic access
user.getFIDO2Registrations($search)	현재 사용자의 FIDO2 등록 내역을 가져오는 함수입니다. 이 함수는 해당 사용자에게 등록된 ‘ FIDO2 ’ 목록을 반환합니다. 검색 매개변수는 $search 선택적으로 지정할 수 있습니다. 지원되는 검색 매개변수는 다음에서 확인할 수 있습니다: https://docs.verify.ibm.com/verify/reference/getfidoregistrations_v20	user.getFIDO2Registrations("enabled=true").fido2[0].enabled 결과: true
user.getFIDO2RegistrationByID($id)	$idID가.인 현재 사용자의 FIDO2 등록 정보를 가져오는 함수입니다.	user.getFIDO2RegistrationByID("e8bf1dac-8245-452b-b7c4-8a700a1eb078").fido2[0].id 결과: e8bf1dac-8245-452b-b7c4-8a700a1eb078
user.getDynamicGroups()	현재 사용자의 동적 그룹을 가져오는 함수. 이 함수는 사용자의 동적 그룹 목록을 JSON 객체 형태로 반환합니다.	user.getDynamicGroups().resources[0].name 결과 : Security department manager

사용자 관리 기능

Cloud Directory의 사용자에 대해 읽기, 생성 및 업데이트 작업을 수행해야 하는 경우, CELx에서 다음 기능을 사용할 수 있습니다.

이 함수들의 반환값은 아래에 정의된 것과 같은 맵 객체입니다. 이를 통해 CELx 함수 내에서 오류 처리를 유연하게 수행할 수 있습니다. 의 뒤에 error 빈 문자열이 있으면 작업이 성공적으로 완료되었음을 의미합니다.

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

구문	설명	예
findUsers($filter)	이 함수는 지정된 필터 조건에 맞는 사용자 목록을 반환합니다. $filter: GET Users API 에 정의된 형식에 따라 일치 기준을 지정하는 문자열입니다. 검색 결과에는 최대 10명의 사용자로 제한됩니다. 일치하는 사용자가 없으면 빈 목록이 반환됩니다.	findUsers('emails ew "@jke.com"')
findUsers($filter, $attributes)	이 함수는 지정된 필터 조건에 맞는 사용자 목록을 반환합니다. 일치하는 각 사용자는 인자에 $attributes 지정된 속성을 반환합니다. $filter: 일치 조건을 정의하는 문자열. $attributes: 결과에 반환되어야 하는 ` scimNames ` 형식의 문자열 배열. GET Users API 에 정의된 쿼리 매개변수 형식을 참조하십시오. 검색 결과에는 최대 10명의 사용자로 제한됩니다. 일치하는 사용자가 없으면 빈 목록이 반환됩니다.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"])
findUsers($filter, $attributes, $count)	이 함수는 지정된 필터 조건에 맞는 사용자 목록을 반환하며, 최대 $count 명까지 포함합니다. 일치하는 각 사용자에 대해서는 인자에 $attributes 지정된 속성만 반환됩니다. $filter: 일치 조건을 정의하는 문자열. $attributes: 결과에 반환되어야 하는 ` scimNames ` 형식의 문자열 배열. $count: 반환할 최대 사용자 수를 지정하는 정수이며, 최대 10명까지 가능합니다. 10보다 큰 값은 무시되고 10으로 설정됩니다. GET Users API 에 정의된 쿼리 매개변수 형식을 참조하십시오. 일치하는 사용자가 없으면 빈 목록이 반환됩니다.	findUsers('emails ew "@jke.com"', ["emails", "name.givenName"], 3)
findUser($filter)	이 함수는 지정된 필터 조건에 맞는 단일 사용자를 반환합니다. $filter: GET Users API 에 정의된 형식에 따라 일치 조건을 지정하는 문자열입니다. 일치하는 사용자가 여러 명인 경우나 일치하는 사용자가 없는 경우 오류가 반환됩니다.	findUser('emails eq "jessica@jke.com"')
findUser($filter, $attributes)	이 함수는 지정된 필터 조건에 맞는 단일 사용자를 반환합니다. 사용자는 인자에 $attributes 지정된 속성만 반환합니다. $filter: 일치 조건을 정의하는 문자열. $attributes: 결과에 반환되어야 하는 ` scimNames ` 유형의 문자열 배열. GET Users API 에 정의된 쿼리 매개변수 형식을 참조하십시오. 일치하는 사용자가 여러 명인 경우나 일치하는 사용자가 없는 경우 오류가 반환됩니다.	findUser('emails eq "jessica@jke.com"', ["emails", "name.givenName"])
getUser($uid)	$uid이 함수는 주어진 항목과 연결된 사용자를 반환합니다. 사용자가 존재하지 않으면 오류가 반환됩니다.	getUser("504K8664N6")
createUser($m)	이 함수는 지정된 속성 값을 가진 사용자를 생성합니다. $m: 속성 ID/이름과 사용자가 원하는 값을 나타내는 매핑표. 속성 ID는 GET Attributes API 의 응답에서 확인할 수 있습니다. ID와 속성명은 서로 바꿔서 사용할 수 있습니다. email 및 username 속성 값은 필수입니다. 나머지 값들은 선택 사항입니다. 새 사용자의 비밀번호를 지정하려면 $m에 name password 속성을 포함하고, 그 값으로 평문 비밀번호를 입력하십시오. result성공 시, 생성된 사용자 SCIM 객체가 반환됩니다.	createUser({'3':'jessica@jke.com', 'userName':'Jessica', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'Manager', 'hobbies':['Reading', 'Swimming'], '6': 'Jessica', '7': 'Doe'})
createUser($m, $opts)	이 함수는 지정된 속성 값과 추가 옵션을 사용하여 사용자를 생성합니다. $m: 속성 ID/이름과 사용자가 원하는 값을 나타내는 매핑표. $opts: 사용자 생성 시 지정할 수 있는 추가 옵션 목록 속성 ID는 GET Attributes API 의 응답에서 확인할 수 있습니다. ID와 속성명은 서로 바꿔서 사용할 수 있습니다. email 및 username 속성 값은 필수입니다. 나머지 값들은 선택 사항입니다. 새 사용자의 비밀번호를 지정하려면, 파일에 $m 이름 password 인 속성을 추가하고 값으로 평문 비밀번호를 입력하십시오. 현재 $opts에서는 다음 속성을 사용할 수 있습니다: notifyType : 이 속성은 사용자에게 전송할 알림의 유형을 지정합니다. EMAIL기본값은.입니다. notifyPassword : 사용자에게 전송되는 알림에 사용자의 비밀번호가 포함될지 여부를 나타내는 부울 값입니다. true기본값은.입니다. NONE이 속성은 가 로 설정된 경우에는 notifyType 적용되지 않습니다. notifyManager : 사용자의 비밀번호가 설정되거나 변경될 때 사용자의 관리자(설정된 경우)에게 알림을 보낼지 여부를 나타내는 부울 값입니다. false기본값은.입니다. NONE이 속성은 가 로 설정된 경우에는 notifyType 적용되지 않습니다. acceptInitialPassword : 이 값을 true로 설정하면, 사용자가 처음 로그인할 때 비밀번호를 변경할 필요가 없습니다. result성공 시, 생성된 사용자 SCIM 객체가 반환됩니다.	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)	이 함수는 지정된 속성 값으로 해당 사용자를 업데이트합니다. $uid: 업데이트할 사용자의 ID. $m: 속성 ID/이름과 사용자가 원하는 값을 나타내는 매핑표. 속성 ID는 GET Attributes API 의 응답에서 확인할 수 있습니다. ID와 속성명은 서로 바꿔서 사용할 수 있습니다. 업데이트가 성공하면 결과로 string을 반환합니다 success . 사용자 객체는 반환되지 않습니다.	updateUser('6050007SGF', {'3':'jessica@redbank.com', '3f31edcf-19e8-46a4-b87e-e50c25dc1358':'President', 'mobile_number': '502513585', 'work_country': 'Singapore'})

ID 소스 인증 정보

사용자가 Verify에 로그인하면, ID 소스 증명서 속성이 로그인 세션에 추가되고 사용자 정의 함수에서 액세스할 수 있습니다. 사용자가 SAML 연합 ID 제공자를 사용하여 로그인하고 SAML 권한 정보에 userRoles(이)라는 속성 명령문이 포함되어 있으며 marketing 및 helpdesk(으)로 설정되었음을 고려하십시오.

idsuser 속성은 문자열 키 및 문자열 배열 값이 있는 맵으로 사용 가능합니다. 예를 들면 다음과 같습니다.

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

구문	설명	예
idsuser.$property	$property에 액세스하십시오. idsuser의 값은 항상 문자열 배열입니다.	idsuser.userRoles[1] 결과: helpdesk
idsuser.getValue($property)	$property의 값을 문자열로 리턴합니다. 값 배열에 여러 항목이 있는 경우 첫 번째 항목이 리턴됩니다. $property이(가) 존재하지 않으면 비어 있는 문자열이 리턴됩니다.	idsuser.getValue('userRoles') 결과: "Marketing"
idsuser.getValues($property)	$property의 모든 값을 문자열 배열로 리턴합니다. $property이(가) 존재하지 않으면 nil 오브젝트가 리턴됩니다.	idsuser.getValues('userRoles') 결과: ["Marketing", "helpdesk]"

HTTP 요청 컨텍스트

IBM Verify사용자가 에 로그인하면, 사용자 정의 함수 내에서 수신된 HTTP 요청 컨텍스트에 접근할 수 있습니다. 사용자가 OAuth 플로우를 사용하여 로그인하고 클라이언트가 client-ip 및 user-agent 정보를 전송하는 경우, requestContext은(는) 정보를 추출할 수 있습니다. 외부 엔드포인트를 호출하여 사용자의 리스크 점수를 판별하는 데 사용할 수 있습니다.

requestContext은(는) 문자열 키 및 문자열 배열 값이 있는 맵으로 사용 가능합니다. 예를 들면 다음과 같습니다.

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

표 1. HTTP 요청 컨텍스트

구문	설명	예제
requestContext.$property	$property에 액세스하십시오. requestContext의 값은 항상 문자열 배열입니다.	requestContext.devicePlatform[1] 결과: MACOS
requestContext.getValue($property)	$property의 값을 문자열로 리턴합니다. 값 배열에 여러 항목이 있는 경우 첫 번째 항목이 리턴됩니다. $property이(가) 존재하지 않으면 비어 있는 문자열이 리턴됩니다.	requestContext.getValue('x-forwarded-for') 결과: 116.15.12.181
requestContext.getValues($property)	$property의 모든 값을 문자열 배열로 리턴합니다. $property이(가) 존재하지 않는 경우에는 nil 오브젝트가 리턴됩니다.	requestContext.getValues('x-forwarded-for') 결과: ["116.15.12.181"]

속성 컨텍스트

컨텍스트 오브젝트는 함수를 작성할 때 사용할 수 있는 속성의 특정한 특성에 대한 키/값 쌍을 보유합니다. 이러한 특성의 값은 해당 속성의 검색 컨텍스트에서만 유효합니다. 이 오브젝트는 ctx 키를 사용하여 액세스할 수 있습니다.

다음 특성은 컨텍스트 오브젝트로 사용 가능합니다.

구문	설명	예
ctx.currentValue	이 함수를 실행하기 전에 평가된 속성 값에 액세스하십시오. 이 값의 데이터 유형이 속성 구성에 지정됩니다. 값을 데이터 유형에 전달할 수 없는 경우 이 값은 널로 설정됩니다.	ctx.currentValue.toUpper

표준 연산자

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

표준 함수

"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 함수

genUUID()

입력 및 변환 함수

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 클라이언트

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

적용 위험성

현재 사용자 세션 위험 레벨 및 연관된 권한 데이터에 액세스하려면 적용 액세스 위험 함수를 사용하십시오.

데이터가 채워지는 것을 확인하기 위해 사용자 정의 속성을 사용하기 전에 세션에서 최소한 한 번은 적응 액세스 정책을 평가해야 합니다. 그렇지 않으면 “NOT_AVAILABLE” 값이 리턴됩니다.

‘적응형 액세스 정책 규칙 관리’에 설명된 대로, 적응형 액세스 위험 기능은 정책 편집기에 표시된 해당 액세스 정책 조건에 대한 액세스를 제공합니다.

위험 지표에 대한 자세한 내용은 ‘위험 징후’에서 확인할 수 있습니다.

위험 데이터의 주요 지표는 JSON으로 구성되며 다음 예제에서 확인할 수 있습니다. 이 JSON 구조는 risk.getAdaptiveSessionData() 함수를 사용하여 액세스할 수 있습니다.

사용자 세션과 관련된 전체 적응 위험 데이터 응답은 risk.getRawAdaptiveSessionData() 함수를 사용하여 액세스할 수 있습니다.

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

애플리케이션

특정 사용 사례(프로비저닝 및 조정)의 경우, CELx 규칙에서 해당 app 객체를 사용할 수 있습니다. 이 객체는 계정 동기화에 사용되는 애플리케이션 JSON을 나타냅니다.

app.getSupportingData()

OAuth

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

JWT 함수

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

디버그 기능

디버그 함수를 사용하면 식을 평가하면서 동시에 추적 로그를 생성할 수 있습니다. 추적 모드가 활성화된 상태에서 규칙이 실행되면 추적 로그가 생성됩니다. 추적 모드 활성화 및 추적 로그 확인에 대한 자세한 내용은 ‘플로우 생성’ 및 ‘추적 보기 관리’의 ‘추적 설정’을 참조하십시오.

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

캐시 함수

캐시 함수를 사용하면 Rule 서비스의 캐시를 활용할 수 있습니다. 캐시 기능에는 세션 기반과 비세션 기반, 두 가지 유형이 있습니다. cachesession세션 기반 캐시 함수는 를 사용하는 반면, 비세션 기반 캐시 함수는 를 사용합니다. 세션 기반 캐시 함수를 사용하여 캐시에 저장된 값은 사용자 세션에 바인딩됩니다.

전체 캐시(세션 및 비세션)에는 최대 크기 제한이 있습니다. 이 제한은 테넌트의 구성에 따라 달라질 수 있습니다. 캐시가 가득 차면, 캐시에 항목을 추가하려는 모든 요청은 오류가 발생합니다.

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

비밀 기능