1. OAA Admin API
  2. Tasks
  3. Policy Browser

Updates the trigger combination associated with a policy.

put

/policy/risk/v1/policies/{policygid}/trigger-combinations

Policy Browser is intended for migration customers who wishes to see the old policies created in their system. This API can be used to update a trigger combination.

Request

Path Parameters
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Trigger Combinations detail for PolicyDetailedResponse for Policy Browser
Show Source
Nested Schema : triggerCombinations
Type: array
Show Source
Nested Schema : RuleResult
Type: object
Rule and Result for trigger combinations
Show Source
Request Body - application/json ()
Root Schema : schema
Type: object
Trigger Combinations detail for PolicyDetailedResponse for Policy Browser
Show Source
Nested Schema : triggerCombinations
Type: array
Show Source
Nested Schema : RuleResult
Type: object
Rule and Result for trigger combinations
Show Source
Back to Top

Response

Supported Media Types

200 Response

Policy is updated
Body ()
Root Schema : PolicyDetailedResponse
Type: object
Policy Detail with Trigger Combinations for Policy Browser
Show Source
Nested Schema : rules
Type: array
Show Source
Nested Schema : triggerCombinations
Type: array
Show Source
Nested Schema : RuleObjectDetail
Type: object
Rule detail for PolicyDetailedResponse for Policy Browser
Show Source
Nested Schema : schema
Type: object
Trigger Combinations detail for PolicyDetailedResponse for Policy Browser
Show Source
Nested Schema : triggerCombinations
Type: array
Show Source
Nested Schema : RuleResult
Type: object
Rule and Result for trigger combinations
Show Source

401 Response

Unauthorized

500 Response

Internal server error

503 Response

Service Unavailable
Back to Top

Examples

The following example shows a sample request and response to update the trigger combinations for an existing policy (transitioned from OAAM).

cURL Command to Update Trigger Combinations in JSON Format

curl --location --request PUT '<PolicyUrl>/policy/risk/v1/policies/51143_424de17591ff7cb74bba3759a9fa6aaf453769e756b08693b43253d09a113439/trigger-combinations' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "If a user has enough recorded behavior in their profile they will be evaluated by this policy.",
    "rules": [
        {
            "ruleName": "Does user have a profile",
            "ruleResult": "TRUE"
        },
        {
            "ruleName": "Is enough pattern data available",
            "ruleResult": "FALSE"
        }
    ],
    "score": "0"
}'

Sample Response in JSON Format

{
    "policyName": "does user have profile",
    "status": "200",
    "message": "Policy update is successfully.",
    "policygid": "51143_424de17591ff7cb74bba3759a9fa6aaf453769e756b08693b43253d09a113439",
    "policyname": "does user have profile",
    "policyDescription": "This policy checks if pattern auto learning is enabled and if a user has past behavior recorded. Users with enough recorded behavior will be evaluated against their own profile while users without enough recorded behavior will be evaluated against the profiles of all other users.",
    "policyStatus": "ACTIVE",
    "policyStatusDisplayValue": "Active",
    "checkpoint": "User Authentication",
    "scoringEngine": "Average",
    "weight": "100",
    "rules": [
        {
            "rulegid": "51356_3d3903a75f923ab9925c3a7b5935d03cd2e9e4a31936f7ec7ad1c1294f71969a",
            "ruleName": "Does user have a profile",
            "score": "0",
            "weight": "100",
            "ruleStatus": "ACTIVE",
            "ruleStatusDisplayValue": "Active",
            "ruleNotes": "This rule checks if the pattern auto learning is enabled and if the user has a historical behavior profile."
        },
        {
            "rulegid": "9353_e49b40e49ebac38d36f5ce08ea16afc25a2e1e57642b2a7e8f9ee47a6844927b",
            "ruleName": "Is there enough pattern data available?",
            "score": "0",
            "weight": "100",
            "ruleStatus": "ACTIVE",
            "ruleStatusDisplayValue": "Active",
            "ruleNotes": "Rule checks if enough pattern data is available so that auto-learning rules can make use of it."
        }
    ],
    "triggerCombinations": [
        {
            "description": "If the profile contains enough recorded behavior, the user is evaluated by this policy.",
            "rules": [
                {
                    "ruleName": "Does user have a profile",
                    "ruleResult": "True"
                },
                {
                    "ruleName": "Is there enough pattern data available?",
                    "ruleResult": "False"
                }
            ],
            "score": "0"
        },
        {
            "description": "If a user does not have enough recorded behavior in their profile they will be evaluated by this policy.",
            "rules": [
                {
                    "ruleName": "Does user have a profile",
                    "ruleResult": "Any"
                },
                {
                    "ruleName": "Is there enough pattern data available?",
                    "ruleResult": "True"
                }
            ],
            "score": "0"
        }
    ]
}

cURL Command to Update Trigger Combinations in XML Format

curl --location --request PUT '<PolicyUrl>/policy/risk/v1/policies/51143_424de17591ff7cb74bba3759a9fa6aaf453769e756b08693b43253d09a113439/trigger-combinations' \
--header 'Authorization: Basic <Base64Encoded(<username>:<password>)>' \
--header 'Content-Type: application/json' \
--data '<?xml version="1.0" encoding="UTF-8" ?>
 <TriggerCombinationsObject>
     <description>If a user has enough recorded behavior in their profile they will be evaluated by this policy.</description>
     <rules>
         <ruleName>Does user have a profile</ruleName>
         <ruleResult>TRUE</ruleResult>
     </rules>
     <rules>
         <ruleName>Is enough pattern data available</ruleName>
         <ruleResult>FALSE</ruleResult>
     </rules>
     <score>0</score>
 </TriggerCombinationsObject>
'

Sample Response in XML Format

<?xml version="1.0" encoding="UTF-8" ?>
 <PolicyDetailedResponse>
     <policyName>does user have profile</policyName>
     <status>200</status>
     <message>Policy update is successfully.</message>
     <policygid>51143_424de17591ff7cb74bba3759a9fa6aaf453769e756b08693b43253d09a113439</policygid>
     <policyname>does user have profile</policyname>
     <policyDescription>This policy checks if pattern auto learning is enabled and if a user has past behavior recorded. Users with enough recorded behavior will be evaluated against their own profile while users without enough recorded behavior will be evaluated against the profiles of all other users.</policyDescription>
     <policyStatus>ACTIVE</policyStatus>
     <policyStatusDisplayValue>Active</policyStatusDisplayValue>
     <checkpoint>User Authentication</checkpoint>
     <scoringEngine>Average</scoringEngine>
     <weight>100</weight>
     <rules>
         <rulegid>51356_3d3903a75f923ab9925c3a7b5935d03cd2e9e4a31936f7ec7ad1c1294f71969a</rulegid>
         <ruleName>Does user have a profile</ruleName>
         <score>0</score>
         <weight>100</weight>
         <ruleStatus>ACTIVE</ruleStatus>
         <ruleStatusDisplayValue>Active</ruleStatusDisplayValue>
         <ruleNotes>This rule checks if the pattern auto learning is enabled and if the user has a historical behavior profile.</ruleNotes>
     </rules>
     <rules>
         <rulegid>9353_e49b40e49ebac38d36f5ce08ea16afc25a2e1e57642b2a7e8f9ee47a6844927b</rulegid>
         <ruleName>Is there enough pattern data available?</ruleName>
         <score>0</score>
         <weight>100</weight>
         <ruleStatus>ACTIVE</ruleStatus>
         <ruleStatusDisplayValue>Active</ruleStatusDisplayValue>
         <ruleNotes>Rule checks if enough pattern data is available so that auto-learning rules can make use of it.</ruleNotes>
     </rules>
     <triggerCombinations>
         <description>If the profile contains enough recorded behavior, the user is evaluated by this policy.</description>
         <rules>
             <ruleName>Does user have a profile</ruleName>
             <ruleResult>True</ruleResult>
         </rules>
         <rules>
             <ruleName>Is there enough pattern data available?</ruleName>
             <ruleResult>False</ruleResult>
         </rules>
         <score>0</score>
     </triggerCombinations>
     <triggerCombinations>
         <description>If a user does not have enough recorded behavior in their profile they will be evaluated by this policy.</description>
         <rules>
             <ruleName>Does user have a profile</ruleName>
             <ruleResult>Any</ruleResult>
         </rules>
         <rules>
             <ruleName>Is there enough pattern data available?</ruleName>
             <ruleResult>True</ruleResult>
         </rules>
         <score>0</score>
     </triggerCombinations>
 </PolicyDetailedResponse>
Back to Top