--- title: "Authentication" slug: "authentication" tags: ["Reference", "NDRC 4.x", "Customer", "Network Security", "NDR 4.x"] updated: 2026-08-19T17:24:13Z published: 2026-09-09T18:07:57Z canonical: "docs.trellix.com/authentication" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Authentication To use the NDR API, you need a valid user account on the NDR appliance with the UI/API role. You obtain a token that lasts for multiple consecutive requests. > [!NOTE] > Note > > The user account with the UI/API role must be created on the NDR appliance before you can establish a session between the remote server and the NDR appliance. For more information about setting up user accounts on the NDR appliance, see the *Network Detection and Response System Administration Guide*. By default, tokens expire after 24 hours. You can use the command-line interface (CLI) to change these defaults. For instructions on accessing the CLI, see the *Network Detection and Response System Administration Guide* or the *Network Detection and Response User Guide*. > [!NOTE] > Note > > The examples in this document use tokens. If using port 443, you can also use basic authentication in place of tokens. To check if your current session is still active, use the session request. After you have finished using the NDR API, use the log out request. > [!NOTE] > Note > > Trellix highly recommends that you log out of any session you open after you have finished. The following authentication endpoints are available: - [Authentication: Request](/network-and-platform/docs/authentication-request) `POST https://<IA_IP_address>:<port_number>/login` - [Session: Request](/network-and-platform/docs/session-request) `POST https://<IA_IP_address>:<port_number>/session` - [Log out: Request](/network-and-platform/docs/log-out-request) `POST https://<IA_IP_address>:<port_number>/logout` - [2FA state: Request](/network-and-platform/docs/2fa-state-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/state` - [Change 2FA state: Request](/network-and-platform/docs/change-2fa-state-request) `PUT https://<IA_IP_address>:<port_number>/config/v1/auth/x509/state` - [OCSP configuration: Request](/network-and-platform/docs/online-certificate-status-protocol-configuration-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/ocsp` - [Update OCSP configuration: Request](/network-and-platform/docs/update-ocsp-configuration-request) `PUT https://<IA_IP_address>:<port_number>/config/v1/auth/x509/ocsp` - [CRL configuration: Request](/network-and-platform/docs/crl-configuration-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl` - [Update CRL configuration: Request](/network-and-platform/docs/update-crl-configuration-request) `PUT https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl` - [CRL file: Request](/network-and-platform/docs/crl-file-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl/file` - [Update CRL file: Request](/network-and-platform/docs/update-crl-file-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl/file` - [Delete CRL file: Request](/network-and-platform/docs/delete-crl-file-request) `DELETE https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl/file` - [Update CRL refresh interval: Request](/network-and-platform/docs/update-crl-refresh-interval-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/crl/refresh` - [Client CA certificate configuration: Request](/network-and-platform/docs/client-ca-certificate-configuration-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/ca` - [Update CA certificate: Request](/network-and-platform/docs/update-ca-certificate-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/ca` - [Delete certificate authority: Request](/network-and-platform/docs/delete-certificate-authority-request) `DELETE https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/ca` - [Generate certificate signing request: Request](/network-and-platform/docs/generate-certificate-signing-request-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/csr` - [Replace signed client certificate: Request](/network-and-platform/docs/replace-signed-client-certificate-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/cert` - [Delete client certificate: Request](/network-and-platform/docs/delete-client-certificate-request) `DELETE https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/cert` - [Client certificate: Request](/network-and-platform/docs/client-certificate-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/cert` - [Import .p12 keystore: Request](/network-and-platform/docs/import-p12-keystore-request) `POST https://<IA_IP_address>:<port_number>/config/v1/auth/x509/client/p12` - [LDAP authentication configuration: Request](/network-and-platform/docs/ldap-authentication-configuration-request) `GET https://<IA_IP_address>:<port_number>/config/v1/auth/x509/authorization` - [Update LDAP authentication configuration: Request](/network-and-platform/docs/update-ldap-authentication-configuration-request) `PUT https://<IA_IP_address>:<port_number>/config/v1/auth/x509/authorization` - [Server certificate status: Request](/network-and-platform/docs/server-certificate-status-request) `GET https://<IA_IP_address>:<port_number>/config/v1/x509/server` - [Generate server certificate signing request: Request](/network-and-platform/docs/generate-server-certificate-signing-request-request) `POST https://<IA_IP_address>:<port_number>/config/v1/x509/server/csr` - [Upload custom server certificate: Request](/network-and-platform/docs/upload-custom-server-certificate-request) `POST https://<IA_IP_address>:<port_number>/config/v1/x509/server/cert` - [CA certificate status: Request](/network-and-platform/docs/ca-certificate-status-request) `GET https://<IA_IP_address>:<port_number>/config/v1/x509/ca` - [Upload custom CA: Request](/network-and-platform/docs/upload-custom-ca-request) `POST https://<IA_IP_address>:<port_number>/config/v1/x509/ca/cert` - [Delete custom CA: Request](/network-and-platform/docs/delete-custom-ca-request) `DELETE https://<IA_IP_address>:<port_number>/config/v1/x509/ca/cert`