Okta IAM
| eventType | Description | Sample | Rule |
|---|---|---|---|
| iam. | IAM policy assignee's configuration update. | N | N |
| iam. | IAM policy configuration update. | N | N |
| iam. | Admin role assignment is created. | Y | Y |
| iam. | Admin assignment is deleted. | Y | N |
| iam. | Resource set is created. | Y | N |
| iam. | Resource set is deleted. | Y | N |
| iam. | Resources are added to a resource set. | N | N |
| iam. | Resources are deleted from a resource set. | N | N |
| iam. | Resources updated in a resource set. | N | N |
| iam. | Resource set update. | Y | N |
| iam. | Custom admin role is created. | Y | Y |
| iam. | Custom admin role is deleted. | Y | N |
| iam. | Conditions added to a permission in Okta. | N | N |
| iam. | Conditions deleted from a permission in Okta. | N | N |
| iam. | Permissions are added to a custom admin role. | Y | Y |
| iam. | Permissions are deleted from a custom admin role. | Y | N |
| iam. | Role subscriptions update. | N | N |
| iam. | Custom admin role update. | Y | N |
iam.policy.assignee_configuration.update
#Description
IAM policy assignee's configuration update. Use this event to track and audit updates to an IAM policy assignee's configurations. This event contains information about an IAM policy assignee's configuration updates such as toggling of third party admin settings.
References #
iam.policy.configuration.update
#Description
IAM policy configuration update. Use this event to track and audit updates to IAM policy configuration for the org. This event contains information about the IAM policy configuration updates for an org.
References #
iam.resourceset.bindings.add
#Description
Admin role assignment is created. This event can be used to track and audit when a new admin role assignment is created. When fired this event contains information about the new user or group admin assignments for roles associated with the resource set.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000037",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Member bindings added to Resource set",
"eventType": "iam.resourceset.bindings.add",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:08.084Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/resource-sets/iam00000000000000004/bindings",
"url": "/api/v1/iam/resource-sets/iam00000000000000004/bindings?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "ResourceSet",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "UserGroup",
"alternateId": null,
"displayName": "DW Harness",
"detailEntry": null
}
]
}
Detection Rules #
Full rule details for this event, including ATT&CK technique mappings and native queries →Sigma #
References #
iam.resourceset.bindings.delete
#Description
Admin assignment is deleted. This event can be used to track and audit when an admin role assignment is deleted. When fired this event contains information about the deleted user or group admin assignments for roles associated with the resource set.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000038",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Member bindings deleted from Resource set",
"eventType": "iam.resourceset.bindings.delete",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:08.181Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/resource-sets/iam00000000000000004/bindings/cr000000000000000005",
"url": "/api/v1/iam/resource-sets/iam00000000000000004/bindings/cr000000000000000005?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "ResourceSet",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "UserGroup",
"alternateId": null,
"displayName": "DW Harness",
"detailEntry": null
}
]
}
References #
iam.resourceset.create
#Description
Resource set is created. This event can be used to track and audit when a resource set is created. When fired this event contains information about the resources contained in the resource set that is created.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000039",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Resource set created",
"eventType": "iam.resourceset.create",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:07.682Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/resource-sets",
"url": "/api/v1/iam/resource-sets?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "ResourceSet",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "User",
"alternateId": null,
"displayName": "DW Harness",
"detailEntry": null
}
]
}
References #
iam.resourceset.delete
#Description
Resource set is deleted. This event can be used to track and audit when a resource set is deleted. When fired this event contains information about the resources contained in the resource set that is deleted.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000040",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Resource set deleted",
"eventType": "iam.resourceset.delete",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:09.469Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/resource-sets/iam00000000000000004",
"url": "/api/v1/iam/resource-sets/iam00000000000000004?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "ResourceSet",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "User",
"alternateId": null,
"displayName": "DW Harness",
"detailEntry": null
}
]
}
References #
iam.resourceset.resources.add
#Description
Resources are added to a resource set. This event can be used to audit the resources added to a resource set. When fired this event contains information about the resources added to the resource set.
References #
iam.resourceset.resources.delete
#Description
Resources are deleted from a resource set. This event can be used to audit the resources deleted from a resource set. When fired this event contains information about the resources deleted from the resource set.
References #
iam.resourceset.resources.update
#Description
Resources updated in a resource set. Used this event to audit resources updated in a resource set. This event contains information about resources that were updated in a resource set.
References #
iam.resourceset.update
#Description
Resource set update. Use this event to track and audit when a resource set was updated. This event contains information about the updated name and description of the resource set.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000041",
"externalSessionId": "00000000000000000000"
},
"displayMessage": null,
"eventType": "iam.resourceset.update",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:07.885Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/resource-sets/iam00000000000000004",
"url": "/api/v1/iam/resource-sets/iam00000000000000004?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "ResourceSet",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null,
"changeDetails": {
"from": {
"resourceSetDescription": "dw harness throwaway",
"resourceSetName": "dw-harn-eeb5dfe9-rs"
},
"to": {
"resourceSetDescription": "upd",
"resourceSetName": "dw-harn-eeb5dfe9-rs-upd"
}
}
}
]
}
References #
iam.role.create
#Description
Custom admin role is created. This event can be used to track and audit when a custom admin role is created. When fired this event contains information about the permissions contained in the role that is created.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000042",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Role created",
"eventType": "iam.role.create",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:06.421Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/roles",
"url": "/api/v1/iam/roles?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Permission",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Permission",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
}
]
}
Common Indicators #
Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.
| Field | Kind | Value | Rules | Vendors |
|---|---|---|---|---|
okta::eventType (kusto rule field) | in | policy.evaluate_sign_on | 1 rule | kusto |
okta::eventType (kusto rule field) | in | system.api_token.create | 1 rule | kusto |
okta::eventType (kusto rule field) | in | user.session.start | 1 rule | kusto |
Detection Rules #
Full rule details for this event, including ATT&CK technique mappings and native queries →Kusto #
T1078, T1078.004, T1098↳ also matches iam.role.permissions.add
References #
iam.role.delete
#Description
Custom admin role is deleted. This event can be used to track and audit when a custom admin role is deleted. When fired this event contains information about the permissions contained in the role that is deleted.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000043",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Role deleted",
"eventType": "iam.role.delete",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:09.729Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/roles/cr000000000000000005",
"url": "/api/v1/iam/roles/cr000000000000000005?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
}
]
}
References #
iam.role.permission.conditions.add
#Description
Conditions added to a permission in Okta. Use this event to evaluate impact on admin privileges as their scope might be impacted. This event is triggered when a condition is added to a role-based permission in Okta. A condition on a permission allows super admins to implement finer grained authorizations for stricter security postures. The event can be accompanied with other events for permissions such as iam.role.permissions.add.
References #
iam.role.permission.conditions.delete
#Description
Conditions deleted from a permission in Okta. Use this event to evaluate impact on admin privileges as their scope might be impacted. This event is triggered when a condition is deleted from a role-based permission in Okta. A condition on a permission allows super admins to implement finer grained authorizations for stricter security postures. The event can be accompanied with other events for permissions such as iam.role.permissions.delete.
References #
iam.role.permissions.add
#Description
Permissions are added to a custom admin role. This event can be used to audit the permissions added to a custom admin role. When fired this event contains information about the permissions added to the role.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000044",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Permissions added to Role",
"eventType": "iam.role.permissions.add",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:07.162Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/roles/cr000000000000000005/permissions/okta.apps.read",
"url": "/api/v1/iam/roles/cr000000000000000005/permissions/okta.apps.read?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Permission",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
}
]
}
Common Indicators #
Field/value combinations most frequently checked by detection rules targeting this event, derived from cross-vendor predicate analysis.
| Field | Kind | Value | Rules | Vendors |
|---|---|---|---|---|
okta::eventType (kusto rule field) | in | policy.evaluate_sign_on | 1 rule | kusto |
okta::eventType (kusto rule field) | in | system.api_token.create | 1 rule | kusto |
Detection Rules #
Full rule details for this event, including ATT&CK technique mappings and native queries →Kusto #
T1078, T1078.004, T1098↳ also matches iam.role.create
References #
iam.role.permissions.delete
#Description
Permissions are deleted from a custom admin role. This event can be used to audit the permissions deleted from a custom admin role. When fired this event contains information about the permissions deleted from the role.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000045",
"externalSessionId": "00000000000000000000"
},
"displayMessage": "Permissions deleted from Role",
"eventType": "iam.role.permissions.delete",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:07.598Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/roles/cr000000000000000005/permissions/okta.apps.read",
"url": "/api/v1/iam/roles/cr000000000000000005/permissions/okta.apps.read?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
{
"id": "00000000000000000000",
"type": "Permission",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
}
]
}
References #
iam.role.subscriptions.update
#Description
Role subscriptions update. Use this event to track and audit updated email subscriptions for a role. This event contains information about email subscription updates for a role. Email subscriptions determine the email notification type that Okta sends to admin users assigned to the role.
References #
iam.role.update
#Description
Custom admin role update. Use this event to track and audit when a custom admin role was updated. This event contains information about the updated name and description of the role.
Example System Log Event #
{
"actor": {
"id": "00000000000000000000",
"type": "User",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null
},
"client": {
"userAgent": {
"rawUserAgent": "python-requests/2.34.2",
"os": "Unknown",
"browser": "UNKNOWN"
},
"zone": "null",
"device": "Unknown",
"id": null,
"ipAddress": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
}
},
"device": null,
"authenticationContext": {
"authenticationProvider": null,
"credentialProvider": null,
"credentialType": null,
"issuer": null,
"interface": null,
"authenticationStep": 0,
"rootSessionId": "0000000000000000000000046",
"externalSessionId": "00000000000000000000"
},
"displayMessage": null,
"eventType": "iam.role.update",
"outcome": {
"result": "SUCCESS",
"reason": null
},
"published": "2026-07-02T18:55:06.774Z",
"securityContext": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com",
"isProxy": false,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
},
"severity": "INFO",
"debugContext": {
"debugData": {
"requestId": "00000000000000000000",
"dtHash": "0000000000000000000000000000000000000000000000000000000000000000",
"requestUri": "/api/v1/iam/roles/cr000000000000000005",
"url": "/api/v1/iam/roles/cr000000000000000005?"
}
},
"legacyEventType": null,
"transaction": {
"type": "WEB",
"id": "00000000000000000000",
"detail": {
"rootApiTokenId": "00T00000000000000005",
"requestApiTokenId": "00T00000000000000005"
}
},
"uuid": "00000000-0000-0000-0000-000000000000",
"version": "0",
"request": {
"ipChain": [
{
"ip": "203.0.113.10",
"geographicalContext": {
"city": "Anytown",
"state": "Anystate",
"country": "Placeholderland",
"postalCode": "00000",
"geolocation": {
"lat": 0.0,
"lon": 0.0
}
},
"version": "V4",
"source": null,
"ipDetails": {
"asNumber": 0,
"asOrg": "example-as-org",
"isp": "example-isp",
"domain": "example.com"
}
}
]
},
"target": [
{
"id": "00000000000000000000",
"type": "Role",
"alternateId": "user@dw-harness.example",
"displayName": "DW Harness",
"detailEntry": null,
"changeDetails": {
"from": {
"customRoleDescription": "dw harness throwaway",
"customRoleName": "dw-harn-eeb5dfe9-role"
},
"to": {
"customRoleDescription": "upd",
"customRoleName": "dw-harn-eeb5dfe9-role-upd"
}
}
}
]
}