Skip to main content

Local Active Directory

Menu Path: Settings > Inbound Provisioning > Local Active Directory


Table of Contents

  • Overview
  • Server Information (Local Active Directory Server Information)
  • Administrator Authentication
  • Search Options Configuration {#검색-옵션}
  • User Search Configuration
  • Automatic Synchronization
  • Manual Synchronization
  • Error Handling
  • Cautions

Overview

Synchronize users and groups registered in the internal local Active Directory (AD) server with the Security365 management center.

**Reference:**You can only enable one inbound provisioning method. If you enable local Active Directory synchronization, other methods (SCI Server, Microsoft365, CSV directory synchronization) will be disabled.

Preconditions:

  • The local AD server must be configured and accessible over the network from the Security365 server.
  • The AD server ports (LDAP default: 389 / LDAPS default: 636) must be allowed through the firewall.

Server Information (Local Active Directory Server Information)

Server Configuration

itemDescriptionInput Example
Server TypeServer Type (Non-changeable, Fixed Value)ACTIVE_DIRECTORY
Server URLAD server address (including protocol)protocol://domain:port
Base DCSearch Criteria Domain Componentdc=yourcompany

Server URL format: 프로토콜://서버주소:포트

Connection MethodDefault Portexample
LDAP (Unencrypted)389ldap://192.168.1.100:389
LDAPS (Encryption)636ldaps://192.168.1.100:636

**Reference:**Base DC specifies the top-level domain path of the organization. For example, the domain isyourcompany.comin casedc=yourcompany,dc=comInput in the format.


Administrator Authentication

itemDescription
Admin IDAD Server Administrator Account ID
Admin PasswordAD server administrator account password

To change your password**[Change]**Click the button.

**Caution:**The admin account must have read permissions for the AD directory. If permissions are insufficient, synchronization failures may occur.


Search Options Configuration

itemDescriptiondefault value
Search ScopeSearch ScopeONELEVEL
Page SizeNumber of records to fetch at once50
ReferralAD Reference Processing MethodFOLLOW
Connection Timeout (ms)Server connection timeout (milliseconds)200
Read TimeoutData Read Timeout (Milliseconds)100

Search Scope option:

OptionsDescription
ONELEVELSearch only the immediate sub-items of Base DC
SUBTREERecursively search Base DC and all sub-items

**Reference:**If the organizational structure is complex or needs to be synchronized down to all sub OUs (organizational units)SUBTREESelect. The wider the search range, the longer the synchronization time may be.

Referral options:

OptionsDescription
FOLLOWAutomatically follow and search referenced other AD servers
IGNOREIgnore references and search only on the current server.
THROWHandle as an error when a reference occurs

**Reference:**Adjust the Connection Timeout / Read Timeout values according to the network environment and the response speed of the AD server. If the values are too low, timeout errors may occur even in normal environments.


User Search Configuration

itemDescriptionInput Example
Base DNUser Search Starting Location (Distinguished Name)ou=Org1,ou=Users[ou=Org2],ou=Users

**Reference:**Enter the path of the OU (Organizational Unit) where the user account is located as the Base DN. You can specify a sub-path that is the same as or more specific than the Base DC.


Automatic Synchronization

itemDescription
Automatic SynchronizationUse / Do not use selection
Synchronization PeriodSet the time (hour/minute) to run daily when using automatic synchronization.

Manual Synchronization

After saving the settings, in the inbound provisioning list screen on the local Active Directory card,**[Manual Synchronization]**Clicking the button will immediately execute the synchronization.

**Caution:**Duplicate execution is not possible while synchronization is in progress.


Error Handling

Error SituationVerification Items
Server connection failedCheck Server URL Format and Port Number / Check Firewall Port Opening Status
Authentication failedAdmin ID / Admin Password Check / Account Lock Status Check
User/Group MissingCheck Search Scope Settings / Verify Base DC, Base DN Path
Timeout ErrorIncrease Connection Timeout / Read Timeout Value Setting

Cautions

  • The network connection between the local AD server and the Security365 server must be smooth. Please check in advance whether the ports are open in the firewall policy.
  • When using LDAPS (encrypted connection), certificate configuration may be required. Please contact the responsible team depending on your environment.
  • Even if you directly modify the synchronized user information in the management center, it will be overwritten by the original information from the AD server during the next synchronization execution. If permanent changes are needed, please make the modifications on the AD server first.
  • If the Connection Timeout / Read Timeout values are set too low, timeout errors may occur even in normal environments.
  • Only one inbound provisioning method can be activated, and if another method is already activated, it must be used after switching.