You can configure Access Manager to send audit events to Analytics Server. If you require to use any other server for auditing except Analytics Server, then you can configure Access Manager to send audit events to a Sentinel server, a Syslog server, or Novell Audit Server (on upgraded systems only).
In addition to the selectable events, device-generated alerts are automatically sent to the audit server. These Management Communication Channel events have an ID of 002e0605. All Access Manager events begin with 002e.
For information about audit event IDs and field data, see Section 30.17, Access Manager Audit Events and Data.
Access Gateway also supports sending e-mail notification to system administrators. To configure this system in Administration Console, click Devices > Access Gateways > Edit > Alerts.
NOTE:The eDirectory audit configuration remains unchanged even after you upgrade to the latest version of the Access Manager. To fetch eDirectory audit events, manually unload and re-load the audit modules. Perform this activity each time you start eDirectory.
To install and enable eDirectory packages, see Installing Novell Audit Packages in the eDirectory 8.8 SP8 Administration Guide.
By default, Access Manager is preconfigured to use syslog. If you install more than one instance of Administration Console for failover, syslog server is installed with each instance. However, if you already use a third party syslog server, you can configure Access Manager to use your audit server. If you are using Analytics Server, you can configure Access Manager to use Analytics Server’s in-built audit server.
Access Manager allows you to specify only one audit server. You still have failover if the audit server is not reachable. The failover mechanism changes based on the type of logging:
For File-based: Does not require a failover mechanism.
For Syslog: The events are sent to a local file. The syslog client must be configured for failover. For more information, see the third party syslog server documentation.
If you have a Sentinel server or a Sentinel Log Manager server, you can configure Access Manager to send the events to them.
If you have installed Analytics Server, you can configure Access Manager to send the events to Analytics Server.
This section includes the following topics:
The Secure Logging Server manages the flow of information to and from the auditing system. It receives incoming events and requests, logs information to the data store, monitors designated events, and provides filtering and notification services. It can also be configured to automatically reset critical system attributes according to a specified policy.
To specify the logging server, click Auditing.
Fill in the following fields:
Audit Messages Using: Select any one of the following:
Platform Agent (Discontinued): (Only on an Upgraded Access Manager)
Log File (Not Recommended For Production): (Only on a fresh installation of Access Manager)
The audit events are sent to a local log file. The file locations are:
On Windows:
Identity Server and ESP: "C:\Program Files(x86)\Novell\Syslog\audit_common.log"
Access Gateway: "C:\Program Files\Novell\Syslog\audit_ag.log"
On Linux:
Identity Server and ESP: /var/opt/novell/syslog/audit_common.log
Access Gateway: /var/opt/novell/syslog/audit_ag.log
Syslog: From the list, select a syslog server. The available options are:
Send to Sentinel: The audit event are sent in CSV format.
Send to Third party: The audit events are sent in JSON format.
NOTE:If Administration Console is configured as a remote Audit server for syslog, then, the audit logs are sent to the following location: /var/log/NAM_Audits.log.
Send to Analytics Server: The audit event are sent in CSV format.
Server Listening Address: Specify the IP address or DNS name of the audit logging server you want to use. By default, the system uses the primary Administration Console IP address. If you want to use a different Secure Logging Server, specify that server here. For example, if you select syslog, specify the syslog server details here.
NOTE:
If you have enabled Analytics Server cluster configuration, the virtual IP address is auto-populated. For information about cluster configuration, see Post-Installation Cluster Configuration for Analytics Server .
Access Manager supports auditing through syslog only on TCP.
On Windows, if syslog is selected for auditing, the Server Listening Address field is disabled. To specify the server details, manually install and configure the local syslog client.
Server Public NAT Address: If your auditing server is in the private network, enter Public NAT IP Address of the auditing server using which devices can reach the auditing server.
To use a Sentinel server or a Sentinel Log Manager, specify the IP address or DNS name of the Sentinel.
For more information about Sentinel, see Sentinel 7.3.
For more information about Sentinel Log Manager, see Sentinel Log Manager 1.0.
Port: Specify the port that the Platform Agents or syslog uses to connect to the Secure Logging Server.
For Platform Agent: The default secure logging server port is 1289.
For Syslog:
For Sentinel server, the default port is 1468.
For third party syslog servers, specify the configured port of that server.
For Analytics Server, specify 1468.
NOTE:If you select Sentinel server for auditing through syslog, then you must use the latest Access Manager Collector for Sentinel.
Stop Service on Audit Server Failure: Enable this option to stop the Apache services when the audit server is offline or not reachable and audit events could not be cached.
Under Management Console Audit Events, specify the system-wide events you want to audit:
Select All: Selects all of the audit events.
Health Changes: Generated whenever the health of a server changes.
Server Imports: Generated whenever a server is imported into Administration Console.
Server Deletes: Generated whenever a server is deleted from Administration Console.
Server Statistics: Generated periodically whenever statistics are generated for server.
Configuration Changes: Generated whenever you change a server configuration.
Click OK.
If you did not change the address or port of the Secure Logging Server, this completes the process. It might take up to fifteen minutes for the events you selected to start appearing in the audit files.
(Conditional) If you want to change the IP for Analytics server, you must change the IP of the primary Analytics Server. For information about changing the primary IP address, refer Section 4.5.4, Managing Details of a Cluster.
(Conditional) If Administration Console is the only Access Manager component installed on the machine and you have changed the address or port of the Secure Logging Server, complete the following steps:
For security reasons, the Novell Audit Configuration file cannot be modified using Administration Console when it is the only Access Manager component on the machine. It can only be edited by a system administrator.
For Administration Console, if syslog is selected for auditing, manually perform the following configuration: (Applicable only on SLES 11 SP4)
In the /etc/sysconfig/syslog file, change the SYSLOG_DAEMON value to rsyslog. This will change the default syslog daemon to rsyslog, if it is currently not the default syslog daemon.
Edit the /etc/rsyslog.d/nam.conf file and specify the following parameters:
Sample nam.conf file:
$InputTCPServerRun 1290 $template ForwardFormat,"<%PRI%>%TIMESTAMP:::date-rfc3164% %HOSTNAME% %syslogtag:1:32%%msg:::sp-if-no-1st-sp%%msg%\n" local0.* @@172.16.50.50:1468;ForwardFormat
This will enable local rsyslog agent to communicate to local TCP port 1290 and forward the audit message to remote server 172.16.50.50 communicating with port 1468.
Restart the local syslog daemon.
Select the audit message format and audit server type by editing the file /etc/Auditlogging.cfg.
Sample Auditlogging.cfg file:
LOGDEST=syslog FORMAT=JSON SERVERIP=127.0.0.1 SERVERPORT=1290
Restart Administration Console.
Open a terminal window, then enter the command for your platform:
Linux: /etc/init.d/novell-ac restart OR rcnovell-ac restart
Windows:
For Administration Console: net stop Tomcat7 net start Tomcat7
For Identity Server and Access Gateway: net stop Tomcat net start Tomcat
To restart syslog, run the following commands:
For SLES: rcrsyslog restart
For RHEL: systemctl restart rsyslog.service
Restart each device imported into Administration Console.
The devices (Identity Server and Access Gateway) do not start reporting events until they have been restarted.
Access Manager supports syslog for auditing. You can use Analytics Server, or a Sentinel server to send audit events. To configure syslog, see Specifying the Logging Server and Console Events.
On Linux, if you select syslog for auditing, then the syslog server configurations are automatically pushed to Identity Server and Access Gateway.
On Windows, you need to manually install the preferred syslog service and configure it to communicate to the local TCP port 1290. To configure the syslog agent to communicate with the remote syslog server, you need to manually configure the installed syslog agent on each device.
To view the prerequisites, see Upgrading Access Manager.
The following are the limitations of syslog:
On Identity Server and ESP, the events are cached to a local file during a local audit failure. The file locations:
On Windows:
Identity Server and ESP: C:\Program Files(x86)\Novell\Syslog\audit_common.log
On Linux:
Identity Server and ESP: /var/opt/novell/syslog/audit_common.log
The log forwarding of cached logs in not supported for Identity Server and ESP events.
The failover mechanism communication does not work in Access Gateway.
IMPORTANT:By default, syslog agents are configured without SSL communication with the remote audit server. You need to manually configure SSL between local syslog agent and remote syslog audit server.
By default, the local syslog agents do not cache or queue the audit events when the remote syslog audit server is not reachable. This results in the loss of audit events. It is recommended to enable cashing for audit events in the local syslog agent.On Linux, you can make use of the rsylsog’s queuing feature for caching the audit events.
A sample configuration for caching the audit event is as follows:
$WorkDirectory /rsyslog/work $ActionQueueType LinkedList $ActionQueueFileName example_fwd $ActionResumeRetryCount -1 $ActionQueueSaveOnShutdown on
You need to create the /rsyslog/work directory manually. Add this sample configuration into the /etc/rsyslog.d/nam.conf file.
NOTE:You need to manually make the changes on each component – Administration Console, Identity Server and Access Gateway.
For more information about syslog configuration, see Syslog Configuration Whitepaper.
Each device defines the events that can be enabled for auditing. For information about enabling these events, see the following:
For a listing of all the audit events logged by Access Manager, see Section 30.17, Access Manager Audit Events and Data.