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
Basic Group Management
- Basic Group Registration- Individual registration, batch registration, synchronization
- View and Edit Basic Group Details
- Delete Default Group
Policy Group Management
- Policy Group View and Search
- Download Policy Group List
- Policy Group Registration
- View and Edit Policy Group Details
- Delete Policy Group
Reference Materials
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.
2. Basic Group Inquiry and Search
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:
- Top of the basic group tab
+기본 그룹 등록Button Click - 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:
- Required field input
- bottom of the
등록Button Click - Registration Completion Confirmation
Group Bulk Registration
This is how to register multiple groups at once through a CSV file.
Entry Method:
- Top of the basic group tab
일괄등록Button Click - Group Bulk Registration Slide Open
Bulk Registration Process:
Step 1: Prepare CSV file
- Download CSV template for slides
- Enter group information in the template file
CSV file format:
GroupName,GroupId,Description,ParentGroupId
본사,ROOT,본사 그룹,
영업본부,DEPT001,영업 담당,ROOT
영업1팀,TEAM001,영업1팀,DEPT001
Column Description:
| column | Essential | Explanation | example |
|---|---|---|---|
| GroupName | O | Group Name | Headquarters |
| GroupId | O | Group Unique ID | ROOT |
| Description | - | Group Description | Headquarters Group |
| ParentGroupId | - | Parent Group ID (empty value/Top/Root = highest level) | ROOT |
Step 2: Upload CSV File
- Drag and drop the created CSV file or
파일 선택Upload with button - 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 (;).
- 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.
- To continue bulk registration for normal items (valid data)
등록Click the button. - The registration progress status is guided by a toast message,
관리 내역You can check the results in the tab. - 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,
| STATUS | Explanation |
|---|---|
| CREATED | Newly Created Group |
| UPDATED | Group with updated information (Fields changed indicated in CHANGED_FIELDS) |
| UNCHANGED | Group 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:
설정 > 계정 동기화 설정Menu Navigation- Microsoft 365 Sync Activation
- Azure AD Integration Settings
- 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:
- Edit information to be changed
- bottom of the
저장Button Click - 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:
- Select the group to delete with the checkbox.
- top of the screen
삭제 아이콘Button Activation Check 삭제 아이콘Button Click- In the delete confirmation popup
확인Click - Group deletion completed
Bulk Delete:
- Select multiple groups to delete with checkboxes
- top of the screen
삭제 아이콘Button Click - In the delete confirmation popup
확인Click - 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.
7. Policy Group View and Search
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:
- At the top of the policy group tab
정책 그룹 등록Button Click - 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.
1. General Search
This is how to directly search for and add users and groups registered in the user and group menu.
Additional Procedures:
- In the member addition area
일반 검색selection - Enter the username or group name in the search box.
- Select users/groups to add from search results
추가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.
2. Conditional Search
This is how to automatically add users that meet specific conditions by setting certain criteria.
Procedure for Using Conditional Search:
- In the member addition area
조건 검색selection - 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
- If additional conditions are needed
+Add condition by clicking the button 조건 검색Button Click- Check the list of users that meet the criteria
선택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:
- Group information and member settings completed
- bottom of the
등록or등록 후 다른 정책 그룹 등록Button Click
등록: Move to the list after group registration등록 후 다른 정책 그룹 등록: Keep registration screen after group registration (continuous registration possible)
- 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:
- Edit information to be changed
- bottom of the
저장Button Click - 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:
- Select the policy group to delete using the checkbox.
- top of the screen
삭제 아이콘Button Activation Check 삭제 아이콘Button Click- In the delete confirmation popup
확인Click - Policy group deletion completed
Bulk Delete:
- Select multiple policy groups to delete using checkboxes.
- top of the screen
삭제 아이콘Button Click - In the delete confirmation popup
확인Click - 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 Code | Error Name | Explanation | Solution |
|---|---|---|---|
| 2700 | CSV_FILE_UPLOAD_REQUIRED | CSV file is not uploaded | Please select and upload a CSV file. |
| 2701 | CSV_PARSE_ERROR | Exception occurred while parsing CSV | Check the CSV file format (comma-separated, quote handling, etc.) |
| 2702 | CSV_ENCODING_UNSUPPORTED | Unsupported encoding | Please save the file with UTF-8 encoding and upload it again. |
| 2703 | CSV_HEADER_MISMATCH | Header Mismatch | Check if the required headers (GroupName, GroupId) are included. |
| 2705 | CSV_FILE_EMPTY | empty file | Upload a CSV file containing data |
| 2706 | CSV_FILE_SIZE_LIMIT_EXCEEDED | File size exceeded (100MB) | Please split the file into parts smaller than 100MB and upload. |
| 2707 | CSV_FILE_SIZE_UNEXPECTED_EXCEPTION | An exception occurred while retrieving the file size. | Please try uploading the file again after saving it. |
| 2708 | CSV_FILE_SAVE_FAILED | File save failed | Please try again later. |
| 2709 | CSV_FILE_NOT_FOUND | File not found | Please re-upload the file. |
| 2710 | CSV_FILE_DELETE_FAILED | File deletion failed | Contact the system administrator |
| 2711 | CSV_FILE_INVALID_TYPE | Invalid file type | Check 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 Code | Explanation | Solution |
|---|---|---|
| GROUP_ID_REQUIRED | Missing GroupId value | Please enter the group ID in the GroupId column. |
| GROUP_NAME_REQUIRED | Missing GroupName value | Please enter the group name in the GroupName column. |
| PARENT_GROUP_NOT_FOUND | No parent group exists | Please enter the group ID that exists in ParentGroupId. |
| CIRCULAR_REFERENCE | Circular Reference Detection | Modify to prevent circular references in the group hierarchy. |
| DUPLICATE_ID | Duplicate GroupId within CSV | Remove duplicate GroupId or change it to a unique value. |
| CSV_RECORD_SIZE_MISMATCH | Header and data column count mismatch | Check 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 Code | Error Name | Explanation | Solution |
|---|---|---|---|
| 2712 | SYNC_JOB_NOT_FOUND | Cannot find the task | Check the task ID |
| 2713 | SYNC_JOB_ID_FORMAT_INVALID | Invalid job ID format | Use the correct task ID. |
| 2714 | SYNC_JOB_ALREADY_REQUESTED | Concurrent Requests (Lock Conflict) | Wait until the previous request is completed. |
| 2715 | SYNC_JOB_ALREADY_RUNNING | Already running | Please wait until the currently running task is completed. |