Skip to main content

ResourceRuleParms

Parameters defining the new resource rule including the resource to which it applies.

Properties

NameTypeDescriptionNotes
acrFilterAcrFilterEnumIdentifies how the resource rule acr access filter operates. NA: The resource rule will apply to all requests. This is the default value. NONE: The resource rule will only apply if no acrs were requested. ANY: The resource rule will only apply if acrs were requested. SPECIFIC: The resource rule will only apply if acrs were requested and one of the requested acrs matches one from a specified list.[optional]
acrIdsList<String>The UUIDs of acrs associated with this resource rule if acrFilter is set to SPECIFIC. The resource rule will only apply if a requested acr is one of the specified acrs. If acrFilter is set to SPECIFIC, at least one acrId should be specified otherwise the resource rule will never apply.[optional]
dateTimeContextDateTimeContext[optional]
descriptionStringThe description of the resource rule.[optional]
deviceCertificateContextDeviceCertificateContext[optional]
disableSSOBooleanA flag indicating if single-sign on is disabled for this resource rule.[optional]
domainIdpFilterDomainIdpFilterEnumIdentifies how the resource rule domain idp access filter operates. This is the default value. NA: The resource rule will apply to all requests. NONE: The resource rule will only apply if the user does not have a domain-based IDP. ANY: The resource rule will only apply if the user has a domain-based IDP. SPECIFIC: The resource rule will only apply if the user has a domain-based IDP and the user's domain matches one from a specified list.[optional]
domainIdpIdsList<String>The UUIDs of domain-based identity providers associated with this resource rule if domainIdpFilter is set to SPECIFIC. The resource rule will only apply to users using one of the specified domain-based identity providers. If domainIdpFilter is set to SPECIFIC, at least one domainIdpId should be specified otherwise the resource rule will never apply.[optional]
enabledBooleanA flag indicating if this resource rule is enabled or not. Only enabled resource rules are considered during authentication.[optional]
groupIdsList<String>The UUIDs of groups associated with this resource rule. The resource rule will only apply to users in one of the specified groups. When creating a resource rule, if no groupsIds are specified, the resource rule will apply to all users.[optional]
groupsList<Group>The groups associated with this resource rule. The resource rule only applies to users in one of the specified groups. If no groups are specified, the resource rule applies to all users. This attribute is ignored if the groupIds attribute is specified. The groupIds attribute should be used instead.[optional]
highRiskAuthenticationFlowStringThe UUID of the authentication flow to use when the risk score is High. Required with v2 APIs.[optional]
highRiskEnableSmartLoginBooleanA flag indicating if Smart Login is enabled for High risk.This parameter is deprecated, use the highRiskAuthenticationFlow attribute with v2 APIs.[optional]
highRiskFirstStepHighRiskFirstStepEnumThe authenticator type to use in the first step of a two-step authentication scenario when the risk score is High. Only the values NONE, EXTERNAL, PASSWORD or DENY should be used for highRiskFirstStep. Other values are defined for backwards compatibility. Some values are not supported by all application types.This parameter is deprecated, use the highRiskAuthenticationFlow attribute with v2 APIs.[optional]
highRiskSecondStepList<HighRiskSecondStepEnum>The authenticator type to use during in the second step of a two-step authentication scenario when the risk score is High. Some values are not supported by all application types.This parameter is deprecated, use the highRiskAuthenticationFlow attribute with v2 APIs.[optional]
ipContextIpContext[optional]
kbaContextKbaContext[optional]
locationContextLocationContext[optional]
locationHistoryContextLocationHistoryContext[optional]
lowRiskAuthenticationFlowStringThe UUID of the authentication flow to use when the risk score is Low. Required with v2 APIs.[optional]
lowRiskEnableSmartLoginBooleanA flag indicating if Smart Login is enabled for Low risk.This parameter is deprecated, use the lowRiskAuthenticationFlow attribute with v2 APIs.[optional]
lowRiskFirstStepLowRiskFirstStepEnumThe authenticator type to use in the first step of a two-step authentication scenario when the risk score is Low. Only the values NONE, EXTERNAL, PASSWORD should be used for lowRiskFirstStep. The value DENY can only be specified for low risk authentication when using Smart Login, otherwise DENY can only be specified for medium or high risk values. Other values are defined for backwards compatibility. Some values are not supported by all application types. This parameter is deprecated, use the lowRiskAuthenticationFlow attribute with v2 APIs.[optional]
lowRiskSecondStepList<LowRiskSecondStepEnum>The authenticator type to use during in the second step of a two-step authentication scenario when the risk score is Low. Some values are not supported by all application types. This parameter is deprecated, use the lowRiskAuthenticationFlow attribute with v2 APIs.[optional]
lowRiskThresholdIntegerRisk scores below this value are considered Low risk.[optional]
machineContextMachineContext[optional]
mediumRiskAuthenticationFlowStringThe UUID of the authentication flow to use when the risk score is Medium. Required with v2 APIs.[optional]
mediumRiskEnableSmartLoginBooleanA flag indicating if Smart Login is enabled for Medium risk.This parameter is deprecated, use the mediumRiskAuthenticationFlow attribute with v2 APIs.[optional]
mediumRiskFirstStepMediumRiskFirstStepEnumThe authenticator type to use in the first step of a two-step authentication scenario when the risk score is Medium. Only the values NONE, EXTERNAL, PASSWORD or DENY should be used for mediumRiskFirstStep. Other values are defined for backwards compatibility. Some values are not supported by all application types. This parameter is deprecated, use the mediumRiskAuthenticationFlow attribute with v2 APIs.[optional]
mediumRiskSecondStepList<MediumRiskSecondStepEnum>The authenticator type to use during in the second step of a two-step authentication scenario when the risk score is Medium. Some values are not supported by all application types.This parameter is deprecated, use the mediumRiskAuthenticationFlow attribute with v2 APIs.[optional]
mediumRiskThresholdIntegerRisk scores below this value are considered Medium risk. Risk scores equal or greater than this value are considered High risk.[optional]
nameStringThe name of the resource rule.[optional]
removeDateTimeContextBooleanWhen updating a resource rule, if removeDateTimeContext is set to true, the existing date time context is removed. This attribute is ignored when creating a resource rule.[optional]
removeDeviceCertificateContextBooleanWhen updating a resource rule, if removeDeviceCertificateContext is set to true, the existing device certificate context is removed. This attribute is ignored when creating a resource rule.[optional]
removeIPContextBooleanWhen updating a resource rule, if removeIPContext is set to true, the existing IP context is removed. This attribute is ignored when creating a resource rule.[optional]
removeKBAContextBooleanWhen updating a resource rule, if removeKBAContext is set to true, the existing KBA context is removed. This attribute is ignored when creating a resource rule.[optional]
removeLocationContextBooleanWhen updating a resource rule, if removeLocationContext is set to true, the existing location context is removed. This attribute is ignored when creating a resource rule.[optional]
removeLocationHistoryContextBooleanWhen updating a resource rule, if removeLocationHistoryContext is set to true, the existing location history context is removed. This attribute is ignored when creating a resource rule.[optional]
removeMachineContextBooleanWhen updating a resource rule, if removeMachineContext is set to true, the existing machine context is removed. This attribute is ignored when creating a resource rule.[optional]
removeTravelVelocityContextBooleanWhen updating a resource rule, if removeTravelVelocityContext is set to true, the existing travel velocity context is removed. This attribute is ignored when creating a resource rule.[optional]
resourceIdStringThe UUID of the resource to which this resource rule is assigned. This value is only used when creating a resource rule.[optional]
riskEngineContextsList<TransactionContext>If risk engine rules are defined, the transaction contexts specify the level at which risk is applied to the authentication request if the corresponding risk engine rules trigger risk. If set to null, no changes are made. If set to an empty set, transaction contexts are removed.[optional]
skipSecondFactorIfUserNotExistBooleanA flag indicating if second factor will be skipped if user doesn't exist when the first factor was EXTERNAL.[optional]
strictAccessBooleanA flag indicating if this resource rule enforces strict access. Strict access means that if this rule denies access, the user is denied access even if other resource rules allow access.[optional]
transactionContextsList<TransactionContext>If transaction details are specified during an authentication request, the transaction contexts specify the level at which risk is applied to the authentication request if the corresponding transaction rules trigger risk. A maximum of two are allowed. If set to null, no changes are made. If set to an empty set, transaction contexts are removed.[optional]
travelVelocityContextTravelVelocityContext[optional]

AcrFilterEnum

NameValue
NA"NA"
NONE"NONE"
ANY"ANY"
SPECIFIC"SPECIFIC"

DomainIdpFilterEnum

NameValue
NA"NA"
NONE"NONE"
ANY"ANY"
SPECIFIC"SPECIFIC"

HighRiskFirstStepEnum

NameValue
NONE"NONE"
EXTERNAL"EXTERNAL"
PASSWORD"PASSWORD"
KBA"KBA"
OTP"OTP"
TOKEN"TOKEN"
TOKENPUSH"TOKENPUSH"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
IDP"IDP"
PASSKEY"PASSKEY"
SMART_LOGIN"SMART_LOGIN"
USER_CERTIFICATE"USER_CERTIFICATE"
FACE"FACE"
DENY"DENY"
MAGICLINK"MAGICLINK"

List<HighRiskSecondStepEnum>

NameValue
NONE"NONE"
KBA"KBA"
TEMP_ACCESS_CODE"TEMP_ACCESS_CODE"
OTP"OTP"
GRID"GRID"
TOKEN"TOKEN"
TOKENCR"TOKENCR"
TOKENPUSH"TOKENPUSH"
FIDO"FIDO"
USER_CERTIFICATE"USER_CERTIFICATE"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
FACE"FACE"
PASSTHROUGH"PASSTHROUGH"
MAGICLINK"MAGICLINK"

LowRiskFirstStepEnum

NameValue
NONE"NONE"
EXTERNAL"EXTERNAL"
PASSWORD"PASSWORD"
KBA"KBA"
OTP"OTP"
TOKEN"TOKEN"
TOKENPUSH"TOKENPUSH"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
IDP"IDP"
PASSKEY"PASSKEY"
SMART_LOGIN"SMART_LOGIN"
USER_CERTIFICATE"USER_CERTIFICATE"
FACE"FACE"
DENY"DENY"
MAGICLINK"MAGICLINK"

List<LowRiskSecondStepEnum>

NameValue
NONE"NONE"
KBA"KBA"
TEMP_ACCESS_CODE"TEMP_ACCESS_CODE"
OTP"OTP"
GRID"GRID"
TOKEN"TOKEN"
TOKENCR"TOKENCR"
TOKENPUSH"TOKENPUSH"
FIDO"FIDO"
USER_CERTIFICATE"USER_CERTIFICATE"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
FACE"FACE"
PASSTHROUGH"PASSTHROUGH"
MAGICLINK"MAGICLINK"

MediumRiskFirstStepEnum

NameValue
NONE"NONE"
EXTERNAL"EXTERNAL"
PASSWORD"PASSWORD"
KBA"KBA"
OTP"OTP"
TOKEN"TOKEN"
TOKENPUSH"TOKENPUSH"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
IDP"IDP"
PASSKEY"PASSKEY"
SMART_LOGIN"SMART_LOGIN"
USER_CERTIFICATE"USER_CERTIFICATE"
FACE"FACE"
DENY"DENY"
MAGICLINK"MAGICLINK"

List<MediumRiskSecondStepEnum>

NameValue
NONE"NONE"
KBA"KBA"
TEMP_ACCESS_CODE"TEMP_ACCESS_CODE"
OTP"OTP"
GRID"GRID"
TOKEN"TOKEN"
TOKENCR"TOKENCR"
TOKENPUSH"TOKENPUSH"
FIDO"FIDO"
USER_CERTIFICATE"USER_CERTIFICATE"
SMARTCREDENTIALPUSH"SMARTCREDENTIALPUSH"
FACE"FACE"
PASSTHROUGH"PASSTHROUGH"
MAGICLINK"MAGICLINK"