Audit Logging
The audit logging feature of API Gateway provides audit information for different categories of system transactions, events, and occurrences of specific events (for example, login attempts) over a period of time. You can use audit logs to view a detailed record of various auditable events that occurred on the API Gateway objects, user login and logout operations, and identify the users who are responsible for the changes. You can configure which audit events to log for a specific destination based on your auditing requirements.
You can configure API Gateway to log the auditable events for following destinations:
API Gateway![*](chapterTOC_bullet.png)
Database
![*](chapterTOC_bullet.png)
Digital Event Services (DES)
![*](chapterTOC_bullet.png)
Elasticsearch
The following auditable events can be configured to write to the API Gateway audit logs:
Access profile management eventsAccess profile management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of an Access profile object.
Alias management eventsAlias management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of an Alias object.
Analytics management eventsAnalytics management consists of the following events:
![*](chapterTOC_bullet.png)
Archiving, purging, and restoring of analytics data in the database.
API management eventsAPI management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of an API object.
![*](chapterTOC_bullet.png)
Activation and deactivation of an API.
Application management eventsApplication management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of an Application object.
Approval management eventsApproval management consists of the following events:
![*](chapterTOC_bullet.png)
Approval and rejection of a request to create, register, and modify an application.
![*](chapterTOC_bullet.png)
Approval and rejection of a request to subscribe a package in
API Portal.
Group management eventsGroup management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a Group object.
Package management eventsPackage management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a Package object.
Plan management eventsPlan management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a Plan object.
Policy managementPolicy management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a global Policy object.
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of an API level Policy object.
![*](chapterTOC_bullet.png)
Activation and deactivation of a global policy.
![*](chapterTOC_bullet.png)
Activation and deactivation of an API level policy.
Promotion management eventsPromotion management consists of the following events:
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a Stage object.
![*](chapterTOC_bullet.png)
Promotion of an API stage.
![*](chapterTOC_bullet.png)
Rollback operation of an API stage.
User management eventsUser management consists of the following events:
![*](chapterTOC_bullet.png)
A user logs in or fails to log in to
API Gateway.
![*](chapterTOC_bullet.png)
A user logs out of
API Gateway.
![*](chapterTOC_bullet.png)
Creation, modification, and deletion of a User object.
API Gateway writes the audit logging data to the Audit logs dashboard (in the API Gateway user interface, go to Analytics > Audit logs). You can view and download audit logs.
Best Practices for API Gateway Audit Logging
API Gateway's audit logging feature has been implemented on an event-driven approach. By default, the API Gateway destination is enabled to log the auditable events for all areas of management, such as APIs, policies, users, and so on. As a best practice, Software AG recommends that you enable audit logging for the required management areas in other supported destinations: Database, Digital Events, and Elasticsearch. This practice is especially important when you want to provide the audit log data to external sources for analytics and anomaly detections.