= MediaWiki 비공개 위키 및 사용자 그룹 권한 설정 가이드 =

본 문서는 MediaWiki 1.46 기준으로 다음 권한 정책을 구성하는 방법을 설명한다.

* 비로그인 사용자는 위키 문서를 열람할 수 없다.
* 로그인 사용자는 위키 문서를 열람할 수 있다.
* 문서 작성 및 편집은 별도의 사용자 그룹에 속한 사용자만 가능하다.
* 사용자 가입은 차단하고 관리자가 계정을 생성한다.

== 1. 권한 구성 목표 ==

{| class="wikitable"
! 사용자 구분
! 문서 열람
! 문서 작성·편집
! 계정 생성
|-
| 비로그인 사용자(<code>*</code>)
| 불가
| 불가
| 불가
|-
| 일반 로그인 사용자(<code>user</code>)
| 가능
| 불가
| 불가
|-
| 편집 그룹(<code>wiki-editor</code>)
| 가능
| 가능
| 불가
|-
| 관리자(<code>sysop</code>)
| 가능
| 가능
| 가능
|}

<div class="mw-message-box mw-message-box-warning">
'''주의:''' <code>LocalSettings.php</code>를 수정하기 전에 반드시 백업한다. PHP 문법 오류가 발생하면 위키 전체가 열리지 않을 수 있다.
</div>

== 2. LocalSettings.php 백업 ==

MediaWiki 설치 경로가 <code>/var/www/mediawiki</code>인 경우의 예시이다. 실제 설치 경로에 맞게 변경한다.

<syntaxhighlight lang="bash" line>
# MediaWiki 설치 경로로 이동
cd /var/www/mediawiki

# 날짜와 시간을 붙여 LocalSettings.php 백업
cp -a LocalSettings.php "LocalSettings.php.$(date +%Y%m%d-%H%M%S).bak"

# 백업 파일 확인
ls -lh LocalSettings.php*
</syntaxhighlight>

== 3. 비공개 위키 및 편집 그룹 설정 ==

<code>LocalSettings.php</code>의 마지막 부분에 다음 설정을 추가한다.

<syntaxhighlight lang="php" line>
# ----------------------------------------------------------------------
# 비공개 위키 권한 정책
# ----------------------------------------------------------------------

# 비로그인 사용자의 문서 열람 차단
$wgGroupPermissions['*']['read'] = false;

# 비로그인 사용자의 문서 작성 및 편집 차단
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;

# 공개 회원가입 차단
$wgGroupPermissions['*']['createaccount'] = false;

# 일반 로그인 사용자는 문서 열람만 허용
$wgGroupPermissions['user']['read'] = true;
$wgGroupPermissions['user']['edit'] = false;
$wgGroupPermissions['user']['createpage'] = false;
$wgGroupPermissions['user']['createtalk'] = false;

# 편집 전용 사용자 그룹 생성 및 권한 부여
$wgGroupPermissions['wiki-editor']['read'] = true;
$wgGroupPermissions['wiki-editor']['edit'] = true;
$wgGroupPermissions['wiki-editor']['createpage'] = true;
$wgGroupPermissions['wiki-editor']['createtalk'] = true;

# 관리자는 계정 생성과 문서 편집 가능
$wgGroupPermissions['sysop']['createaccount'] = true;
$wgGroupPermissions['sysop']['read'] = true;
$wgGroupPermissions['sysop']['edit'] = true;
$wgGroupPermissions['sysop']['createpage'] = true;
$wgGroupPermissions['sysop']['createtalk'] = true;
</syntaxhighlight>

<div class="mw-message-box mw-message-box-note">
<code>wiki-editor</code>는 기본 그룹이 아니라 이 설정에서 새로 정의한 사용자 그룹이다. 그룹 이름은 영문 소문자와 하이픈 조합을 권장한다.
</div>

=== 로그인 화면 접근에 대한 참고 ===

<code>read</code> 권한을 차단해도 일반적으로 로그인 특수 문서는 접근할 수 있다. 환경 또는 확장 기능의 영향으로 로그인 화면까지 차단되는 경우에만 다음 예외를 추가한다.

<syntaxhighlight lang="php" line>
# 필요한 경우에만 비로그인 사용자에게 로그인 화면 열람 허용
$wgWhitelistRead = [ 'Special:UserLogin' ];
</syntaxhighlight>

기존에 <code>$wgWhitelistRead</code> 설정이 있다면 새 배열을 다시 선언하지 말고 기존 배열에 항목을 합쳐야 한다.

== 4. 설정 파일 문법 검사 및 적용 ==

MediaWiki 권한 설정은 <code>LocalSettings.php</code>가 요청 시 로드되므로 별도의 DB 업데이트나 웹 서버 재시작이 일반적으로 필요하지 않다. 먼저 PHP 문법을 검사한다.

<syntaxhighlight lang="bash" line>
# PHP 문법 오류 확인
php -l /var/www/mediawiki/LocalSettings.php
</syntaxhighlight>

정상 결과:

<syntaxhighlight lang="text" line>
No syntax errors detected in /var/www/mediawiki/LocalSettings.php
</syntaxhighlight>

PHP OPcache 설정에 따라 변경 사항이 즉시 반영되지 않으면 PHP-FPM을 재시작한다.

<syntaxhighlight lang="bash" line>
# 사용 중인 PHP-FPM 서비스 이름 확인
systemctl list-units --type=service | grep -E 'php.*fpm'

# Rocky Linux 기본 서비스 이름 예시
systemctl restart php-fpm

# 서비스 상태 확인
systemctl --no-pager --full status php-fpm
</syntaxhighlight>

== 5. 위키 사용자 계정 생성 ==

공개 회원가입을 차단했으므로 관리자가 계정을 생성한다.

# 관리자 계정으로 로그인한다.
# 주소창에서 <code>https://위키주소/index.php/Special:CreateAccount</code>로 이동한다.
# 사용자 이름, 비밀번호, 이메일 주소를 입력한다.
# 가능하면 임시 비밀번호를 이메일로 전송하고 최초 로그인 시 변경하도록 한다.

명령줄에서 계정을 생성해야 하는 경우 MediaWiki 설치 경로에서 유지보수 스크립트를 사용할 수 있다.

<syntaxhighlight lang="bash" line>
# MediaWiki 설치 경로로 이동
cd /var/www/mediawiki

# 현재 버전에 포함된 계정 생성 스크립트의 사용법 확인
php maintenance/createAndPromote.php --help

# 일반 사용자 계정 생성 예시
# 실행 후 암호를 입력하며, 실제 사용자 이름으로 변경한다.
php maintenance/createAndPromote.php wikiuser01
</syntaxhighlight>

<div class="mw-message-box mw-message-box-warning">
명령줄 옵션은 MediaWiki 버전에 따라 차이가 있을 수 있으므로 반드시 <code>--help</code> 결과를 먼저 확인한다. 명령 기록에 비밀번호가 남지 않도록 비밀번호를 명령행 인수로 직접 입력하지 않는다.
</div>

== 6. 사용자에게 편집 그룹 지정 ==

=== 웹 관리 화면에서 지정 ===

# 관리자 계정으로 로그인한다.
# <code>특수:사용자권한</code> 또는 <code>Special:UserRights</code>로 이동한다.
# 편집 권한을 부여할 사용자 이름을 입력하고 불러온다.
# 사용자 그룹 목록에서 <code>wiki-editor</code>를 선택한다.
# 변경 사유를 입력한다. 예: <code>기술 문서 편집 담당자 지정</code>
# 사용자 그룹 저장 버튼을 누른다.

직접 접근 주소 예시:

<syntaxhighlight lang="text" line>
https://위키주소/index.php/Special:UserRights
</syntaxhighlight>

=== 편집 권한 회수 ===

동일한 <code>특수:사용자권한</code> 화면에서 해당 사용자의 <code>wiki-editor</code> 선택을 해제하고 저장한다. 그룹을 제거해도 사용자 계정과 기존 편집 기록은 삭제되지 않는다.

== 7. 사용자 그룹 이름 한글 표시 ==

권한 화면에서 그룹 이름을 보기 좋게 표시하려면 위키의 시스템 메시지를 생성한다.

{| class="wikitable"
! 생성할 시스템 메시지 문서
! 입력 내용
|-
| <code>MediaWiki:Group-wiki-editor</code>
| 문서 편집자
|-
| <code>MediaWiki:Group-wiki-editor-member</code>
| 문서 편집자
|}

각 문서는 관리자 계정으로 생성한다. 내부 그룹 ID는 계속 <code>wiki-editor</code>를 사용하며 화면에 표시되는 명칭만 변경된다.

== 8. 권한 적용 확인 ==

권한은 서로 다른 브라우저 또는 시크릿 창을 사용하여 계정 유형별로 검사한다.

{| class="wikitable"
! 시험 항목
! 기대 결과
|-
| 로그아웃 상태에서 문서 주소 접속
| 문서 내용이 표시되지 않고 로그인 요구 또는 권한 오류 표시
|-
| 일반 사용자 로그인 후 문서 열람
| 문서 열람 가능
|-
| 일반 사용자의 문서 편집 시도
| 편집 불가
|-
| <code>wiki-editor</code> 사용자 로그인 후 기존 문서 편집
| 편집 및 저장 가능
|-
| <code>wiki-editor</code> 사용자의 새 문서 작성
| 새 문서 생성 가능
|-
| 관리자 계정의 사용자 계정 생성
| 계정 생성 가능
|}

현재 사용자에게 실제로 부여된 권한은 다음 특수 문서에서 확인한다.

<syntaxhighlight lang="text" line>
https://위키주소/index.php/Special:ListGroupRights
https://위키주소/index.php/Special:UserRights
</syntaxhighlight>

== 9. 첨부 파일 보안 주의사항 ==

<div class="mw-message-box mw-message-box-error">
'''중요:''' <code>$wgGroupPermissions['*']['read'] = false;</code>는 위키 문서 열람을 제한하지만, 기본 구성에서는 업로드 파일의 직접 URL까지 보호하지 못한다. 파일 URL을 아는 외부 사용자가 이미지나 첨부 파일에 접근할 가능성이 있다.
</div>

첨부 파일도 비공개로 운영하려면 MediaWiki의 <code>img_auth.php</code>와 웹 서버의 이미지 인증 구성을 별도로 적용해야 한다. Nginx 환경에서는 업로드 디렉터리를 직접 공개하지 않도록 구성한 뒤 내부 리다이렉트 방식으로 전달하는 구성이 필요하다. 문서 권한 설정만으로 첨부 파일까지 보호된다고 판단하면 안 된다.

== 10. 장애 발생 시 복구 ==

설정 추가 후 위키가 열리지 않으면 PHP 문법 오류 또는 변수 선언 오류를 우선 확인한다.

<syntaxhighlight lang="bash" line>
# PHP 문법 확인
php -l /var/www/mediawiki/LocalSettings.php

# Nginx 오류 로그 확인
tail -n 100 /var/log/nginx/error.log

# PHP-FPM 로그 확인
journalctl -u php-fpm -n 100 --no-pager

# 필요 시 백업 파일 목록 확인
ls -lt /var/www/mediawiki/LocalSettings.php*

# 복구할 백업 파일을 확인한 뒤 원본으로 복원
# 아래 백업 파일명은 실제 생성된 이름으로 변경한다.
cp -a /var/www/mediawiki/LocalSettings.php.20260713-120000.bak \
/var/www/mediawiki/LocalSettings.php

# 복원 파일 문법 확인
php -l /var/www/mediawiki/LocalSettings.php
</syntaxhighlight>

== 11. 운영 권장 사항 ==

* 일반 사용자에게 <code>sysop</code> 권한을 부여하지 않고 편집 전용 그룹만 사용한다.
* 입사, 담당 변경, 퇴사 시 <code>wiki-editor</code> 그룹을 즉시 추가하거나 회수한다.
* 사용자 그룹 변경 시 변경 사유를 반드시 기록한다.
* 관리자 계정과 일반 편집 계정을 분리한다.
* 권한 설정 변경 전 <code>LocalSettings.php</code>와 데이터베이스를 백업한다.
* 비공개 자료가 첨부되는 경우 업로드 파일 직접 접근 차단을 별도로 검증한다.

== 참고 자료 ==

* MediaWiki 공식 문서: https://www.mediawiki.org/wiki/Manual:Preventing_access
* MediaWiki 공식 문서: https://www.mediawiki.org/wiki/Manual:User_rights
* MediaWiki 공식 문서: https://www.mediawiki.org/wiki/Manual:$wgGroupPermissions
* MediaWiki 공식 문서: https://www.mediawiki.org/wiki/Manual:Image_Authorization

[[분류:MediaWiki]]
[[분류:서버 보안]]
[[분류:권한 관리]]

MediaWiki 권한

2026-07-13T14:11:10Z

Chnagil: 새 문서: = MediaWiki 비공개 위키 및 사용자 그룹 권한 설정 가이드 = 본 문서는 MediaWiki 1.46 기준으로 다음 권한 정책을 구성하는 방법을 설명한다. * 비로그인 사용자는 위키 문서를 열람할 수 없다. * 로그인 사용자는 위키 문서를 열람할 수 있다. * 문서 작성 및 편집은 별도의 사용자 그룹에 속한 사용자만 가능하다. * 사용자 가입은 차단하고 관리자가 계정을 생성한다. == 1...

대문

2026-07-13T13:55:06Z

Chnagil:

이곳은 일부 지인에게 공유하기 위하여 생성된 위키 입니다.

[[파일:134896534 p0.png|없음|섬네일|1024x1024픽셀]]

파일:134896534 p0.png

2026-07-13T13:54:34Z

Chnagil:

짤방

IPECS-UCP

2026-07-13T13:29:35Z

Chnagil: 스샷 왼쪽 정렬

{{DISPLAYTITLE:iPECS UCP 주장치 개통 가이드}}

<div class="wiki-notice">
'''적용 대상''' : iPECS UCP 계열 / Unified 주장치 프로그램 Issue 2.2 / SW 6.2.x 기준<br>
'''문서 목적''' : 신규 설치 또는 교체 현장에서 기본 시스템, 내선, 국선, DID, PRI·R2·SIP 및 LCR을 순서대로 개통하기 위한 실무 절차<br>
'''주의''' : 모델, 라이선스, 소프트웨어 버전 및 통신사업자 제공 조건에 따라 화면과 선택 항목이 달라질 수 있다. 특히 E1 PRI와 R2 MFC의 시그널링 값은 반드시 회선 개통내역서와 대조한다.
</div>
__TOC__

= 1. 작업 전 준비 =

== 1.1 준비 자료 ==

{| class="wikitable"
! 구분 !! 준비할 정보 !! 확인처
|-
| 시스템 || UCP 모델, SW 버전, 라이선스 파일, 주장치 IP, 게이트웨이, 서브넷 || 장비 및 구축 설계서
|-
| 내선 || 내선번호, 사용자명, 단말 종류, MAC 주소, 서비스 등급 || 내선번호 계획표
|-
| 국선 || 국선 종류, 채널 수, 국선 그룹, 발신 허용 내선 || 통신 구성표
|-
| E1 PRI || 회선 역할, 프레이밍, 라인코드, CRC, Clock, D채널, DID 자릿수, 발신번호 정책 || 통신사업자 개통내역서
|-
| R2 MFC || E1 회선 조건, 수신 DID 자릿수, CLI 요청 자릿수, DNIS/ANI, Category || 통신사업자 개통내역서
|-
| SIP || Proxy/Registrar, 도메인, 포트, 전송방식, 계정, 비밀번호, DID, 코덱 || SIP 사업자 개통내역서
|-
| 라우팅 || 대표번호, DID-내선 매핑, 주/야간 착신처, LCR 비교·변환 규칙 || 번호 라우팅 설계서
|}

== 1.2 위험 작업 및 백업 ==

<div style="border:2px solid #c62828; background:#ffebee; padding:12px; margin:12px 0;">'''경고:''' 초기화, 장치 포트 수 변경, 데이터베이스 업로드, 펌웨어 적용 및 시스템 리셋은 통화 중단을 발생시킬 수 있다. 서비스 시간 외 작업하고 현재 데이터베이스를 먼저 내려받는다.</div>

# 웹 관리자에서 '''유지보수 → 데이터베이스 관리'''로 이동한다.
# 전체 데이터베이스를 선택하여 PC에 다운로드한다.
# 파일명에 사이트명, 장비명, SW 버전, 백업 일자를 포함한다.
# 복구에 사용할 관리자 계정과 암호를 별도 보관한다.
# 변경 전후 백업을 각각 보관한다.

[[File:ucp_366_database_management.png|1200px|thumb|데이터베이스 관리 화면|없음]]

'''권장 파일명 예시'''

<syntaxhighlight lang="bash" line>
# 변경 전 데이터베이스 백업 파일
SITE_UCP2400_SW6.2_before_20260713.db

# 개통 완료 후 데이터베이스 백업 파일
SITE_UCP2400_SW6.2_after_20260713.db
</syntaxhighlight>

= 2. 권장 개통 순서 =

{| class="wikitable"
! 순서 !! 작업 !! 관련 프로그램 !! 완료 기준
|-
| 1 || 백업, 버전·라이선스 확인 || 유지보수, 시스템 개요 || 복구 파일과 라이선스 확보
|-
| 2 || 시스템 ID, 번호체계, 시간 설정 || PGM 100, 106~109, 178, 195 || 국가 코드와 다이얼 플랜 확정
|-
| 3 || 시스템·장치 IP 및 장치 등록 || PGM 101~103 || 보드와 단말 등록 정상
|-
| 4 || 내선 번호·종류·권한 설정 || PGM 105, 110~117 || 내선 상호통화 정상
|-
| 5 || 국선 보드와 국선 그룹 설정 || PGM 131~145 || 채널 상태 정상, 국선 그룹 점유 가능
|-
| 6 || PRI/R2/SIP 세부 설정 || PGM 131, 133, 143, 151, 153, 200~202, 210 || 신호·등록 상태 정상
|-
| 7 || 대표번호·DID 착신 설정 || PGM 144, 145, 167, 202, 231 || 번호별 지정 목적지 착신
|-
| 8 || 내선 그룹·교환수 설정 || PGM 164, 190, 191 || 대표·그룹 호출 정상
|-
| 9 || 발신권한·LCR 설정 || PGM 116, 117, 220~224 || 내선 등급별 발신 정상
|-
| 10 || 주·야간, 장애·복구 시험 || 관련 PGM 및 상태 화면 || 시험표 전 항목 통과
|}

= 3. 접속과 설치 마법사 =

== 3.1 웹 관리자 접속 ==

# 작업 PC를 주장치 관리망에 연결한다.
# UCP 관리 IP로 웹 브라우저를 접속한다.
# 유지보수 권한 계정으로 로그인한다.
# 최초 접속이면 기본 계정 사용 후 즉시 별도 유지보수 계정과 강력한 암호를 등록한다.
# 접속 후 시스템 모델, SW 버전, 라이선스 상태를 확인한다.

<div style="border:2px solid #c62828; background:#ffebee; padding:12px; margin:12px 0;">'''경고:''' 매뉴얼에 기재된 초기 계정과 암호를 운영 상태로 방치하지 않는다. 관리 페이지는 관리 VLAN 또는 허용된 관리 IP에서만 접근하도록 제한한다.</div>

== 3.2 설치 마법사 ==

설치 마법사는 초기 구축 시 기본 항목을 순차 설정할 수 있다. 기존 운영 장비에서는 현재 데이터를 덮어쓸 수 있으므로 개별 PGM 방식이 안전하다.

[[File:ucp_020_install_wizard.png|1200px|thumb|설치 마법사 화면|없음]]

매뉴얼 기준 설치 마법사의 주요 단계는 다음과 같다.

# 라이선스와 시스템 기본정보 확인
# 시스템 시간과 날짜 설정
# 내선번호 설정
# 국선 그룹 점유 코드, 교환수 호출 및 대리응답 코드 확인
# 유지보수 계정 등록
# 라이선스 파일 업로드

= 4. 시스템 기본 설정 =

== 4.1 시스템 ID와 국가 코드 - PGM 100 ==

메뉴 경로는 '''시스템 ID & 번호 체계 → 시스템 ID(100)'''이다.

[[File:ucp_038_pgm100_system_id.png|1200px|thumb|PGM 100 시스템 ID|없음]]

{| class="wikitable"
! 항목 !! 권장 작업 !! 확인 사항
|-
| 국가 코드 || 대한민국 적용 여부 확인 || 국가 코드 변경 시 번호체계와 기본값이 함께 바뀔 수 있음
|-
| 사이트 이름 || 현장 또는 고객사 식별명 입력 || 장애 알람과 관리 화면에서 구분 가능한 이름 사용
|-
| 지역 코드 || 실제 지역번호에 맞게 입력 || 발신번호 가공 정책과 함께 확인
|-
| 번호체계 || 국내 기본 번호체계를 기준으로 설계값 확인 || 기존 번호와 기능 코드 충돌 금지
|}

UCP에서 번호체계를 변경할 때는 국가 코드 변경용 DIP 스위치 상태를 매뉴얼과 장비 상태에 맞춰 확인한다. 변경 후에는 내선번호, 국선 점유코드 및 기능코드가 의도대로 유지됐는지 반드시 다시 조회한다.

== 4.2 장치 포트 수 - PGM 101 ==

[[File:ucp_043_pgm101_device_ports.png|1200px|thumb|PGM 101 장치 포트 수 변경|없음]]

# 시스템 개요에서 라이선스별 최대 포트 수를 확인한다.
# PGM 101에서 필요한 장치 종류와 새 포트 수를 입력한다.
# 등록 또는 저장 후 시스템 재시작 필요 여부를 확인한다.
# 재시작 후 현재 포트 수와 등록 장치 수가 일치하는지 확인한다.

<div style="border:1px solid #ef6c00; background:#fff3e0; padding:12px; margin:12px 0;">'''주의:''' 장치 포트 수 변경은 시스템 재시작 후 적용되는 항목이 포함된다. 서비스 중 임의 변경하지 않는다.</div>

== 4.3 시스템 IP 주소 - PGM 102 ==

[[File:ucp_045_pgm102_system_ip.png|1200px|thumb|PGM 102 시스템 IP 주소|없음]]

{| class="wikitable"
! 항목 !! 설정 예시 !! 확인 포인트
|-
| 시스템 IP || 192.168.10.10 || 다른 장비와 중복되지 않는 고정 IP
|-
| 서브넷 마스크 || 255.255.255.0 || 음성·관리망 설계와 일치
|-
| 기본 라우터 || 192.168.10.1 || 원격 단말 또는 SIP 사업자망 경로 확인
|-
| 부 시스템 IP || 필요 시에만 사용 || 이중망 설계가 없으면 임의 입력 금지
|-
| 자동 IP 할당 || 현장 설계에 따라 결정 || DHCP 또는 장치 자동할당 범위 중복 확인
|}

IP 변경 전 현재 접속 IP, 변경 IP, 작업 PC의 임시 IP를 기록한다. 저장 후 관리 세션이 끊어지면 작업 PC 주소를 새 관리망으로 변경하여 재접속한다.

== 4.4 장치 IP와 등록 - PGM 103 ==

[[File:ucp_047_pgm103_device_ip.png|1200px|thumb|PGM 103 장치 IP 주소와 등록 상태|없음]]

PGM 103에서는 보드·게이트웨이·IP 단말의 순번, IP, MAC 및 등록 상태를 확인한다.

* 로컬 장치는 동일 LAN의 멀티캐스트 등록이 가능한지 확인한다.
* 원격 장치는 MAC 주소를 미리 등록하고 라우팅·NAT·방화벽 조건을 확인한다.
* 장치 교체 시 기존 순번과 내선 매핑을 유지해야 하는지 먼저 결정한다.
* 등록 실패 시 시스템 IP, 장치의 시스템 주소, VLAN, 게이트웨이, MAC 오입력을 우선 확인한다.

== 4.5 내선번호 - PGM 105 ==

[[File:ucp_049_pgm105_extension_number.png|1200px|thumb|PGM 105 내선번호|없음]]

UCP는 등록 시 기본적으로 4자리 내선번호를 할당한다. PGM 105에서 실제 번호계획에 맞게 변경한다.

# 번호 변경 전 단말 순번과 기존 내선번호를 내보내거나 기록한다.
# 변경 대상 범위를 조회한다.
# 새 내선번호를 입력하고 저장한다.
# 내선 상호 호출, 발신자 표시, DSS/BLF 키 및 그룹 구성원이 새 번호로 연동되는지 확인한다.

== 4.6 번호체계 - PGM 106~109 ==

[[File:ucp_050_pgm106_numbering_plan.png|1200px|thumb|PGM 106~109 번호체계|없음]]

필수 확인 코드는 다음과 같다.

{| class="wikitable"
! 기능 !! 매뉴얼 기본 예 !! 현장 확인
|-
| 첫 번째 국선 그룹 점유 || 9 || 내선번호 또는 지역번호와 충돌 여부
|-
| 국선 그룹 사용 || 89 || 뒤에 입력할 국선 그룹 번호 체계 확인
|-
| 교환수 호출 || 시스템 설정값 확인 || 대표 교환수 내선과 연동
|-
| 대리응답 || 시스템 설정값 확인 || 대리응답 그룹 시험
|-
| 비상전화 || 별도 비상전화 테이블과 연동 || 112·119 등은 발신제한 예외 처리
|}

= 5. 내선 설정 =

== 5.1 내선 종류 - PGM 110 ==

[[File:ucp_055_pgm110_station_type.png|1200px|thumb|PGM 110 내선 종류|없음]]

단말 종류가 실제 연결 방식과 일치하는지 확인한다. 일반전화기, 디지털 키폰, IP 단말 및 SIP 단말은 등록과 기능 제공 방식이 다르다. FAX나 모뎀을 연결하는 SLT는 음성용 내선과 동일하게 일괄 설정하지 않는다.

== 5.2 내선 서비스 등급 - PGM 116 ==

[[File:ucp_074_pgm116_cos.png|1200px|thumb|PGM 116 내선 서비스 등급|없음]]

내선별 주간·야간 서비스 등급을 지정한다. 서비스 등급 번호 자체만 지정해서는 발신 제한이 완성되지 않으며 PGM 224의 허용·거부 테이블과 함께 설계해야 한다.

'''권장 등급 예시'''

{| class="wikitable"
! 등급 !! 대상 !! 허용 범위
|-
| COS 1 || 교환수·관리자 || 국내·국제·휴대전화, 업무상 필요한 전체 발신
|-
| COS 2 || 일반 사무실 || 시내·시외·휴대전화, 국제전화 제한
|-
| COS 3 || 공용·회의실 || 시내 또는 지정번호만 허용
|-
| COS 4 || FAX·설비 || 지정된 번호 유형만 허용
|}

== 5.3 국선/IP 그룹 지정 - PGM 117 ==

[[File:ucp_076_pgm117_co_group_access.png|1200px|thumb|PGM 117 국선/IP 그룹 지정|없음]]

이 화면에서 각 내선이 사용할 수 있는 국선 그룹을 지정한다.

# 일반 사용자, 교환수, FAX 및 임원 등 역할별 허용 국선 그룹을 먼저 정한다.
# 내선 범위를 조회한다.
# 사용할 국선 그룹만 허용한다.
# 주간·야간 정책이 다르면 양쪽을 각각 확인한다.
# 허용 내선과 차단 내선에서 실제 국선 점유 시험을 한다.

'''자주 발생하는 증상''' : 국선은 정상인데 특정 내선만 발신되지 않으면 PGM 117 그룹 접근권한과 PGM 116/224 발신등급을 먼저 확인한다.

= 6. 국선 보드와 공통 설정 =

== 6.1 T1/E1/PRI 보드 - PGM 131 ==

[[File:ucp_102_pgm131_e1_pri.png|1200px|thumb|PGM 131 T1/E1/PRI 특성|없음]]

PGM 131은 E1/PRI 물리·링크 조건을 설정하는 핵심 화면이다. 적용값은 회선 개통내역서를 기준으로 한다.

{| class="wikitable"
! 항목 !! 일반적인 국내 E1 PRI 검토값 !! 주의
|-
| 인터페이스 || E1/PRI || T1과 혼동 금지
|-
| 프레이밍 || 회선사 제공값 || CRC4 사용 여부 포함
|-
| 라인 코드 || HDB3 여부 확인 || 회선사와 불일치 시 동기 불가
|-
| Clock || 통신망 수신 Clock 기준 여부 확인 || 양단이 모두 Master 또는 모두 Slave가 되지 않게 구성
|-
| 시그널링 || PRI 또는 R2 || 보드와 라이선스 지원 여부 확인
|-
| D채널 || 사업자 지정 채널 || 일반적인 관행만으로 단정하지 말 것
|}

== 6.2 보드 기본 특성 - PGM 132 ==

[[File:ucp_103_pgm132_board.png|1200px|thumb|PGM 132 보드 기본 특성|없음]]

보드 순번, 장치 IP, 게이트웨이 연결상태, Web/Telnet 허용 여부 등 보드 전체에 적용되는 값을 확인한다. 관리 목적이 아니라면 불필요한 원격 관리 접근은 허용하지 않는다.

== 6.3 국선 개요와 국선 공통 특성 - PGM 140 ==

[[File:ucp_106_co_overview.png|1200px|thumb|국선 개요|없음]]

[[File:ucp_107_pgm140_co_common.png|1200px|thumb|PGM 140 국선 공통 특성|없음]]

국선 개요에서 보드 유형, 국선 유형, 포트 및 국선 그룹을 확인한 뒤 PGM 140에서 다음을 지정한다.

* 국선 사용 여부
* 국선 종류: Normal, DID, TIE 또는 사용 안 함
* 국선 그룹 번호
* 점유 방향과 순서
* ICLID/CID 처리
* LCR 적용용 LDT 테이블

채널별 설정이 다르면 동일 회선의 일부 채널만 발신 또는 착신 실패할 수 있으므로 범위 조회 후 전 채널 값을 비교한다.

= 7. E1 PRI 개통 =

== 7.1 PRI 설정 순서 ==

# PGM 101에서 필요한 E1/PRI 포트와 라이선스를 확인한다.
# PGM 103에서 보드 등록과 상태를 확인한다.
# PGM 131에서 E1 물리계층, Clock 및 PRI 시그널링을 설정한다.
# PGM 140에서 채널 사용 여부와 국선 그룹을 지정한다.
# PGM 143에서 ISDN 특성을 설정한다.
# PGM 151과 PGM 200~202에서 CLIP/COLP, 발신번호 및 DID 라우팅을 설정한다.
# 국선 상태 화면에서 Layer 1, Layer 2, D채널 상태를 확인한다.
# 착신, 발신, CID, 통화 종료 및 다채널 동시통화를 시험한다.

== 7.2 국선 ISDN 특성 - PGM 143 ==

[[File:ucp_115_pgm143_isdn.png|1200px|thumb|PGM 143 국선 ISDN 특성|없음]]

{| class="wikitable"
! 항목 !! 설정 기준 !! 검증
|-
| TEI || 회선 구성에 따른 자동 또는 지정값 || Layer 2 정상 여부
|-
| ISDN 종류 || 국내 회선 코덱·망 조건에 맞춤 || 음성 왜곡 여부
|-
| CLIP/CLIR || 발신번호 표시 정책 || 외부 휴대전화에서 표시 확인
|-
| COLP/COLR || 연결번호 표시 정책 || 전환·대표번호 환경에서 확인
|-
| ISDN Clock Sync || PGM 195 시간원과 연계할 때만 사용 || 시스템 시간 동기 확인
|}

== 7.3 CID/CPN - PGM 151 ==

[[File:ucp_125_pgm151_cid_cpn.png|1200px|thumb|PGM 151 CID/CPN 특성|없음]]

PGM 151은 국선별 CLIP/COLP 테이블, 발신번호 타입, 내선 CLI 및 DID 번호 삭제 등을 결정한다. 발신번호가 대표번호인지 내선별 DOD인지 통신사업자 정책을 먼저 확인한다.

'''발신번호 문제 확인 순서'''

# PGM 151에서 해당 국선의 CLIP 테이블과 내선 CLI 타입을 확인한다.
# PGM 201의 변환 규칙을 확인한다.
# 내선에서 설정된 CLI 번호와 국선 착신번호 전달 옵션을 확인한다.
# 통신사업자가 허용한 발신번호 형식과 자릿수를 확인한다.
# SETUP 메시지 추적이 가능하면 Calling Party Number와 Numbering Plan/Type을 확인한다.

== 7.4 ISDN 공통과 CLIP/COLP - PGM 200, 201 ==

[[File:ucp_230_pgm200_isdn_common.png|1200px|thumb|PGM 200 ISDN 특성|없음]]

[[File:ucp_231_pgm201_clip_colp.png|1200px|thumb|PGM 201 CLIP/COLP 테이블|없음]]

PGM 201은 ISDN SETUP 또는 CONNECT 메시지에 보낼 CLIP/COLP 디지트를 정의한다. 앞자리 삭제와 추가 규칙이 중복되면 잘못된 번호가 전송되므로 원본번호 → 삭제 → 추가 → 최종번호를 표로 작성하고 적용한다.

== 7.5 PRI DID와 MSN - PGM 202 ==

[[File:ucp_232_pgm202_msn.png|1200px|thumb|PGM 202 MSN 테이블|없음]]

PGM 202에서 통신망으로부터 수신되는 Called Number를 내선, 내선 그룹, 교환수 등 실제 목적지에 매핑한다.

{| class="wikitable"
! 수신번호 예시 !! 목적지 예시 !! 용도
|-
| 1000 || 내선 1000 || 직통 DID
|-
| 2000 || 내선그룹 6200 || 대표번호 그룹 착신
|-
| 9999 || 교환수 1000 || 미지정 번호 처리
|}

수신번호가 전체 번호인지 끝자리만 전달되는지는 통신사업자별로 다르다. 실제 수신 디지트를 확인한 후 정확히 일치시키거나 PGM 231에서 변환한다.

= 8. R2 MFC 개통 =

== 8.1 DCOB 국선 특성 - PGM 153 ==

[[File:ucp_130_pgm153_r2.png|1200px|thumb|PGM 153 DCOB/R2 국선 특성|없음]]

R2 MFC는 PGM 131의 E1 물리계층과 PGM 153의 R2 신호 조건을 함께 설정한다.

{| class="wikitable"
! 항목 !! 의미 !! 설정 기준
|-
| DNIS 서비스 || R2에서 착신번호 정보를 처리 || 회선사 제공 여부
|-
| CLI 번호 개수 || 망에 요청할 발신자번호 자릿수 || 회선사 제공 자릿수
|-
| DCOB 종류 || DID, DOD 또는 DID/DOD || 회선 용도
|-
| Call Category || R2 Category 신호 || 회선사 지정값
|-
| 최대 DID 수신 자릿수 || E1/R2에서 받을 최대 DID 자릿수 || 실제 제공 자릿수
|}

PGM 153의 최대 DID 수신 자릿수가 0이면 별도의 DID 수신 자릿수 설정을 따를 수 있다. 두 위치의 설정이 충돌하지 않는지 확인한다.

== 8.2 R2 장애 확인 순서 ==

{| class="wikitable"
! 증상 !! 의심 구간 !! 확인 !! 조치
|-
| E1 동기 불가 || 물리계층·Clock || LOS/AIS, 프레이밍, HDB3, CRC || PGM 131과 회선사 값 일치
|-
| 발신 점유 후 실패 || R2 방향·Category || DOD 허용, Category, 채널 상태 || PGM 140/153 수정
|-
| 착신은 되나 목적지 오류 || DID 자릿수·변환 || 실제 수신 디지트와 설정 자릿수 || PGM 153/145/231 수정
|-
| 발신번호 미표시 || CLI 요청·전송 || CLI 요청 자릿수, 사업자 제공 여부 || PGM 153과 사업자 조건 확인
|-
| 일부 채널만 실패 || 채널별 속성 || 국선 그룹·사용 여부·채널 알람 || 동일 회선 채널 설정 비교
|}

= 9. SIP 트렁크 개통 =

== 9.1 SIP 공통 특성 - PGM 210 ==

[[File:ucp_240_pgm210_sip_common.png|1200px|thumb|PGM 210 SIP 공통 특성|없음]]

SIP 공통 특성에서 전송방식, SIP 타이머, NAT/원격등록, 보안 관련 공통값을 확인한다. 인터넷에 직접 노출되는 구성에서는 원격등록 허용, 실패 임계치 및 차단 정책을 반드시 설정한다.

== 9.2 SIP 국선 특성 - PGM 133 ==

[[File:ucp_246_pgm133_sip_trunk.png|1200px|thumb|PGM 133 SIP 국선 특성|없음]]

{| class="wikitable"
! 항목 !! 입력값 예시 !! 비고
|-
| Proxy 서버 주소 || 사업자 제공 IP/FQDN || DNS 사용 시 시스템 DNS 확인
|-
| Outbound Proxy || 사업자 제공 시 ON || 제공하지 않으면 임의 활성화 금지
|-
| 도메인 || sip.example.co.kr || From/To/Request-URI 정책과 연계
|-
| UDP/TCP/TLS 포트 || 5060 또는 5061 등 제공값 || 방화벽 정책과 일치
|-
| 등록시간 || 사업자 제공값 또는 허용 범위 || 너무 길면 장애 감지가 늦어짐
|-
| 등록 사용자 테이블 || SIP 사용자 ID 인덱스 || 계정 기반 트렁크에서 사용
|-
| 코덱 || G.711u/a 등 협의값 || 착신전환 시 양단 코덱 협상 확인
|}

'''검증 항목'''

# SIP Trunk 상태에서 Registered 또는 사업자 요구 상태를 확인한다.
# OPTIONS, REGISTER 또는 INVITE가 지정 인터페이스로 송수신되는지 확인한다.
# 발신 INVITE의 From, P-Asserted-Identity, Contact, Request-URI를 확인한다.
# 착신 INVITE의 Called Number가 DID 테이블과 일치하는지 확인한다.
# 양방향 RTP, DTMF 방식, 착신전환, 통화 종료(BYE)를 시험한다.

= 10. DID와 착신 라우팅 =

== 10.1 국선/IP 착신 링 - PGM 144 ==

[[File:ucp_117_pgm144_incoming_ring.png|1200px|thumb|PGM 144 국선/IP 착신 링 지정|없음]]

일반 국선 또는 DID 분석을 사용하지 않는 인입호의 주간·야간·시간대별 착신 목적지를 지정한다. 대표 착신은 내선 하나보다 내선 그룹을 사용하는 것이 운영과 장애 대응에 유리하다.

== 10.2 다목적 DID 테이블 - PGM 231 ==

[[File:ucp_287_pgm231_did.png|1200px|thumb|PGM 231 다목적 DID 테이블|없음]]

PGM 231은 수신 DID를 비교·변환하여 목적지로 라우팅할 때 사용한다.

'''작성 예시'''

{| class="wikitable"
! 인덱스 !! 수신 DID !! 변환/목적지 !! 주간 !! 야간
|-
| 1 || 0212341000 || 대표 그룹 || 그룹 6200 || 당직 1001
|-
| 2 || 02123410XX || 끝 4자리 사용 || 해당 내선 || 해당 내선
|-
| 3 || 미매칭 || 기본 목적지 || 교환수 1000 || 안내방송/당직
|}

== 10.3 DID 수신 자릿수 적용 원칙 ==

* PRI: 실제 Q.931 Called Party Number에 포함되는 숫자를 기준으로 PGM 151, 202, 231을 설계한다.
* R2: PGM 153의 최대 DID 수신 자릿수와 DID 서비스 특성의 기대 자릿수를 함께 확인한다.
* SIP: Request-URI 또는 To 헤더 중 시스템이 분석하도록 설정된 필드의 숫자를 기준으로 한다.
* 수신번호 앞자리 삭제는 한 위치에서만 수행하는 것을 원칙으로 한다.
* 전체 대표번호와 끝자리 DID가 혼재하면 번호별 변환 흐름표를 작성한다.

= 11. 내선 그룹과 대표번호 =

== 11.1 내선 그룹 지정 - PGM 190 ==

[[File:ucp_207_pgm190_station_group.png|1200px|thumb|PGM 190 내선 그룹 지정|없음]]

# 그룹 종류와 가상번호를 정한다.
# 구성원 내선을 등록하고 순서를 확인한다.
# 교환수, 부서 대표, 음성사서함 등 용도별로 그룹을 분리한다.
# DID 또는 PGM 144의 착신 목적지를 그룹 가상번호로 지정한다.

== 11.2 내선 그룹 특성 - PGM 191 ==

[[File:ucp_208_pgm191_station_group_attr.png|1200px|thumb|PGM 191 내선 그룹 특성|없음]]

그룹 링 방식, 대기, 재호출, 무응답 목적지, 그룹통화 대기 및 보류음을 설정한다. 모든 구성원 동시링은 단말 수와 트래픽을 고려한다.

'''시험'''

* 구성원 유휴·통화중·로그아웃 상태별 인입
* 무응답 타임아웃 후 다음 구성원 또는 대체 목적지
* 주·야간 목적지 전환
* 그룹 대기 중 보류음과 통화 포기 처리

= 12. LCR과 발신 제한 =

== 12.1 LCR 제어 - PGM 220 ==

[[File:ucp_274_pgm220_lcr_control.png|1200px|thumb|PGM 220 LCR 제어 특성|없음]]

LCR은 PGM 220의 사용 모드, PGM 221의 비교 코드, PGM 222의 숫자 변경 및 PGM 224의 발신 제한이 함께 동작한다.

'''초기 적용 권장''' : 일반적인 국선 점유코드 뒤의 번호만 LCR로 처리하려면 Loop LCR부터 검토한다. 내부 다이얼까지 분석하는 모드는 내선번호와 외부번호 충돌 가능성이 있으므로 충분한 시험 후 적용한다.

== 12.2 LCR 비교 코드 - PGM 221 ==

[[File:ucp_276_pgm221_lcr_compare.png|1200px|thumb|PGM 221 LCR 비교 코드|없음]]

비교 코드는 사용자가 다이얼한 번호의 Prefix를 분석하여 적용할 숫자 변경 테이블 인덱스를 선택한다.

{| class="wikitable"
! 비교 코드 예시 !! 분류 !! 연결할 변경 테이블
|-
| 00 || 국제전화 || 국제전화용 DMT
|-
| 010 || 이동전화 || 이동전화용 DMT
|-
| 0X || 시외전화 || 시외전화용 DMT
|-
| 1XX || 특수·긴급전화 || 변경 없이 지정 국선 그룹
|}

== 12.3 숫자 변경 - PGM 222 ==

[[File:ucp_277_pgm222_lcr_digit.png|1200px|thumb|PGM 222 LCR 숫자 변경|없음]]

PGM 222에서 앞자리 삭제, 추가 숫자, 사용할 국선 그룹 및 대체 국선 그룹을 지정한다.

{| class="wikitable"
! 원 다이얼 !! 삭제 !! 추가 !! 최종 발신 !! 국선 그룹
|-
| 9-010-1234-5678 || 국선 점유코드 처리 후 0자리 || 없음 || 01012345678 || SIP 10
|-
| 9-02-1234-5678 || 0자리 || 사업자 선택번호가 있으면 추가 || 설계값 || PRI 20
|}

== 12.4 허용·거부 테이블 - PGM 224 ==

[[File:ucp_280_pgm224_allow_deny.png|1200px|thumb|PGM 224 허용/거부 테이블|없음]]

발신 제한은 긴 번호부터 구체적으로 설계하고 비상전화는 별도 허용한다. 차단 규칙만 만들고 허용 예외를 누락하지 않도록 실제 다이얼 시험표를 사용한다.

{| class="wikitable"
! 시험번호 유형 !! COS 1 !! COS 2 !! COS 3
|-
| 내선 || 허용 || 허용 || 허용
|-
| 112/119 || 허용 || 허용 || 허용
|-
| 시내 || 허용 || 허용 || 정책에 따름
|-
| 시외 || 허용 || 허용 || 차단
|-
| 이동전화 || 허용 || 허용 || 차단
|-
| 국제전화 || 허용 || 차단 || 차단
|}

= 13. 최종 시험 =

== 13.1 기본 시험표 ==

{| class="wikitable"
! 번호 !! 시험 항목 !! 정상 기준 !! 결과
|-
| 1 || 시스템 재접속 || 변경된 관리 IP로 접속 및 저장값 유지 || □ 정상 / □ 불량
|-
| 2 || 장치 등록 || 모든 보드·단말 등록, 비정상 알람 없음 || □ 정상 / □ 불량
|-
| 3 || 내선 상호통화 || 양방향 음성, 번호·이름 표시 정상 || □ 정상 / □ 불량
|-
| 4 || 대표번호 착신 || 주간 목적지와 그룹 링 정상 || □ 정상 / □ 불량
|-
| 5 || DID 착신 || 각 DID가 지정 내선으로 착신 || □ 정상 / □ 불량
|-
| 6 || 일반 발신 || 국선 그룹 선택과 발신번호 정상 || □ 정상 / □ 불량
|-
| 7 || 발신 제한 || COS별 허용·차단 정책 일치 || □ 정상 / □ 불량
|-
| 8 || PRI/R2 다채널 || 복수 동시통화 및 양방향 채널 정상 || □ 정상 / □ 불량
|-
| 9 || SIP 미디어 || 양방향 RTP, DTMF, 종료 정상 || □ 정상 / □ 불량
|-
| 10 || 착신전환 || 내부·외부 전환, CID와 코덱 정상 || □ 정상 / □ 불량
|-
| 11 || 주·야간 || 전환 후 목적지와 발신등급 정상 || □ 정상 / □ 불량
|-
| 12 || 장애복구 || 재부팅 후 등록·회선·라우팅 자동복구 || □ 정상 / □ 불량
|}

== 13.2 PRI 상태별 판단 ==

{| class="wikitable"
! 상태 !! 판단 !! 다음 확인
|-
| Layer 1 DOWN || 물리회선, 프레이밍, 라인코드, Clock 문제 가능성 높음 || 케이블·LOS/AIS·PGM 131·회선사
|-
| Layer 1 UP / Layer 2 DOWN || D채널, TEI, 망 역할 또는 프로토콜 불일치 || PGM 131/143, D채널 패킷
|-
| Layer 2 UP / 호 설정 실패 || 번호형식, 국선 그룹, 발신권한, CPN 문제 || PGM 116/117/140/151/200
|-
| 착신만 실패 || DID 자릿수·MSN·DID 변환 문제 || PGM 145/151/202/231
|}

== 13.3 변경 후 백업 ==

# 개통 시험 완료 후 전체 데이터베이스를 다시 다운로드한다.
# 변경 전 백업과 구분되는 파일명으로 저장한다.
# 시스템 모델, SW 버전, 라이선스, IP, 회선정보 및 주요 PGM 값을 개통결과서에 기록한다.
# 백업 파일의 복구 절차와 관리자 계정을 운영 담당자에게 인계한다.

= 14. 장애 분석 빠른 참조 =

{| class="wikitable"
! 증상 !! 우선 확인 PGM !! 핵심 포인트
|-
| 특정 내선만 발신 불가 || 116, 117, 224 || COS, 국선 그룹 접근, 허용·거부
|-
| 전체 내선 발신 불가 || 131/133, 140, 220~222 || 회선 상태, 국선 사용, LCR 경로
|-
| DID가 대표로만 착신 || 145, 151, 202, 231 || 실제 수신번호와 변환 규칙
|-
| 발신번호가 잘못 표시 || 151, 200, 201 || CLIP 테이블, 삭제·추가, 번호 타입
|-
| PRI D채널 불안정 || 131, 143 || Clock, 프레이밍, TEI, 회선 알람
|-
| R2 착신 디지트 누락 || 145, 153, 231 || 기대 자릿수와 최대 수신 자릿수
|-
| SIP 등록 실패 || 102, 133, 210 || 라우팅, DNS, Proxy, 인증, 포트·전송방식
|-
| SIP 통화는 되나 무음 || 102, 133, 210 || RTP 경로, NAT, 코덱, 방화벽
|-
| 그룹 착신 누락 || 190, 191 || 구성원, 로그인, 링 방식, 타임아웃
|}

= 15. 참고 및 적용 범위 =

* 참고 문서: ''iPECS eMG80/100 & eMG800 & UCP 주장치 프로그램 설명서'', Issue 2.2, 2025-04.
* 본 가이드는 매뉴얼의 메뉴와 PGM 설명을 현장 개통 순서로 재구성한 작업 문서이다.
* 화면 이미지는 해당 매뉴얼에서 개통에 필요한 프로그램 화면만 발췌하였다. 사내·유지보수 목적의 사용 범위를 확인하고 외부 공개 시 제조사 저작권 및 배포 조건을 검토한다.
* 실제 적용값은 장비 모델, SW, 라이선스, 보드 및 통신사업자 제공 조건을 우선한다.

[[index.php?title=분류:IPECS]]
[[index.php?title=분류:UCP]]
[[index.php?title=분류:PBX]]
[[index.php?title=분류:개통 가이드]]

IPECS-UCP

2026-07-13T13:26:14Z

2026-07-13T13:23:04Z

Chnagil:

파일:Ucp 115 pgm143 isdn.png

2026-07-13T13:23:00Z

Chnagil: