Skip to main content

Group Management

The group management menu in the Security365 management center allows you to manage the overall group lifecycle within the organization, including registration, inquiry, modification, and deletion of groups.

Table of Contents​

Basic Features

  1. Screen Layout

  2. Basic Group Retrieval and Search

  3. Download Basic Group List

Basic Group Management

  1. Basic Group Registration- Individual registration, bulk registration, synchronization

  2. View and Edit Basic Group Details

  3. Delete default group

Policy Group Management

  1. Policy Group View and Search

  2. Download Policy Group List

  3. Policy Group Registration

  4. View and Edit Policy Group Details

  5. Delete Policy Group

Reference materials

  1. CSV validation error code

1. Screen Layout​

The group management screen consists of two main tabs.

Basic Group Tab​

This is a screen where you can view and manage groups created through Microsoft 365/SCI Server synchronization or manual registration.

Policy Group Tab​

This is a screen for managing groups created by flexibly combining users and groups to apply policies.

Basic Query​

You can check the information of all registered groups in the Basic Group tab.

Verifiable information:

  • Group Name
  • Group Description
  • Number of members
  • Revision Date

Search Function​

You can search for a group by its name in the search bar at the top right of the screen.

Table Customization​

You can customize the table columns by clicking the gear icon in the upper right corner of the screen.

  • Select the column to display with a checkbox.
  • Change column order by drag and drop.

3. Download Basic Group List​

You can download the basic group information as a CSV file.

Download Options​

  • 다운로드You can download the group list as a CSV file by clicking the button.
    • Download All: Downloads all group information currently displayed.
    • Selective download: Only the information of the groups selected with checkboxes will be downloaded.
  • The CSV file includes group name, description, number of members, and modification date.
    • The number of members is displayed in the format 'User(n)'.
    • If there are multiple values, they are separated by a semicolon (;).

4. Registering a Basic Group​

There are two methods for registering a basic group: manual registration and synchronization.

Individual Group Registration​

This is how to create a group directly in the Security365 Management Center.

Entry method:

  1. At the top of the basic group tab+기본 그룹 등록Button Click
  2. Display group information input form

Input item:

  • Group Name (Required)
  • Group Code (Optional)
    • If not entered, it will be automatically generated by the system.
  • Group Description (Optional)
  • Members (Optional)
    • You can add users registered in the user menu as members.
    • Users who are already added to another group can be added again.

Registration Procedure:

  1. Required field input
  2. bottom of the등록Button Click
  3. Registration completed confirmation

Group Bulk Registration​

This is how to register multiple groups at once through a CSV file.

Entry method:

  1. At the top of the basic group tab일괄등록Button Click
  2. Group Bulk Registration Slide Open

Batch Registration Process:

Step 1: Prepare the CSV file​

  1. Download the CSV template for the slide.
  2. Enter group information in the template file.

CSV file format:

GroupName,GroupId,Description,ParentGroupId
본사,ROOT,본사 그룹,
영업본부,DEPT001,영업 담당,ROOT
영업1팀,TEAM001,영업1팀,DEPT001

Column Description:

ColumnRequiredDescriptionExample
GroupNameOGroup NameHeadquarters
GroupIdOGroup Unique IDROOT
Description-Group DescriptionHeadquarters Group
ParentGroupId-Parent Group ID (Empty/Top/Root = Highest Level)ROOT

Step 2: Upload CSV file​

  1. Drag and drop the CSV file you created or파일 선택Upload with button
  2. Validates the CSV file and displays data for normal/error items.
  • In the case of error items, you can download and check which row the error occurred in.
    • If there are multiple errors in a single line, they will be indicated separated by semicolons (;).
  1. Select a processing option.

Select the method for handling existing groups not in the CSV:

  • DeleteAutomatically deletes existing groups that are not included in the CSV file.

    • Only empty groups (groups without members) will be deleted.
    • Groups with members cannot be deleted.

  • maintenance: Maintains the current state of the existing group.

    • It is recommended during the first synchronization or when updating only certain groups.

  1. To continue batch registration for normal items (valid data)등록Click the button.

  2. The registration progress status is guided by a toast message,관리 내역You can check the results in the tab.

  3. View Management Details:

  • Completion toast's관리 내역 상세 보기Button click or
  • Click on the corresponding task row in the Management History tab.

Verifiable information:

  • Registration file name
  • Type
  • Executor (Name, Email)
  • Status: Registering / Partially Registered / Registration Complete / Registration Pending
  • Download original file
  • Processing Result Statistics
    • Total count
    • Success count (new creation, update, no change, deletion, maintenance)
    • Unregistered items (items that failed to register due to a system error)

Processing result in CSV format:

GroupName,GroupId,Description,ParentGroupId,STATUS,CHANGED_FIELDS
본사,ROOT,본사 그룹,,CREATED,
영업본부,DEPT001,영업 담당,ROOT,UPDATED,description
개발본부,DEPT002,개발 담당,ROOT,UNCHANGED,
STATUSDescription
CREATEDNewly created group
UPDATEDGroup with updated information (indicate changed field names in CHANGED_FIELDS)
UNCHANGEDGroup with no changes

CSV format when an error occurs:

GroupName,GroupId,Description,ParentGroupId,STATUS,ERROR
,GROUP001,설명,ROOT,FAILED,GROUP_NAME_REQUIRED
영업팀,dup,설명,ROOT,FAILED,DUPLICATE_ID

⚠️ Precautions for Bulk Registration​

Duplicate processing:

  • If the Group in the CSV file matches the GroupId of an already registered group, it will be updated with the information from the CSV file.
  • If the same GroupId is duplicated within the CSV file, that row will not be registered.

Required Information:

  • GroupName and GroupId must be provided.
  • If required information is missing, the corresponding row will not be registered.

Hierarchical structure:

  • If a group ID that does not exist in ParentGroupId is entered, the parent group will not be registered.
  • Cyclic references (where A's parent is B and B's parent is A) are not allowed.

Asynchronous processing:

  • For large CSV files, processing occurs in the background.
  • You can use other menus while the task is in progress.
  • However, only one batch registration task can be executed at a time.

Concurrency limit:

  • Only one CSV synchronization task can be executed simultaneously per company.

Group synchronization method​

You can synchronize and add groups from external systems.

Microsoft 365 Group Synchronization​

You can automatically synchronize Microsoft 365 groups within the organization.

How to set up:

  1. 설정 > 계정 동기화 설정Menu Navigation
  2. Activate Microsoft 365 Sync
  3. Azure AD integration settings
  4. Synchronization execution

5. View and Edit Basic Group Details​

Detailed Information Inquiry​

**Entry method:**Clicking on the group you want to check in the group list will open the detailed information slide.

Verifiable information:

  • Group Name
  • Group Code
  • Group Description
  • Selected user list

Edit Group Information​

Correction Procedure:

  1. Edit information to be changed
  2. bottom of the저장Button Click
  3. Confirmation of completion of the modification.

Editable items:

  • Group Name
  • Group Code
  • Group Description
  • Members (Add/Remove Users)

Cautions when modifying a synchronization group:

  • Groups added through Azure AD synchronization can also be modified.
  • However, during resynchronization, it will be overwritten with the information from Azure AD.
  • To permanently change the information of the synchronization group, you must modify it in the source system (such as Azure AD).

6. Delete Basic Group​

You can completely remove groups that are no longer needed from the system.

Deletion Method​

Individual deletion:

  1. Select the group to delete using the checkbox.
  2. top of the screen __PH_0__삭제 아이콘Check button activation
  3. 삭제 아이콘Button Click
  4. in the delete confirmation popup확인Click
  5. Group deletion completed.

Bulk Delete:

  1. Select multiple groups to delete using checkboxes.
  2. top of the screen __PH_0__삭제 아이콘Button Click
  3. in the delete confirmation popup확인Click
  4. All selected groups have been deleted.

Precautions for Deletion​

⚠️ Data recovery not possible:

  • Deleted group information cannot be restored.

Group deletion impact:

  • Deleting a group does not delete the users belonging to that group.
  • If there is a policy applied to the group, the policy may be removed.

Basic Query​

You can check the information of all registered policy groups in the Policy Group tab.

Verifiable information:

  • Group Name
  • Group Description
  • Number of members (users, groups)
  • Revision Date

Search Function​

You can search for policy groups by group name in the search bar at the top right of the screen.

Table Customization​

You can customize the table columns by clicking the gear icon in the upper right corner of the screen.

  • Select the column to display with a checkbox.
  • Change column order by drag and drop.

8. Download Policy Group List​

You can download policy group information as a CSV file.

Download Options​

  • 다운로드You can download the policy group list as a CSV file by clicking the button.
    • Download All: Download information for all policy groups currently displayed.
  • The CSV file includes group name, description, number of members, and modification date.
    • The number of members is displayed in the format 'User(n), Group(n)'.
    • If there are multiple values, they are separated by a semicolon (;).

9. Policy Group Registration​

You can create a group that flexibly combines users and groups to apply policies.

Entry method:

  1. At the top of the policy group tab정책 그룹 등록Button Click
  2. Display policy group information input form

Input item:

  • Group Name (Required)
  • Group Description (Optional)
  • Members (Required)

How to Add Members​

There are two ways to add members to a policy group.

This is how to directly search for and add users and groups registered in the user and group menu.

Additional Procedures:

  1. In the member addition area일반 검색Select
  2. Enter the username or group name in the search box.
  3. Select users/groups to add from the search results.
  4. 추가Button Click

Features:

  • Individual user addition possible
  • It is possible to add the entire existing default group.
  • It is possible to create a policy group by grouping groups together.

This is a method to automatically add users that meet specific conditions by setting certain criteria.

Procedure for Using Conditional Search:

  1. In the member addition area조건 검색Select
  2. Enter field value, condition type, and condition.
    • Field values: User ID, Name, Email, Group, etc.
    • Condition types: include, start, end, match, etc.
    • Condition: Keyword to search
  3. If additional conditions are required+Click the button to add a condition.
  4. 조건 검색Button Click
  5. Check the list of users that meet the criteria.
  6. 선택Member addition completed by clicking the button.

Condition search features:

  • When multiple conditions are addedsatisfy all conditionsOnly users who meet the criteria will be searched (AND condition)
  • New users that meet the criteria are automatically added during Microsoft 365 synchronization.
    • For example, when setting a condition that the user ID starts with 'A', new users starting with 'A' will be automatically added during synchronization.

Registration complete​

Registration Procedure:

  1. Group information and member settings completed.
  2. bottom of the등록or등록 후 다른 정책 그룹 등록Button Click
    • 등록: Move to the list after group registration
    • 등록 후 다른 정책 그룹 등록: Keep the registration screen after group registration (continuous registration possible)
  3. Registration completed confirmation

10. View and Edit Policy Group Details​

Detailed Information Inquiry​

**Entry method:**Clicking on the group you want to check in the policy group list will open the detailed information slide.

Verifiable information:

  • Group Name
  • Group Description
  • Selected user list
  • Selected group list
  • Conditions set when generated by condition search

Edit Policy Group Information​

Correction Procedure:

  1. Edit information to be changed
  2. bottom of the저장Button Click
  3. Confirmation of completion of the modification.

Editable items:

  • Group Name
  • Group Description
  • Members (Add/Remove Users/Groups)
  • Condition Search Settings (if created via Condition Search)

Caution when modifying condition search groups:

  • Groups created through conditional search will automatically include users that meet the criteria during Microsoft 365 synchronization.
  • If you modify the conditions, the new conditions will be applied from the next synchronization.

11. Delete Policy Group​

You can completely remove policy groups that are no longer needed from the system.

Deletion Method​

Individual deletion:

  1. Select the policy group to delete using the checkbox.
  2. top of the screen __PH_0__삭제 아이콘Check button activation
  3. 삭제 아이콘Button Click
  4. in the delete confirmation popup확인Click
  5. Policy group deletion completed.

Bulk Delete:

  1. Select multiple policy groups to delete using checkboxes.
  2. top of the screen __PH_0__삭제 아이콘Button Click
  3. in the delete confirmation popup확인Click
  4. All selected policy groups have been deleted.

Precautions for Deletion​

⚠️ Data recovery not possible:

  • Deleted policy group information cannot be recovered.
  • Please review the data backup before deletion.

Impact of Deleting Policy Group:

  • Deleting a policy group does not delete the users belonging to the group or the default group.
  • If there are policies applied to the policy group, the policy application may be revoked.

12. CSV Validation Error Codes​

Here are the error codes that may occur when uploading a CSV file and their solutions.

File level error​

An error has occurred where the entire file is rejected and cannot be registered.

Error codeError NameDescriptionSolution
2700CSV_FILE_UPLOAD_REQUIREDCSV file is not uploaded.Please select and upload a CSV file.
2701CSV_PARSE_ERRORAn exception occurred while parsing the CSV.Check the CSV file format (comma-separated, quote handling, etc.)
2702CSV_ENCODING_UNSUPPORTEDUnsupported encodingPlease save the file with UTF-8 encoding and then re-upload it.
2703CSV_HEADER_MISMATCHHeader mismatchCheck if the required headers (GroupName, GroupId) are included.
2705CSV_FILE_EMPTYEmpty filePlease upload a CSV file containing data.
2706CSV_FILE_SIZE_LIMIT_EXCEEDEDFile size exceeds the limit (100MB)Please split the file into parts smaller than 100MB and upload.
2707CSV_FILE_SIZE_UNEXPECTED_EXCEPTIONAn exception occurred while retrieving the file size.Please try saving the file again and then uploading it.
2708CSV_FILE_SAVE_FAILEDFile save failedPlease try again later.
2709CSV_FILE_NOT_FOUNDFile not foundPlease re-upload the file.
2710CSV_FILE_DELETE_FAILEDFile deletion failedContact the system administrator.
2711CSV_FILE_INVALID_TYPEInvalid file typeCheck if it is a CSV file (.csv extension)

Data validation error​

This is an error occurring in individual rows of the CSV file. Rows with errors are excluded, and the rest are processed normally.

Error codeDescriptionSolution
GROUP_ID_REQUIREDMissing GroupId valuePlease enter the group ID in the GroupId column.
GROUP_NAME_REQUIREDMissing GroupName valuePlease enter the group name in the GroupName column.
PARENT_GROUP_NOT_FOUNDNo parent group exists.Please enter the group ID that exists in ParentGroupId.
CIRCULAR_REFERENCECircular Reference DetectionPlease modify to prevent circular references in the group hierarchy.
DUPLICATE_IDDuplicate GroupId within CSVRemove duplicate GroupId or change it to a unique value.
CSV_RECORD_SIZE_MISMATCHHeader and data column count mismatchCheck if the number of columns in each row matches the header.

Execution error​

This is a system-level error that occurs during task execution.

Error codeError NameDescriptionSolution
2712SYNC_JOB_NOT_FOUNDCannot find the task.Check the job ID.
2713SYNC_JOB_ID_FORMAT_INVALIDInvalid job ID formatUse a valid work ID.
2714SYNC_JOB_ALREADY_REQUESTEDConcurrent requests (lock contention)Please wait until the previous request is completed.
2715SYNC_JOB_ALREADY_RUNNINGAlready runningPlease wait until the currently running task is completed.