Lithnet Access Manager
PricingRequest a trial or quoteDownloads
v3.0
v3.0
  • Home
  • How does Lithnet Access Manager help prevent lateral movement?
  • Access Manager Editions
  • Licensing
  • What's new in Access Manager v3
  • Change log
  • Installation
    • Getting started
    • System Requirements
    • Downloads
    • Upgrading from Access Manager v1
    • Upgrading from Access Manager v2
      • Considerations for migrating from Access Manager v2
    • Installing the Access Manager Server
      • Creating a service account for the Access Manager Service
      • SQL installation options
      • Installing the Access Manager Service
      • High availability options
        • Load balancing Access Manager
    • Installing the Access Manager Agent
      • Enabling agent support on the AMS server
      • Installing the Access Manager Agent on Windows
      • Installing the Access Manager Agent on Linux
      • Installing the Access Manager Agent on macOS
  • Configuration
    • Setting up Authentication
      • Setting up authentication with ADFS
      • Setting up authentication with Microsoft Entra ID
      • Setting up authentication with Okta
      • Setting up smart card authentication
      • Setting up integrated windows authentication
    • Deploying Features
      • Setting up RapidLAPS
      • LAPS
        • Setting up Microsoft LAPS for Active Directory
        • Setting up Microsoft LAPS for Entra
        • Setting up Lithnet LAPS
      • Just-in-time Authentication (JIT)
        • Setting up JIT for computers
        • Setting up JIT for roles
      • Setting up BitLocker access
        • Setting up access to BitLocker keys stored in Active Directory
        • Setting up BitLocker recovery key backup and access using the Access Manager Agent
    • Importing authorization rules
      • Import Microsoft LAPS permissions from Active Directory
      • Importing BitLocker permissions from Active Directory
      • Importing local administrator group membership from domain-joined Windows devices
      • Import mappings from a CSV file
      • Performing an offline discovery of local admins
  • Help and support
    • Frequently asked Questions
    • Troubleshooting
    • Quick start guides
      • Getting started with Windows LAPS and Lithnet Access Manager
      • Getting started with Windows LAPS for Active Directory
      • Getting started with Windows LAPS for Microsoft Entra
      • Getting started with RapidLAPS
    • Product lifecycle
    • Choosing between the Lithnet and Microsoft agent for LAPS
    • Support Articles
      • KB000001: The Access Manager Agent cannot connect and logs a token-validation-failed error
      • KB000002: Users retain their admin rights after their JIT period expires
      • KB000003: Configuring the Access Manager Agent to manage an account other than 'root' on Linux
      • KB000004: Creating a log file to troubleshoot installation issues with the Access Manager Service
      • KB000005: Access Manager stops working after applying the November 2022 Windows update
      • KB000006: Migrating the Access Manager Database
      • KB000007: Adding JIT groups via Group Policy doesn't work with NTLM Disabled
      • KB000008: AMS is unable to JIT into privileged groups such as Domain Admins
      • KB000009: Access Manager may return an out-of-date LAPS password, or no password at all
      • KB000010: The Access Manager agents fail to register on macOS 15 (Sequoia)
      • KB000011: Users report delays in obtaining just-in-time access via AD
      • KB000012: Troubleshooting Windows authentication in the Access Manager Web App
      • KB000013: Access Manager cannot be installed on Windows Server 2016 with TLS 1.0 disabled
    • Advanced help topics
      • Creating an Entra app registration or Access Manager
      • Setting up agent policies
      • Managing word lists
      • Password history retention
      • Ports and traffic flows
      • Internet access requirements
      • Access evaluation in Access Manager Service (AMS)
      • Recovering from a lost encryption certificate
      • Script-based authorization
      • Customized auditing with PowerShell notification channels
      • Variables available in audit notification channels
      • Setting up audit templates
      • Backup and Restore
      • Event ID reference
      • Group policy configuration
    • PowerShell reference
      • Add-AmsDeviceRegistrationKeyGroup
      • Add-AmsGroupMember
      • Add-AmsIdpClaimMapping
      • Clear-AmsIdpClaimMapping
      • Export-AmsServerDiagnostics
      • Get-AmsActiveDirectoryJitOptions
      • Get-AmsActiveDirectoryJitGroupCreationRule
      • Get-AmsComputerAuthorizationRule
      • Get-AmsDevice
      • Get-AmsDeviceRegistrationKey
      • Get-AmsFveRecoveryKey
      • Get-AmsGroup
      • Get-AmsGroupMembers
      • Get-AmsHostConfig
      • Get-AmsIdpClaimMapping
      • Get-AmsJitSchedulerJob
      • Get-AmsLocalAdminPassword
      • Get-AmsLocalAdminPasswordHistory
      • Get-AmsRoleAuthorizationRule
      • Get-AmsServiceConfig
      • New-AmsActiveDirectoryJitGroupCreationRule
      • New-AmsComputerAuthorizationRule
      • New-AmsDeviceRegistrationKey
      • New-AmsGroup
      • New-AmsRoleAuthorizationRule
      • Remove-AmsActiveDirectoryJitGroupCreationRule
      • Remove-AmsComputerAuthorizationRule
      • Remove-AmsDevice
      • Remove-AmsDeviceRegistrationKey
      • Remove-AmsDeviceRegistrationKeyGroup
      • Remove-AmsGroup
      • Remove-AmsGroupMember
      • Remove-AmsJitSchedulerJob
      • Remove-AmsRoleAuthorizationRule
      • Set-AmsActiveDirectoryJitGroupCreationRule
      • Set-AmsActiveDirectoryJitOptions
      • Set-AmsComputerAuthorizationRule
      • Set-AmsDevice
      • Set-AmsDeviceRegistrationKey
      • Set-AmsGroup
      • Set-AmsHostConfig
      • Set-AmsRoleAuthorizationRule
      • Set-AmsServiceConfig
    • Application help pages
      • Host configuration page
      • App Configuration
        • AMS License configuration page
        • Authentication configuration page
        • Email configuration page
        • Rate limit configuration page
        • IP Address detection configuration page
        • User interface configuration page
        • Auditing page
        • Security page
        • Database configuration page
      • Access Manager Agent
        • Access Manager Agent - Agent registration page
        • Agent Policies
          • Access Manager Agent - Windows polices page
          • Access Manager Agent - macOS polices page
          • Access Manager Agent - Linux polices page
          • Access Manager Agent - Legacy AMSv2 policies page
        • Access Manager Agent - Password settings page
        • Access Manager Agent - Devices page
        • Access Manager Agent - Groups page
      • Directory Configuration
        • Active Directory configuration page
          • Microsoft LAPS configuration page
          • Lithnet LAPS configuration page (Active Directory)
          • Just-in-time access configuration page
          • BitLocker configuration page
        • Microsoft Entra configuration page
      • Authorization Rules
        • Computer authorization rules page
        • Role authorization rules page
      • Effective access page
    • Getting Support
Powered by GitBook
On this page
  • Windows event log
  • Splunk
  • Splunk Settings
  • Global event logging
  • Notification Channels
  • Common notification channel settings
  • SMTP Channels
  • Webhook Channels
  • PowerShell Channels
  • Template variables

Was this helpful?

  1. Help and support
  2. Application help pages
  3. App Configuration

Auditing page

PreviousUser interface configuration pageNextSecurity page

Last updated 10 months ago

Was this helpful?

Access Manager always logs events to the Windows event log, but you can also have it deliver notifications via email, web hooks, or even PowerShell.

Windows event log

Audit events are always logged to the Windows event log. Access Manager allows you to customize the content of the log message using the Edit Template button.

Splunk

Access Manager can be configured to forward all audit events to Splunk via HEC (HTTP Event Collector).

You can configure connectivity to a Splunk instance using the Splunk Settings button.

Splunk Settings

Enabled

Indicates if Splunk audit log forwarding is currently enabled. If it is not enabled, audit events will not be sent to Splunk.

Required

This setting needs very careful consideration before turning this flag on. When enabled, AMS will wait to grant access to the user until the audit log is delivered to Splunk. If Splunk takes a long time to process the audit log, or connectivity to Splunk is lost, this will result in the user will be denied access to the resource they requested. Only enable this setting if auditing to the notification channel is critical.

HTTP event collector host

This is the fully-qualified domain name (FQDN) to use for connecting to the Splunk HEC endpoint.

Protocol

The protocol to use when connecting to the Splunk HEC endpoint. Defaults to HTTPS.

Optionally, you can disable certificate verification for the HEC endpoint's certificate, if required.

Port

The port to use when connecting to the Splunk HEC endpoint.

HEC token

The HEC token used to authenticate to the Splunk HEC endpoint.

This token should have the correct permissions to write to the index (with the designated sourcetype) configured below.

Target index

All audit messages delivered to Splunk will be sent to this index.

Source type

All audit messages delivered to Splunk will include this value as the sourcetype field. This field defaults to lithnet:accessmanager

Global event logging

The global settings section defines which channels should be always notified of a success or failure event. This is in addition to any notification channels defined on a specific authorization rule.

If you want to make sure a channel is notified on every success or failure, then add those channels to this list.

Notification Channels

Access Manager uses the concept of a notification channel to define what event information should be sent to where, and how it should be delivered. Notification channels are attached to authorization rules and are sent when access to a computer or role is granted or denied.

SMTP channels allow for the delivery of audit events via an HTML formatted email.

Webhooks are a convenient way to send notifications to 3rd party systems. Using a simple JSON payload, you're able to push audit information to systems that support webhooks such as Microsoft Teams and Slack.

Finally, PowerShell can be used to perform custom audit actions and send notifications to any system you can connect to from PowerShell.

Common notification channel settings

The following settings apply to all channel types

Enabled

Indicates if the notification channel is currently enabled. If it is not enabled, audit events will not be sent to this channel.

Deny the user's request if the delivery of this notification fails

This setting needs very careful consideration before turning this flag on. When enabled, AMS will wait to grant access to the user until the notification is sent. If the notification channel takes a long time to process, this will result in the user waiting a long time for their access request to process on the web page. Only enable this setting if auditing to the notification channel is critical. It is important to note that events are always logged to the Windows event log. If the request fails to log to the event log, the request is denied. So there will always be at least one record of a successful access attempt.

Display name

A friendly name that is used through the configuration tool to refer to this notification channel.

SMTP Channels

Audit message content

Edits the HTML file used as a template for an audit event.

Recipients

A list of email recipients that the audit notification should be sent to

Webhook Channels

URL

This is the webhook URL provided by the target application.

HTTP Method

Specifies the type of HTTP request to make. This will almost always be POST, but in the event that your web hook target requires another value you can specify that here.

Content-Type header

Specifies the Content-Type header used in the HTTP request. This will almost always be application/json for a JSON payload. If your web hook target requires a different value, then specify that here.

Custom HTTP headers

Specifies any additional HTTP headers to be included in the HTTP request. All header values are securely encrypted within the Access Manager database.

Clicking the Add... button will allow you to add additional headers for this webhook.

Audit message content

Edits the JSON file used as a template for an audit event.

PowerShell Channels

Script

Edit or import a PowerShell script file to execute

Template variables

You can configure HEC endpoints and tokens for use with Access Manager for both and .

For more information on creating HEC tokens for use with Access Manager, refer to the relevant documentation for either or .

AMS comes with a sample HTML template that you can customize to suit your requirements. See the page on for a list of the fields that are valid to use inside the email template.

AMS comes with sample JSON templates for Microsoft Teams and Slack that you can customize to suit your requirements. See the page on for a list of the fields that are valid to use inside the JSON template.

All notification channel types populate notification templates by replacing placeholder variables with data from the event. The page contains a full list of all valid variables that you can use throughout your templates and scripts.

Splunk Cloud
Splunk Enterprise
Splunk Cloud
Splunk Enterprise
audit variables
audit variables
audit variables