UAM Schema
Universal audit model (UAM) is Immuta's consistent structure for all Immuta system and user query audit logs. This reference guide provides example schemas of all the UAM events available in Immuta.
There are some parameter details throughout to help better understand the UAM schemas. But there are two important parameters to each event:
targetType: Informs the Immuta object that's the target of the action being audited. This will specify if it was a user, project, policy, etc. being affected by the action.action: Informs the base action being performed on the target. This will specify if something was created, deleted, updated, etc.
To learn more about Immuta's audit, see the UAM reference page or view the examples below.
Events and descriptions
API keys
ApiKeyCreated: An API key is created on the Immuta app settings page or from an Immuta user's profile page.
ApiKeyDeleted: An API key is deleted.
Attributes
AttributeApplied: An attribute is applied to a user or group.
AttributeRemoved: An attribute is removed from a user or group.
Configuration
ConfigurationUpdated: The Immuta configuration on the app settings page is updated.
Data sources
DatasourceAppliedToProject: A data source is added to a project.
DatasourceCatalogSynced: An external catalog and its tags are synced on a data source.
DatasourceCreated: A data source is created.
DatasourceDeleted: A data source is deleted.
DatasourceDisabled: A data source is disabled.
DatasourceGlobalPolicyApplied: A global policy is applied to a data source.
DatasourceGlobalPolicyConflictResolved: A policy conflict between two global policies on a data source is resolved.
DatasourceGlobalPolicyDisabled: A global policy is disabled on a data source.
DatasourceGlobalPolicyRemoved: A global policy is removed from a data source.
DatasourcePolicyCertificationExpired: The global policy certification on a data source is expired.
DatasourcePolicyCertified: A global policy is certified for a data source.
DatasourcePolicyDecertified: A global policy is decertified for a data source.
DatasourceRemovedFromProject: A data source is removed from a project.
DatasourceUpdated: A data source is updated.
Domains
DomainCreated: A domain is created.
DomainDataSourcesUpdated: Data sources are assigned to or removed from the domain.
DomainDeleted: A domain is deleted.
DomainPermissionsUpdated: A domain-specific permission is applied to or removed from a user or group.
DomainUpdated: A domain's details (name, description, settings etc.) are updated.
Global policies
GlobalPolicyApprovalRescinded (private preview): The approval for a global policy is rescinded with the approve to promote feature.
GlobalPolicyApproved (private preview): A global policy is approved with the approve to promote feature.
GlobalPolicyChangeRequested (private preview): A change to a global policy is requested with the approve to promote feature.
GlobalPolicyCreated: A global policy is created.
GlobalPolicyDeleted: A global policy is deleted.
GlobalPolicyPromoted (private preview): A global policy is promoted to production with the approve to promote feature.
GlobalPolicyReviewRequested (private preview): A review is requested for a global policy with the approve to promote feature.
GlobalPolicyUpdated: A global policy is updated.
Groups
GroupCreated: A group is created in Immuta by user actions in the UI or ingested from an external IAM.
GroupDeleted: A group is deleted in Immuta by user actions in the UI or from within an external IAM.
GroupMemberAdded: A user is added to a group in Immuta by user actions in the UI or from within an external IAM.
GroupMemberRemoved: A user is removed from a group in Immuta by user actions in the UI or from within an external IAM.
GroupUpdated: A group's details (email, name, description, etc.) are updated.
Identification
SDDClassifierCreated: An identifier is created.
SDDClassifierDeleted: An identifier is deleted.
SDDClassifierUpdated: An identifier is updated.
License
LicenseCreated: An Immuta license is created.
LicenseDeleted: An Immuta license is deleted.
Local policies
LocalPolicyCreated: A local policy is created on a data source.
LocalPolicyUpdated: A local policy is updated on a data source.
Permissions
PermissionApplied: A global permission is applied to a user.
PermissionRemoved: A global permission is removed from a user.
Projects
ProjectCreated: A project is created.
ProjectDeleted A project is deleted.
ProjectDisabled: A project is disabled.
ProjectPurposeApproved: A purpose is approved within a project.
ProjectPurposeDenied: A purpose is denied within a project.
ProjectPurposesAcknowledged: A user acknowledged a purpose within a project.
ProjectUpdated: A project is updated.
Purposes
PurposeDeleted: A purpose is deleted.
PurposeUpdated: A purpose is updated.
PurposeUpserted: A purpose is created.
Queries
DatabricksQuery: Available for Unity Catalog or Databricks Spark
Subscriptions
SubscriptionCreated: A user is subscribed to a data source or project.
SubscriptionDeleted: A user's subscription to a data source or project is removed.
SubscriptionRequestApproved: A user's request to subscribe to a data source or project is approved.
SubscriptionRequestDenied: A user's request to subscribe to a data source or project is denied.
SubscriptionRequested: A user requests to subscribe to a data source or project.
SubscriptionUpdated: A user's subscription to a data source or project is updated.
Tags
TagApplied: A tag is applied to a data source or column.
TagCreated: A tag is created.
TagDeleted: A tag is deleted.
TagRemoved: A tag is removed from a data source or column.
TagUpdated: A tag is updated.
Users
UserAuthenticated: A user signs in to Immuta.
UserCloned: A user is cloned.
UserCreated: A user is created.
UserDeleted: A user is deleted.
UserLogout: A user logs out of Immuta.
UserOneTimeTokenCreated: A sign-in token is created for a user.
UserPasswordUpdated: A user's password is updated.
UserUpdated: A user's details are updated.
Webhooks
WebhookCreated: A webhook is created.
WebhookDeleted: A webhook is deleted.
ApiKeyCreated event
Event:
ApiKeyCreatedLegacy event:
apiKeyDescription: An API key is created on the Immuta app settings page or from an Immuta user's profile page.
ApiKeyDeleted event
Event:
ApiKeyDeletedLegacy event:
apiKeyDescription: An API key is deleted.
AttributeApplied event
Event:
AttributeAppliedLegacy events:
accessUserandaccessGroupDescription: An attribute is applied to a user or group.
Additional parameter details:
targetTypewill specify whether the attribute was added to aUSERorGROUP.
AttributeRemoved event
Event:
AttributeRemovedLegacy events:
accessUserandaccessGroupDescription: An attribute is removed from a user or group.
Additional parameter details:
targetTypewill specify whether the attribute was removed from aUSERorGROUP.
ConfigurationUpdated event
Event:
ConfigurationUpdatedLegacy event:
configurationUpdateDescription: The Immuta configuration on the app settings page is updated.
DatasourceAppliedToProject event
Event:
DatasourceAppliedToProjectLegacy event:
addToProjectDescription: A data source is added to a project.
DatasourceCatalogSynced event
Event:
DatasourceCatalogSyncedLegacy event:
catalogUpdateDescription: An external catalog and its tags are synced on a data source.
DatasourceCreated event
Event:
DatasourceCreatedLegacy event:
dataSourceCreateDescription: A data source is created.
DatasourceDeleted event
Event:
DatasourceDeletedLegacy event:
dataSourceDeleteDescription: A data source is deleted.
DatasourceDisabled event
Event:
DatasourceDisabledLegacy event: None
Description: A data source is disabled.
DatasourceGlobalPolicyApplied event
Event:
DatasourceGlobalPolicyAppliedLegacy event:
globalPolicyAppliedDescription: A global policy is applied to a data source.
DatasourceGlobalPolicyConflictResolved event
Event:
DatasourceGlobalPolicyConflictResolvedLegacy event:
globalPolicyConflictResolvedDescription: A policy conflict between two global policies on a data source is resolved.
DatasourceGlobalPolicyDisabled event
Event:
DatasourceGlobalPolicyDisabledLegacy event:
globalPolicyDisabledDescription: A global policy is disabled on a data source.
DatasourceGlobalPolicyRemoved event
Event:
DatasourceGlobalPolicyRemovedLegacy event:
globalPolicyRemovedDescription: A global policy is removed from a data source.
DatasourcePolicyCertificationExpired event
Event:
DatasourcePolicyCertificationExpiredLegacy event:
policyCertificationExpiredDescription: The global policy certification on a data source is expired.
DatasourcePolicyCertified event
Event:
DatasourcePolicyCertifiedLegacy event:
globalPolicyCertifyDescription: A global policy is certified for a data source.
DatasourcePolicyDecertified event
Event:
DatasourcePolicyDecertifiedLegacy events: None
Description: A global policy is decertified for a data source.
DatasourceRemovedFromProject event
Event:
DatasourceRemovedFromProjectLegacy event:
removeFromProjectDescription: A data source is removed from a project.
DatasourceUpdated event
Event:
DatasourceUpdatedLegacy events:
dataSourceUpdateanddataSourceSaveDescription: A data source is updated.
DomainCreated event
Event:
DomainCreatedLegacy event:
collectionCreatedDescription: A domain is created.
DomainDataSourcesUpdated event
Event:
DomainDataSourcesUpdatedLegacy events:
collectionDataSourceAdded,collectionDataSourceRemoved, andcollectionDataSourceUpdatedDescription: Data sources are assigned to or removed from the domain.
Additional parameter details: auditPayload.updateType will specify whether the data source was added to or removed from the domain.
DomainDeleted event
Event:
DomainDeletedLegacy event:
collectionDeletedDescription: A domain is deleted.
DomainPermissionsUpdated event
Event:
DomainPermissionsUpdatedLegacy events:
collectionPermissionGrantedandcollectionPermissionRevokedDescription: A domain-specific permission is applied to or removed from a user or group.
Additional parameter details: auditPayload.updateType will specify whether the permission was granted to or revoked from a user.
DomainUpdated event
Event:
DomainUpdatedLegacy event:
collectionUpdatedDescription: A domain's details (name, description, settings etc.) are updated.
GlobalPolicyApprovalRescinded event
Event:
GlobalPolicyApprovalRescindedLegacy event:
globalPolicyApprovalRescindedDescription: The approval for a global policy is rescinded with the approve to promote feature (private preview).
GlobalPolicyApproved event
Event:
GlobalPolicyApprovedLegacy event:
globalPolicyApprovedDescription: A global policy is approved with the approve to promote feature (private preview).
GlobalPolicyChangeRequested event
Event:
GlobalPolicyChangeRequestedLegacy event:
globalPolicyChangeRequestedDescription: A change to a global policy is requested with the approve to promote feature (private preview).
GlobalPolicyCreated event
Event:
GlobalPolicyCreatedLegacy event:
globalPolicyCreateDescription: A global policy is created.
GlobalPolicyDeleted event
Event:
GlobalPolicyDeletedLegacy event:
globalPolicyDeleteDescription: A global policy is deleted.
GlobalPolicyPromoted event
Event:
GlobalPolicyPromotedLegacy event:
globalPolicyPromotedDescription: A global policy is promoted to production with the approve to promote feature (private preview).
GlobalPolicyReviewRequested event
Event:
GlobalPolicyReviewRequestedLegacy event:
globalPolicyReviewRequestedDescription: A review is requested for a global policy with the approve to promote feature (private preview).
GlobalPolicyUpdated event
Event:
GlobalPolicyUpdatedLegacy event:
globalPolicyUpdateDescription: A global policy is updated.
GroupCreated event
Event:
GroupCreatedLegacy event:
accessGroupDescription: A group is created in Immuta by user actions in the UI or ingested from an external IAM.
GroupDeleted event
Event:
GroupDeletedLegacy event:
accessGroupDescription: A group is deleted in Immuta by user actions in the UI or from within an external IAM.
GroupMemberAdded event
Event:
GroupMemberAddedLegacy event:
accessGroupDescription: A user is added to a group in Immuta by user actions in the UI or from within an external IAM.
GroupMemberRemoved event
Event:
GroupMemberRemovedLegacy event:
accessGroupDescription: A user is removed from a group in Immuta by user actions in the UI or from within an external IAM.
GroupUpdated event
Event:
GroupUpdatedLegacy event:
accessGroupDescription: A group's details (email, name, description, etc.) are updated.
LicenseCreated event
Event:
LicenseCreatedLegacy event:
licenseCreateDescription: An Immuta license is created.
LicenseDeleted event
Event:
LicenseDeletedLegacy event:
licenseDeleteDescription: An Immuta license is deleted.
LocalPolicyCreated event
Event:
LocalPolicyCreatedLegacy event:
policyHandlerCreateDescription: A local policy is created on a data source.
LocalPolicyUpdated event
Event:
LocalPolicyUpdatedLegacy event:
policyHandlerUpdateDescription: A local policy is updated on a data source.
PermissionApplied event
Event:
PermissionAppliedLegacy event:
accessUserDescription: A global permission is applied to a user.
PermissionRemoved event
Event:
PermissionRemovedLegacy event:
accessUserDescription: A global permission is removed from a user.
ProjectCreated event
Event:
ProjectCreatedLegacy event:
projectCreateDescription: A project is created.
ProjectDeleted event
Event:
ProjectDeletedLegacy event:
projectDeleteDescription: A project is deleted.
ProjectDisabled event
Event:
ProjectDisabledLegacy events: None
Description: A project is disabled.
ProjectPurposeApproved event
Event:
ProjectPurposeApprovedLegacy event:
projectPurposeApproveDescription: A purpose is approved within a project.
ProjectPurposeDenied event
Event:
ProjectPurposeDeniedLegacy event:
projectPurposeDenyDescription: A purpose is denied within a project.
ProjectPurposesAcknowledged event
Event:
ProjectPurposesAcknowledgedLegacy event:
acknowledgePurposesDescription: A user acknowledged a purpose within a project.
ProjectUpdated event
Event:
ProjectUpdatedLegacy event:
projectPurposeDenyDescription: A project is updated.
PurposeDeleted event
Event:
PurposeDeletedLegacy event:
purposeDeleteDescription: A purpose is deleted.
PurposeUpdated event
Event:
PurposeUpdatedLegacy event:
purposeUpdateDescription: A purpose is updated.
PurposeUpserted event
Event:
PurposeUpsertedLegacy event:
purposeCreateDescription: A purpose is created.
SDDClassifierCreated event
Event:
SDDClassifierCreatedLegacy event:
sddClassifierCreatedDescription: An identifier is created.
Additional parameter details:
auditPayload.config.columnNameRegex: For column name regex identifiers, the regex to match against column names.
auditPayload.config.values: For dictionary identifiers, the values within the dictionary to match against column values.
auditPayload.config.regex: For regex identifiers, the regex to match against column values.
SDDClassifierDeleted event
Event:
SDDClassifierDeletedLegacy event:
sddClassifierDeletedDescription: An identifier is deleted.
SDDClassifierUpdated event
Event:
SDDClassifierUpdatedLegacy event:
sddClassifierUpdatedDescription: An identifier is updated.
Additional parameter details:
auditPayload.config.columnNameRegex: For column name regex identifiers, the regex to match against column names.
auditPayload.config.values: For dictionary identifiers, the values within the dictionary to match against column values.
auditPayload.config.regex: For regex identifiers, the regex to match against column values.
SubscriptionCreated event
Event:
SubscriptionCreatedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user is subscribed to a data source or project.
Additional parameter details: auditPayload.modelType will specify whether the user was subscribed to a
DATASOURCEorPROJECT.
SubscriptionDeleted event
Event:
SubscriptionUpdatedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user's subscription to a data source or project is removed.
Additional parameter details: auditPayload.modelType will specify whether the user's subscription was removed from a
DATASOURCEorPROJECT.
SubscriptionRequestApproved event
Event:
SubscriptionUpdatedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user's request to subscribe to a data source or project is approved.
Additional parameter details: targets.model.type will specify whether the subscription was approved for a
DATASOURCEorPROJECT.
SubscriptionRequestDenied event
Event:
SubscriptionUpdatedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user's request to subscribe to a data source or project is denied.
Additional parameter details: auditPayload.modelType will specify whether the user's subscription was denied for a
DATASOURCEorPROJECT.
SubscriptionRequested event
Event:
SubscriptionRequestedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user requests to subscribe to a data source or project.
Additional parameter details: auditPayload.modelType will specify whether the user requested to subscribe to a
DATASOURCEorPROJECT.
SubscriptionUpdated event
Event:
SubscriptionUpdatedLegacy events:
dataSourceSubscriptionandprojectSubscriptionDescription: A user's subscription to a data source or project is updated.
Additional parameter details: targets.model.type will specify whether the subscription was updated on a
DATASOURCEorPROJECT.
TagApplied event
Event:
TagAppliedLegacy event:
tagAddedDescription: A tag is applied to a data source or column.
TagCreated event
Event:
TagCreatedLegacy event:
tagCreatedDescription: A tag is created.
TagDeleted event
Event:
TagDeletedLegacy event:
tagDeletedDescription: A tag is deleted.
TagRemoved event
Event:
TagRemovedLegacy event:
tagRemovedDescription: A tag is removed from a data source or column.
TagUpdated event
Event:
TagUpdatedLegacy event:
tagUpdatedDescription: A tag is updated.
UserAuthenticated event
Event:
UserAuthenticatedLegacy event:
authenticateDescription: A user signs in to Immuta.
Additional parameter details:
authenticationMethodpossible values includeOAuth: The user authenticated using the 3rd party authentication OAuth.OpenId: The user authenticated using the 3rd party authentication OpenId.SAML: The user authenticated using the 3rd party authentication SAML.apiKey: The user authenticated or impersonated using an API key. The user is running API calls and did not sign in to the UI.password: The user authenticated with username and password.
UserCloned event
Event:
UserClonedLegacy event:
accessUserDescription: A user is cloned.
UserCreated event
Event:
UserCreatedLegacy event:
accessUserDescription: A user is created.
UserDeleted event
Event:
UserDeletedLegacy event:
accessUserDescription: A user is deleted.
UserLogout event
Event:
UserLogoutLegacy events: None
Description: A user logs out of Immuta.
Additional parameter details:
authenticationMethodpossible values includeOAuth: The user authenticated using the 3rd party authentication OAuth.OpenId: The user authenticated using the 3rd party authentication OpenId.SAML: The user authenticated using the 3rd party authentication SAML.apiKey: The user authenticated or impersonated using an API key.password: The user authenticated with username and password.
logoutReasonpossible values includeEXPIRATION: The user was logged out because the token expired.IDP_INITIATED: The IdP initiated the logout.USER_LOGOUT_TRIGGERED: The user manually logged out.
UserOneTimeTokenCreated event
Event:
UserOneTimeTokenCreatedLegacy event:
accessUserDescription: A sign-in token is created for a user.
UserPasswordUpdated event
Event:
UserPasswordUpdatedLegacy event:
accessUserDescription: A user's password is updated.
UserUpdated event
Event:
UserUpdatedLegacy event:
externalUserIdChangedDescription: A user's details are updated.
WebhookCreated event
Event:
WebhookCreatedLegacy event:
webhookCreateDescription: A webhook is created.
WebhookDeleted event
Event:
WebhookDeletedLegacy event:
webhookDeleteDescription: A webhook is deleted.
Last updated
Was this helpful?

