😎 What is Hamonize?

하모나이즈는 개방형 OS 및 윈도우 OS를 사용하는 원격지의 PC들을 통합관리 할 수 있는 솔루션입니다.
하모나이즈 프로젝트는 (1) 하모나이즈 센터 (2) 하모나이즈 에이전트 (3) 하모나이즈 어드민 (4) 하모나이즈 커넥터 등으로 구성되어 있습니다.

하모나이즈 센터는 크게 세가지의 기능을 갖고 있습니다.

• 첫번째로 관리자가 원격지의 대상 PC들에게 백업및 복구 프로그램 설치 차단 등의 정책을 내리고 정책이 정상적으로 내려졌는지 수행결과를 볼 수 있습니다.
• 두번째로 원격지 PC들의 실시간 CPU memory 등의 사용량을 한눈에 확인하고 자원을 관리할 수 있습니다.
• 세번째로 원격지의 PC에 원격 접속을 하여 문제가 생겼을 경우 즉각적이고 효율적으로 대응을 할 수 있습니다.

하모나이즈 에이전트는 별도의 화면 없이 하모나이즈 센터에서 내린 정책을 수행하고 수행결과를 보내는 역할을 합니다.

하모나이즈 어드민에서는 하모나이즈 센터에서 원격접속을 할 수 있도록 기능을 제공하고 별도로 하모나이즈 어드민 데스크탑 어플리케이션을 통해서도 연결된 원격지의 PC들의 원격제어 세션관리 전원 관리 등의 기능을 할 수 있습니다.

📕 자세한 사용법을 알고싶으면 사용자 매뉴얼를 참고하세요.

📌 Hamonize 신뢰성

하모나이즈는 외부 공인시험 인증기관을 통해 GS인증 1등급의 소프트웨어 품질인증을 받은 기술로 사용자가 신뢰할 수 있는 소프트웨어 품질을 제공합니다. Hamonize official homepage

📌 Hamonize Program OS 지원

OS 구분	Description
HamoniKR OS 4.0 Jin	Hamonize (Connector 프로그램 Agent 프로그램 원격관리프로그램 Usb관리 프로세스관리 ) 가능
Linux Mint 20.2	Hamonize (Connector 프로그램 Agent 프로그램 원격관리프로그램 Usb관리 프로세스관리 ) 가능
Debian bullseye	Hamonize (Connector 프로그램 Agent 프로그램 원격관리프로그램 Usb관리 프로세스관리 ) 가능
Ubuntu 20.04	Hamonize (Connector 프로그램 Agent 프로그램 원격관리프로그램 Usb관리 프로세스관리 ) 가능
Gooroom 2.4	Hamonize (Connector 프로그램 Agent 프로그램 원격관리프로그램 Usb관리 프로세스관리 ) 가능
Window 10	Hamonize (Connector 프로그램 원격관리프로그램) 가능

📌 Hamonize 사용(설치) 방법

Hamonize Server 구축 방법은 Wiki의 Hamonize 설치 안내 페이지를 참고하시기 바랍니다.

Hamonize Manager (관리자 PC)

• Hamonize-Center (Web Console)에 접속하여 원격관리대상 PC의 정보 및 정책관리 원격관리를 할 수있습니다.
• Hamonize-Admin (원격관리프로그램)으로 원격관리 대상 PC의 원격제어를 할 수 있습니다.

1. Download : Hamonize-Admin(원격관리프로그램) github release에서 OS 환경에 맞는 프로그램을 다운로드 받습니다.
2. Install : 다운로드 받은 경로에서 다음 명령어를 실행합니다. sudo apt install -y hamonize-admin*.deb
3. Config : Hamonize-Admin(원격관리프로그램) 환경 설정 방법은 해당 링크를 참조하세요.

Hamonize Client (원격 관리대상 PC)

1. Download : OS 환경에 맞는 프로그램을 다운로드받습니다. Hamonize-Connect Program Download
2. Install : 다운로드 받은 경로에서 다음 명령어를 실행합니다. sudo dpkg -i Hamonize-Connector.deb
3. Run : Command or Win key > Hamonize Connector

🎨 Features

• 하모니카OS 뿐만아니라 다양한 개방형OS와 윈도우OS까지 지원
• 하모나이즈 서비스 구동을 위한 필요 서버들을 도커로 구성하여 제공
• HMACSHA256 키 지정 hash 알고리즘으로 데이터를 암호화해 제공하여 안전한 보안성을 제공

📌 Table of Contents

• 📦 Packages

• 😎 What is Hamonize?

• 🎨 Features

• 🔗 Usecase

• 🛠 Pull Request Steps

• 👍 Contributing

• 📜 License

📦 Packages

Name	Description
Hamonize-center	Spring boot 기반의 Java 웹 프로그램

Name	Description
Hamonize-agent	Node와 Shell script 기반의 PC관리 프로그램

Name	Description
Hamonize-admin	C++ 기반의 원격관리 프로그램

Name	Description
Hamonize-connector	Electron과 Shell script기반의 PC 초기 설정 프로그램

🔗 Usecase

하모나이즈 솔루션은 국방부에서 사이버지식정보방에 설치되어 40만 국군장병이 PC를 사용하는데 적용되고 있는 솔루션입니다. (12 500대)

🛠 Pull Request Steps

Hamonize 프로젝트에 기여하시려면 아래의 순서대로 개발한 후에 PR(Pull Request)을 보내주세요.

Setup

먼저 자신의 레파지토리로 main 브랜치에서 fork를 해주세요. 그다음에 로컬 컴퓨터 환경에 clone한 다음에 개발을 진행해주세요.

git clone git@github.com:{your-own-repo}/hamonize.git

하모나이즈는 여러개의 서브 프로젝트로 이루어진 솔루션입니다.

각 프로젝트별 빌드 방법은 각 프로젝트 폴더안의 안내문(README.md)를 참고해주세요.

hamonize
│
├── hamonize-admin
├── hamonize-agent
├── hamonize-center
├── hamonize-connector
├── hamonize-noti-App
└── hamonize-vpn

Pull Request

PR을 생성하기 전에 error가 있는지 확인을 해주세요. error가 없다면 commit하고 push해주세요. 더 많은 정보를 원하시면 Contributing 문서들을 참고해주세요

• Code of Conduct

• Contributing Guideline

• Issue Guidelines

• Commit Message Template
  

  Commit Message 사용법. 
    1. 아래의 방법으로  Commit Message Templeate 설정을 합니다 
    [전역설정] git config --global commit.template <.gitmessage.txt 경로>
    [레포마다다르게 설정] git config commit.template <.gitmessage.txt 경로>
  
    2. 설정이 완료된 후 git commit template 사용방법은 
    git init 
    git add .
    git commit  >> Commit Message Template으로 지정한 형식으로 파일이 열리며 type  body  footer에 맞게 작성하시면됩니다.
    git push 
  

📜 License

하모나이즈는 여러 하위 프로젝트로 구성된 솔루션입니다. 아래 표는 각 하위 프로젝트에 대한 라이선스를 보여줍니다. 프로젝트별로 사용된 컴포넌트나 라이브러리들 대한 라이선스 공지를 보고 싶다면 각각의 디렉토리에서 NOTICE.md 파일에서 확인할 수 있습니다.

project	License	Dependencies License List
hamonize-center	Apache License 2.0	NOTICE
hamonize-agent	Apache License 2.0	NOTICE
hamonize-admin	GPL 2.0	NOTICE
hamonize-connect	Apache License 2.0	NOTICE

📜 Governance

이 프로젝트는 아래의 거버넌스 정책에 따라서 관리되고 있습니다.

• Governance

이 프로젝트는 모든 기여자들의 의사를 존중하고 어떤 종류의 기여라도 환영합니다!

Contributors

julie lee	yeji0407	Ryan-K	Eden	Kevin Kim	1942kg	Geunsik Lim	pichecker
suyun1017	rosep	khs7516	yeji980407	JamesBae	Lim Hyunjoon	choonsik	saam3

▶️ 영상으로 보는 하모나이즈

소개영상

실행방법

하모나이즈 센터 및 기타 서버들

하모나이즈 커넥터 및 하모나이즈 에이전트