Skip to main content

group

In the Security365 Management Center's group management menu, you can manage the overall group lifecycle within the organization, including registration, inquiry, modification, and deletion of groups.

Table of Contents

Basic Features

  1. Screen Configuration
  2. Basic Group Inquiry and Search
  3. Download Basic Group List

Basic Group Management

  1. Basic Group Registration- Individual registration, batch 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 Composition

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 where you can manage groups created by flexibly combining users and groups for policy application.


Basic Query

You can check the information of all groups registered in the basic group tab.

Verifiable information:

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

Search Function

You can search for 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 columns to display with checkboxes
  • 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.
    • Select Download: Only the information of the groups selected with checkboxes will be downloaded.
  • The CSV file includes group name, description, number of members, and last modified 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

The method for registering a basic group is divided into manual registration and synchronization.

Individual Group Registration

This is how to create a group directly in the Security365 management center.

Entry Method:

  1. 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 also be added redundantly.

Registration Procedure:

  1. Required field input
  2. bottom of the등록Button Click
  3. Registration Completion Confirmation

Group Bulk Registration

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

Entry Method:

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

Bulk Registration Process:

Step 1: Prepare CSV file

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

CSV file format:

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

Column Description:

columnEssentialExplanationexample
GroupNameOGroup NameHeadquarters
GroupIdOGroup Unique IDROOT
Description-Group DescriptionHeadquarters Group
ParentGroupId-Parent Group ID (empty value/Top/Root = highest level)ROOT

Step 2: Upload CSV File

  1. Drag and drop the created CSV file or파일 선택Upload with button
  2. Displays data for valid/error items by validating the CSV file.
  • For error items, you can download and check which row has what error.
    • If there are multiple errors in a line, they are indicated separated by semicolons (;).
  1. Select processing options.

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

  • delete: Automatically deletes existing groups not included in the CSV file.
    • Only empty groups (groups without members) can be deleted.
    • A group with members cannot be deleted.
  • maintenance: Keeps the status of the existing group as is.
    • It is recommended during the first synchronization or when updating only some groups.
  1. To continue bulk 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 CSV format:

GroupName,GroupId,Description,ParentGroupId,STATUS,CHANGED_FIELDS
본사,ROOT,본사 그룹,,CREATED,
영업본부,DEPT001,영업 담당,ROOT,UPDATED,description
개발본부,DEPT002,개발 담당,ROOT,UNCHANGED,
STATUSExplanation
CREATEDNewly Created Group
UPDATEDGroup with updated information (Fields changed indicated in CHANGED_FIELDS)
UNCHANGEDGroup with No Changes

Error Occurred in CSV Format:

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

⚠️ Precautions for Bulk Registration

Duplicate Handling:

  • 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 in the CSV file, the corresponding row will not be registered.

Required Information:

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

Hierarchy:

  • If you enter a group ID that does not exist in ParentGroupId, the parent group will not be registered.
  • Circular references (A's parent is B, 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 the same 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. Microsoft 365 Sync Activation
  3. Azure AD Integration Settings
  4. Synchronization Execution

5. View and Edit Basic Group Details

Detailed Information Inquiry

Entry Method:
When you click on the group you want to check in the group list, the detailed information slide will open.

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. Completion confirmation

Editable items:

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

Precautions when modifying synchronization groups:

  • Groups added through Azure AD synchronization can also be modified.
  • However, during re-synchronization, it will be overwritten with the information from Azure AD.
  • To permanently change the information of the synchronization group, it must be modified 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 with the checkbox.
  2. top of the screen삭제 아이콘Button Activation Check
  3. 삭제 아이콘Button Click
  4. In the delete confirmation popup확인Click
  5. Group deletion completed

Bulk Delete:

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

Precautions When Deleting

⚠️ Data recovery not possible:

  • Deleted group information cannot be restored.

Group Deletion Impact:

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

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 box 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 columns to display with checkboxes
  • 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: Downloads information for all policy groups currently displayed.
  • The CSV file includes group name, description, number of members, and last modified 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 groups that flexibly combine 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일반 검색selection
  2. Enter the username or group name in the search box.
  3. Select users/groups to add from search results
  4. 추가Button Click

Features:

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

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

Procedure for Using Conditional Search:

  1. In the member addition area조건 검색selection
  2. Enter field value, condition type, and condition word
  • Field values: User ID, Name, Email, Group, etc.
  • Condition types: include, start, end, match, etc.
  • Condition: Keyword to search
  1. If additional conditions are needed+Add condition by clicking the button
  2. 조건 검색Button Click
  3. Check the list of users that meet the criteria
  4. 선택Click the button to complete adding members

Search Condition Features:

  • When multiple conditions are addedsatisfy all conditionsOnly users who do (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' are 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 registration screen after group registration (continuous registration possible)
  1. Registration Completion Confirmation

10. Policy Group Detailed Information View and Edit

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 conditional search

Edit Policy Group Information

Correction Procedure:

  1. Edit information to be changed
  2. bottom of the저장Button Click
  3. Completion confirmation

Editable items:

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

Caution when modifying search condition 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 apply 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삭제 아이콘Button Activation Check
  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삭제 아이콘Button Click
  3. In the delete confirmation popup확인Click
  4. All selected policy groups have been deleted.

Precautions When Deleting

⚠️ Data recovery not possible:

  • Deleted policy group information cannot be restored.
  • Before deletion, please review the data backup.

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 specified 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

The entire file is rejected, and registration is not possible.

Error CodeError NameExplanationSolution
2700CSV_FILE_UPLOAD_REQUIREDCSV file is not uploadedPlease select and upload a CSV file.
2701CSV_PARSE_ERRORException occurred while parsing CSVCheck the CSV file format (comma-separated, quote handling, etc.)
2702CSV_ENCODING_UNSUPPORTEDUnsupported encodingPlease save the file with UTF-8 encoding and upload it again.
2703CSV_HEADER_MISMATCHHeader MismatchCheck if the required headers (GroupName, GroupId) are included.
2705CSV_FILE_EMPTYempty fileUpload a CSV file containing data
2706CSV_FILE_SIZE_LIMIT_EXCEEDEDFile size exceeded (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 uploading the file again after saving 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

Errors occurring in individual rows of the CSV file. Rows with errors are excluded, and the rest are processed normally.

Error CodeExplanationSolution
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 existsPlease enter the group ID that exists in ParentGroupId.
CIRCULAR_REFERENCECircular Reference DetectionModify 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 NameExplanationSolution
2712SYNC_JOB_NOT_FOUNDCannot find the taskCheck the task ID
2713SYNC_JOB_ID_FORMAT_INVALIDInvalid job ID formatUse the correct task ID.
2714SYNC_JOB_ALREADY_REQUESTEDConcurrent Requests (Lock Conflict)Wait until the previous request is completed.
2715SYNC_JOB_ALREADY_RUNNINGAlready runningPlease wait until the currently running task is completed.