이 문서에서
dropdown icon
프로필 재동기화를 위해 휴대폰을 구성하세요
    TFTP로 전화 프로필 재동기화해요
    TFTP 서버에 전화기 전용 프로필 제공
    전화 프로필을 HTTP GET으로 재동기화해요
    전화 프로필 자동으로 재동기화해요
    프로필 재동기화 파라미터
    시스코 XML을 통한 프로비저닝
    URL 해상도 (매크로 확장 포함)
    프로필 인증 유형을 지정해 주세요.
dropdown icon
휴대폰에 프로필을 수동으로 적용해요
    TFTP 서버에서 구성 파일을 전화기로 다운로드해요
    cURL로 구성 파일을 휴대폰에 다운로드해요
dropdown icon
프로필 구성 관련 참고 자료
    구성 프로필 포맷
    오픈 프로필 압축
    오픈 프로필 암호화예요
    선택적 재동기화 인수
    데이터 타입

9800 시리즈 및 8875 폰 프로필 설정 구성 (브로드웍스)

list-menu이 문서에서
list-menu피드백이 있습니까?

이 도움말 문서는 시스코 브로드웍스에 등록된 시스코 데스크 폰 9800 시리즈와 시스코 비디오 폰 8875에 관한 거예요.이 페이지의 정보에는 프로필 재동기화, 프로필 수동 적용, 구성 구문이 포함돼요.

프로필 재동기화를 위해 휴대폰을 구성하세요

TFTP로 전화 프로필 재동기화해요

전화기가 구성 프로파일 검색을 위한 여러 네트워크 프로토콜을 지원해요. 가장 기본적인 프로필 전송 프로토콜은 TFTP (RFC1350) 예요. TFTP는 사설 LAN 네트워크 내에서 네트워크 장치를 프로비전하는 데 널리 사용돼요. 인터넷을 통한 원격 엔드포인트 배포에는 권장되지 않지만 TFTP는 소규모 조직 내 배포, 사내 사전 프로비저닝, 개발 및 테스트에 편리할 수 있어요. 다음 절차에서는 TFTP 서버에서 파일을 다운로드한 후 프로필을 수정해요.

1

LAN 환경에서 컴퓨터와 전화를 허브, 스위치 또는 소형 라우터에 연결하세요.

2

컴퓨터에 TFTP 서버를 설치하고 활성화하세요.

3

텍스트 편집기를 사용하여 구성 프로필을 만드세요.

나중에 프로필이 휴대폰에 제공되었는지 확인하려면 값 중 일부를 표시로 설정할 수 있어요. 예를 들어, 다음 예와 같이 GPP_A 값을 12345678로 설정하세요.

<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

TFTP 서버의 루트 디렉토리에 XML 구성 파일을 저장해요.

TFTP 서버가 제대로 구성되었는지 확인할 수 있어요. 전화가 아닌 TFTP 클라이언트를 사용하여 구성 프로필 파일을 요청하세요. 가급적이면, 프로비저닝 서버와 별도의 호스트에서 실행되는 TFTP 클라이언트를 사용하세요.

5

컴퓨터의 웹 브라우저에서 관리 웹 페이지를 여세요. 예를 들어, 전화의 IP 주소가 192.168.1.100이라고 가정하고 웹 브라우저에서 다음 URL을 여세요.


http://192.168.1.100/admin/advanced

6

음성 > 프로비저닝 탭을 선택하고 범용 매개변수 GPP_A~GPP_P의 값을 검사하세요. 이것들이 비어 있어야 해요.

7

웹 브라우저에서 재동기화 URL을 열어 만든 구성 프로파일에 테스트 폰을 재동기화해요.

예시:

TFTP 서버의 IP 주소가 192.168.1.200이면 명령은 다음 예와 비슷해야 해요.


http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt

전화기가 이 명령을 받으면 주소 192.168.1.100의 장치가 IP 주소 192.168.1.200의 TFTP 서버에 구성 프로필 파일 basic.txt 요청을 해요. 그러면 휴대폰이 다운로드한 파일을 파싱하고 GPP_A 매개변수를 값 12345678로 업데이트해요.

8

파라미터가 제대로 업데이트되었는지 확인하세요. 관리 웹 페이지 새로고침하고 음성 > 프로비저닝으로 가세요.

이제 GPP_A 매개변수에 12345678이라는 값이 포함되어야 해요.

TFTP 서버에 전화기 전용 프로필 제공

1

제품 라벨에서 전화의 MAC 주소를 알아요. (MAC 주소는 숫자와 소문자 16진수를 사용한 숫자예요, 예를 들면 000e08aabbcc.

2

구성 파일 이름을 CP-xxxx macaddress.cfg 로 바꾸세요 (xxxx를 모델 번호로, mac 주소를 전화의 MAC 주소로 바꾸세요).

예시:

CP-8875 000e08aabbcc.cfg

3

새 파일을 TFTP 서버의 가상 루트 디렉터리로 이동해요.

4

전화 관리 웹페이지에 접속해요.

5

음성 > 프로비저닝을 선택해요.

6

프로필 규칙 필드에 프로필 파일 경로를 입력하세요.

예: TFTP 서버 IP 주소가 192.168.1.200이고 프로필 파일 이름이 다음과 같다고 가정해 보세요.


<Profile_Rule>
tftp://192.168.1.200/CP-8875$MA.cfg
</Profile_Rule>
7

모든 변경사항 제출을 클릭해요. 이로 인해 즉시 재부팅되고 재동기화돼요.

다음 재동기화가 일어나면 전화기가 $MA 매크로 표현식을 MAC 주소로 확장해서 새 파일을 검색해요.

전화 프로필을 HTTP GET으로 재동기화해요

1

로컬 컴퓨터나 접근 가능한 다른 호스트에 HTTP 서버를 설치해요.

오픈소스 아파치 서버는 인터넷에서 다운로드할 수 있어요.

2

설치 서버의 가상 루트 디렉터리에 구성 프로파일 파일을 업로드해요.

3

서버가 제대로 설치되고 프로필 파일에 접근했는지 확인하려면 웹 브라우저로 프로필을 여세요.

4

TFTP 서버 대신 HTTP 서버를 가리키도록 테스트 전화의 Profile_Rule을 수정해서 프로필을 정기적으로 다운로드해요.

예를 들어, HTTP 서버가 192.168.1.300이고 프로필 파일 이름이 basic.txt 라고 가정하면 다음 값을 입력하세요.

<Profile_Rule>
http://192.168.1.200/basic.txt
</Profile_Rule>
5

모든 변경사항 제출을 클릭해요. 이로 인해 즉시 재부팅되고 재동기화돼요.

6

전화가 보내는 syslog 메시지를 관찰하세요. 주기적인 재동기화는 이제 HTTP 서버에서 프로필을 가져와야 해요.

7

HTTP 서버 로그에서 테스트 폰을 식별하는 정보가 사용자 에이전트의 로그에 어떻게 나타나는지 관찰하세요.

이 정보에는 제조업체, 제품 이름, 현재 펌웨어 버전, 일련 번호가 포함되어야 해요.

전화 프로필 자동으로 재동기화해요

서버에서 이루어진 모든 프로필 변경 사항이 엔드포인트 장치에 전파되도록 장치가 프로비저닝 서버에 주기적으로 재동기화될 수 있어요 (엔드포인트에 명시적인 재동기화 요청을 보내는 것과는 대조적으로).

전화가 주기적으로 서버에 재동기화되도록 하려면 Profile_Rule 매개 변수로 구성 프로필 URL을 정의하고 Resync_Periodic 매개 변수를 사용하여 재동기화 기간을 정의해요.

1

전화 관리 웹페이지에 접속해요.

2

음성 > 프로비저닝을 선택해요.

3

프로필_규칙 매개변수를 정의하세요. 이 예시에서는 TFTP 서버 IP 주소가 192.168.1.200이라고 가정해요.

4

재동기화 주기적 필드에 테스트할 작은 값 (예: 30초) 을 입력하세요.

5

모든 변경사항 제출을 클릭해요.

새 파라미터 설정을 사용하면 전화가 URL에 지정된 구성 파일에 1분에 두 번 재동기화돼요.

6

syslog 추적에서 결과 메시지를 관찰하세요.

7

재설정 시 재동기화 필드가 Yes로 설정되어 있는지 확인해 주세요.


<Resync_On_Reset>Yes</Resync_On_Reset>

8

폰 전원을 껐다가 켜서 프로비저닝 서버에 강제로 재동기화해요.

서버가 응답하지 않는 등 어떤 이유로든 재동기화 작업이 실패하면, 장치는 다시 동기화를 시도하기 전에 (재동기화 오류 재시도 지연에 구성된 시간 (초) 동안 대기해요. 재동기화 오류 재시도 지연이 0이면, 재동기화 실패 후 전화가 재동기화를 시도하지 않아요.

9

(선택 사항) 재동기화 오류 재시도 지연 필드 값을 작은 수 (예: 30) 로 설정하세요.


<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>

10

TFTP 서버를 비활성화하고 syslog 출력 결과를 관찰하세요.

프로필 재동기화 파라미터

다음 표는 전화 웹 페이지의 음성 > 프로비저닝 탭 아래 구성 프로필 섹션에 있는 프로필 재동기화 매개변수의 기능과 사용을 정의해요. 또한 매개 변수를 구성하는 XML 코드와 함께 전화 구성 파일 (cfg.xml) 에 추가되는 문자열의 구문을 정의해요.

테이블 1이에요.프로필 재동기화 파라미터

파라미터

설명

프로비전 활성화

구성 프로필 재동기화 작업을 허용하거나 거부해요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Provision_Enable ua="na">맞아요</Provision_Enable>
  • 전화 웹 페이지에서 이 필드를 예로 설정하면 재동기화 작업을 허용하고 아니요로 설정하면 재동기화 작업을 차단할 수 있어요.

기본값: 네

초기화 시 재동기화돼요

전원을 켠 후 그리고 업그레이드를 시도할 때마다 전화기가 프로비저닝 서버와 구성을 재동기화할지 여부를 지정합니다.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_On_Reset ua="na">맞아요</Resync_On_Reset>
  • 전화 웹 페이지에서 전원을 켜거나 재설정할 때 재동기화를 허용하려면 이 필드를 예로 설정하고, 전원을 켜거나 재설정할 때 재동기화를 차단하려면 아니요로 설정하세요.

기본값: 네

랜덤 리싱크 딜레이

많은 장치가 동시에 전원을 켜고 초기 구성을 시도할 때 프로비저닝 서버의 과부하를 방지해요. 이 지연은 기기 전원을 켜거나 리셋한 후 초기 구성을 시도할 때만 유효해요.

매개변수는 장치가 프로비저닝 서버와 연결하기 전에 대기하는 최대 시간 간격이에요. 실제 지연은 0과 이 값 사이의 유사 난수예요.

이 파라미터는 20초 단위예요.

유효한 값의 범위는 0에서 65535 사이예요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_Random_Delay ua="na">2.</Resync_Random_Delay>
  • 전화 웹 페이지에서 전화기 전원 켜거나 초기화한 후 재동기화 지연시킬 단위 수 (20초) 를 지정하세요.

기본값은 2예요 (40초).

재동기화해요 (흠)

전화가 프로비저닝 서버와 재동기화되는 시간 (흠) 이에요.

시간을 HHmm 형식으로 나타내려면 이 필드의 값은 0000에서 2400 사이의 4자리 숫자여야 해요. 예를 들어, 0959는 09:59 를 가리킵니다.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>
  • 전화 웹 페이지에서 전화가 재동기화 시작하는 시간을 HHMM 포맷으로 지정하세요.

기본값은 비어 있어요. 값이 유효하지 않으면 매개변수가 무시돼요. 이 매개변수가 유효한 값으로 설정되면 주기적 재동기화 매개변수는 무시돼요.

랜덤 지연 시 재동기화돼요

많은 장치가 동시에 켜질 때 프로비저닝 서버의 과부하를 방지해요.

여러 대의 전화기에서 서버로 재동기화 요청이 쇄도하지 않도록 전화가 시간과 분, 시간과 분에 임의 지연 (흠, hhmm+random_delay) 사이의 범위에서 재동기화돼요. 예를 들어 임의 지연이 (임의 지연 시 재동기화 + 30) /60분이면, 초 단위의 입력값이 분으로 변환되어 다음 분으로 반올림하여 최종 random_delay 간격을 계산해요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>
  • 전화 웹 페이지에서 기간 (초) 을 지정하세요.

유효한 값의 범위는 600에서 65535 사이예요.

값이 600보다 작으면 내부 랜덤 지연은 0에서 600 사이예요.

기본값은 600초 (10분) 예요.

재동기화 주기적

프로비저닝 서버와의 주기적 재동기화 사이의 시간 간격. 관련 재동기화 타이머는 서버와 처음으로 동기화에 성공한 후에만 활성화돼요.

유효한 형식은 다음과 같아요.

  • 정수예요

    예: 입력이 3000이면 다음 재동기화가 3000초 후에 일어난다는 뜻이에요.

  • 정수가 여러 개예요

    예: 입력된 600,1200,300은 첫 번째 재동기화는 600초 후, 두 번째 재동기화는 첫 번째 재동기화 후 1200초 후, 세 번째 재동기화는 두 번째 재동기화 후 300초 후에 일어난다는 뜻이에요.

  • 시간 범위

    예를 들어, 입력이 2400+30이면 재동기화 성공 후 다음 재동기화가 2400초에서 2430초 사이에 일어난다는 뜻이에요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_Periodic ua="na">3600</Resync_Periodic>
  • 전화 웹 페이지에서 기간 (초) 을 지정하세요.

주기적인 재동기화를 비활성화하려면 이 매개변수를 0으로 설정하세요.

기본값은 3600초예요.

재동기화 오류 재시도 지연

전화가 서버에서 프로필을 검색하지 못했거나, 다운로드한 파일이 손상되었거나, 내부 오류가 발생해서 재동기화 작업이 실패하면, 전화기는 지정된 시간 (초) 후에 재동기화를 다시 시도해요.

유효한 형식은 다음과 같아요.

  • 정수예요

    예: 입력값이 300이면 다음 재동기화 재시도가 300초 후에 일어난다는 뜻이에요.

  • 정수가 여러 개예요

    예: 입력이 600,1200,300이면 첫 번째 재시도는 실패 후 600초 후에 발생하고, 두 번째 재시도는 첫 번째 재시도 실패 후 1200초 후에 발생하고, 세 번째 재시도는 두 번째 재시도 실패 후 300초 후에 일어난다는 뜻이에요.

  • 시간 범위

    예를 들어, 입력이 2400+30이면 재동기화 실패 후 2400초에서 2430초 사이에 다음 재시도가 일어난다는 뜻이에요.

지연이 0으로 설정된 경우, 재동기화 실패 후 장치가 다시 재동기화를 시도하지 않아요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>
  • 전화 웹 페이지에서 기간 (초) 을 지정하세요.

기본값: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

강제 재동기화 지연이에요

재동기화 하기 전에 전화가 대기하는 최대 지연 시간 (초) 이에요.

전화선 중 하나가 활성화되어 있는 동안에는 기기가 재동기화되지 않아요. 재동기화에는 몇 초가 걸릴 수 있기 때문에 기기가 오랫동안 유휴 상태가 될 때까지 기다렸다가 재동기화하는 게 좋겠어요. 이렇게 하면 사용자가 중단 없이 연속으로 전화를 걸 수 있어요.

기기에 모든 라인이 유휴 상태가 되면 카운트다운을 시작하는 타이머가 있어요. 이 매개변수는 카운터의 초기값이에요. 재동기화 이벤트는 이 카운터 감소가 0으로 줄어들 때까지 지연돼요.

유효한 값의 범위는 0에서 65535 사이예요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>
  • 전화 웹 페이지에서 기간 (초) 을 지정하세요.

기본값은 14,400초예요.

SIP에서 재동기화해요

서비스 제공자 프록시 서버에서 전화로 보내는 SIP NOTIFY 이벤트를 통한 재동기화 작업 요청을 제어합니다. 활성화하면 프록시가 이벤트: 재동기화 헤더가 포함된 SIP NOTIFY 메시지를 장치에 보내서 재동기화를 요청할 수 있어요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_From_SIP ua="na">맞아요</Resync_From_SIP>
  • 전화 웹 페이지에서 이 기능을 활성화하려면 예, 비활성화하려면 아니오를 선택하세요.

기본값: 네

업그레이드 시도 후 재동기화해요

업그레이드 후 재동기화 작업을 활성화 또는 비활성화해요. 예 선택하면 펌웨어 업그레이드 후에 동기화가 시작돼요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_After_Upgrade_Attempt ua="na">네.</Resync_After_Upgrade_Attempt>
  • 전화 웹 페이지에서 펌웨어 업그레이드 후 재동기화를 시작하려면 예, 재동기화하지 않으려면 아니오를 선택하세요.

기본값: 네

리싱크 트리거 1

리싱크 트리거 2

이 매개변수의 논리식이 FALSE로 평가되면 재동기화 시 재설정이 TRUE로 설정되어도 재동기화가 트리거되지 않아요. 다이렉트 액션 URL과 SIP 알림을 통한 재동기화만 이런 재동기화 트리거를 무시해요.

매크로 확장을 거치는 조건부로 매개변수를 프로그래밍할 수 있어요. 유효한 매크로 확장에 대해서는 프로비저닝 매개변수 아래의 매크로 확장 변수를 참조하세요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_Trigger_1 ua="na">$UPGTMR은 300달러이고 PRVTMR은 600달러예요</Resync_Trigger_1>

    <Resync_Trigger_2 ua="na"/>

  • 전화 웹 페이지에서 트리거를 지정하세요.

기본값: 공백

사용자 구성 가능 재동기화

사용자가 전화 화면 메뉴에서 전화를 재동기화할 수 있게 해줘요. Yes로 설정하면 사용자가 전화에서 프로필 규칙을 입력하여 전화 구성을 재동기화할 수 있어요. 아니오로 설정하면 프로필 규칙 매개변수가 전화 화면 메뉴에 표시되지 않아요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <User_Configurable_Resync ua="na">네.</User_Configurable_Resync>

  • 전화 웹 페이지에서 전화 메뉴에 프로필 규칙 매개 변수를 표시하려면 예 를 선택하고 이 매개 변수를 숨기려면 아니오를 선택하세요.

기본값: 네

FNF에서 재동기화 실패해요

요청된 프로필을 서버에서 받지 못하면 재동기화는 보통 실패한 것으로 간주돼요. 이 매개변수가 이 동작보다 우선해요. 아니오로 설정하면 장치가 서버로부터 파일을 찾을 수 없다는 응답을 성공적인 재동기화로 받아들여요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Resync_Fails_On_FNF ua="na">맞아요</Resync_Fails_On_FNF>
  • 전화 웹 페이지에서 파일을 찾을 수 없는 응답을 재동기화 실패로 처리하려면 [예] 를 선택하고, 파일을 찾을 수 없는 응답을 성공적인 재동기화로 받아들이려면 아니오를 선택하세요.

기본값: 네

프로필 인증 유형이에요

프로필 계정 인증에 사용할 자격 증명을 지정해요. 사용 가능한 옵션은 다음과 같아요.

  • 비활성화됨: 프로필 계정 기능을 비활성화해요. 이 기능이 비활성화되면 프로필 계정 설정 메뉴가 전화 화면에 표시되지 않아요.

  • 기본 HTTP 인증: HTTP 로그인 자격 증명은 프로필 계정을 인증하는 데 사용돼요.

  • XSI 인증: XSI 로그인 자격 증명 또는 XSI SIP 자격 증명이 프로필 계정을 인증하는 데 사용돼요. 인증 자격 증명은 전화의 XSI 인증 유형에 따라 달라져요.

    • 전화의 XSI 인증 유형이 로그인 자격 증명으로 설정되면 XSI 로그인 자격 증명이 사용돼요.

    • 전화의 XSI 인증 유형이 SIP 자격 증명으로 설정되면 XSI SIP 자격 증명이 사용돼요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Profile_Authentication_Type ua="na">기본 Http 인증</Profile_Authentication_Type>
  • 전화 웹 페이지에서 프로필 재동기화를 인증하는 전화 옵션을 목록에서 선택하세요.

기본값: 기본 HTTP 인증

자세한 내용은 프로필 재동기화할 전화 지정에서 프로필 인증 유형 지정을 참조하세요.

프로필 규칙

프로필 규칙 B

프로필 규칙 C

프로필 규칙 D

각 프로필 규칙은 프로필 (구성 파일) 을 얻을 소스를 전화기에 알려줘요. 매번 재동기화 작업 중에 전화가 모든 프로필을 순서대로 적용해요.

구성 파일에 AES-256-CBC 암호화를 적용하는 경우 다음과 같이 --key 키워드로 암호화 키를 지정하세요.

[--키] <encryption key>

선택적으로 암호화 키를 큰따옴표 (“) 로 묶을 수 있어요.

  • 전화 구성 파일 (cfg.xml) 에 XML을 사용하여 다음 형식으로 문자열을 입력하세요.

    <Profile_Rule ua="na">/$PSN.xml</Profile_Rule>

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • 전화 웹 페이지에서 프로필 규칙을 지정하세요.

기본값: /$PSN.xml

사용할 DHCP 옵션이에요

펌웨어하고 프로필을 검색하는 데 사용되는 DHCP 옵션, 쉼표로 구분돼요.

기본값: 66,160,159,150,60,43,125

DHCPv6 옵션을 사용할 수 있어요

펌웨어하고 프로필을 검색하는 데 사용되는 DHCP 옵션, 쉼표로 구분돼요.

기본값: 17,160,159

시스코 XML을 통한 프로비저닝

Cisco XML 함수를 통해 전화를 프로비전할 수 있어요.

SIP 알림 패킷이나 HTTP 포스트를 통해 전화기의 CGI 인터페이스에 XML 객체를 보낼 수 있어요: http://PhoneIPAddress/CGI/Execute.

CP-XXXXX-3PCC는 시스코 XML 기능을 확장해서 XML 객체를 통한 프로비저닝을 지원해요.


<CP-xxxx-3PCCExecute>
        <ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>

휴대폰이 XML 객체를 수신한 후 [프로필 규칙] 에서 프로비저닝 파일을 다운로드해요. 이 규칙은 매크로를 사용하여 XML 서비스 응용 프로그램 개발을 단순화해요.

URL 해상도 (매크로 확장 포함)

서버의 여러 프로필이 있는 하위 디렉토리는 배포된 많은 장치를 관리하는 편리한 방법을 제공해요. 프로필 URL에는 다음이 포함될 수 있어요.

  • 프로비저닝 서버 이름 또는 명시적 IP 주소. 프로필에서 프로비전 서버를 이름으로 식별하면 전화기가 DNS 조회를 수행하여 이름을 확인해요.

  • 서버 이름 뒤에 표준 구문을 사용하여 URL에 지정하는 비표준 서버 포트예요.

  • 프로필이 저장되는 서버 가상 루트 디렉토리의 하위 디렉토리로, 표준 URL 표기법으로 지정되고 매크로 확장으로 관리됩니다.

예를 들어, 다음 Profile_Rule은 서버 하위 디렉토리 /cisco/config에 있는 프로파일 파일 ($pn.cfg) 을 포트 6900에서 연결을 수신하는 호스트 prov.telco.com에서 실행되는 TFTP 서버에 요청해요.


<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>

범용 매개변수로 각 전화의 프로필을 식별할 수 있고 매크로 확장을 사용하여 공통 프로필 규칙 내에서 해당 값을 참조할 수 있어요.

예를 들어, GPP_B가 Dj6Lmp23Q로 정의된다고 가정해 보세요.

프로필_규칙의 값은 다음과 같아요.


tftp://prov.telco.com/cisco/$B/$MA.cfg

장치가 재동기화되고 매크로가 확장되면 MAC 주소가 000e08012345인 전화기가 다음 URL에 장치 MAC 주소가 포함된 이름의 프로필을 요청해요.


tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg

프로필 인증 유형을 지정해 주세요.

프로필 인증을 사용하면 전화 사용자가 프로비전 프로필을 전화에 재동기화할 수 있어요. 전화기가 처음으로 구성 파일을 재동기화하고 다운로드하려고 하는데 HTTP 또는 HTTPS 401 인증 오류가 날 때 인증 정보가 필요해요. 이 기능을 활성화하면 다음과 같은 상황에서 프로필 계정 설정 화면이 휴대폰에 표시돼요.

  • 전화 재부팅 후 최초 프로비저닝 중에 HTTP 또는 HTTPS 401 인증 오류가 발생하면

  • 프로필 계정 사용자 이름과 비밀번호가 비어 있을 때

  • 프로필 규칙에 사용자 이름과 암호가 없을 때

프로필 계정 설정 화면을 놓치거나 무시한 경우 사용자는 전화 화면 메뉴나 전화에 회선이 등록되지 않은 경우에만 표시되는 설정 소프트키를 통해 설정 화면에 액세스할 수도 있어요.

기능 비활성화하면 프로필 계정 설정 화면이 휴대폰에 표시되지 않아요.

프로필 규칙 필드의 사용자 이름과 암호가 프로필 계정보다 우선순위가 높아요.

  • 프로필 규칙 필드에 사용자 이름과 암호 없이 올바른 URL을 입력하면 프로필을 재동기화하려면 전화에 인증이나 다이제스트가 필요해요. 올바른 프로필 계정으로 인증이 통과돼요. 프로필 계정이 틀리면 인증이 실패해요.

  • 프로필 규칙 필드에 올바른 URL에 올바른 사용자 이름과 암호를 입력하면 프로필을 재동기화하려면 전화기에 인증이나 다이제스트가 필요해요. 프로필 계정은 전화 재동기화에 사용되지 않아요. 로그인이 성공했어요.

  • 프로필 규칙 필드에 올바른 URL을 입력하고 사용자 이름과 암호를 잘못 입력하면 프로필을 재동기화하려면 전화기에 인증이나 다이제스트가 필요해요. 프로필 계정은 전화 재동기화에 사용되지 않아요. 로그인은 항상 실패해요.

  • 프로필 규칙 필드에 잘못된 URL을 입력하면 로그인이 항상 실패해요.

또한 XML (cfg.xml) 코드로 전화 구성 파일의 매개변수를 구성할 수 있어요.

전화 관리 웹 페이지에서 프로필 인증 유형을 지정할 수 있어요.

1

전화 관리 웹페이지에 접속해요.

2

음성 > 프로비저닝을 선택해요.

3

구성 프로필 섹션에서 프로필 계정 인증에 사용할 자격 증명을 지정하도록 프로필 인증 유형 매개 변수를 설정하세요.

다음 형식으로 문자열을 입력하여 전화 구성 XML 파일 (cfg.xml) 에서 이 매개변수를 구성할 수 있어요.

<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>

옵션:

  • 비활성화됨: 프로필 계정 기능을 비활성화해요. 이 기능이 비활성화되면 프로필 계정 설정 메뉴가 전화 화면에 표시되지 않아요.

  • 기본 HTTP 인증: HTTP 로그인 자격 증명은 프로필 계정을 인증하는 데 사용돼요.

  • XSI 인증: XSI 로그인 자격 증명 또는 XSI SIP 자격 증명이 프로필 계정을 인증하는 데 사용돼요. 인증 자격 증명은 전화의 XSI 인증 유형에 따라 달라져요.

    전화의 XSI 인증 유형이 로그인 자격 증명으로 설정되면 XSI 로그인 자격 증명이 사용돼요.

    전화의 XSI 인증 유형이 SIP 자격 증명으로 설정되면 XSI SIP 자격 증명이 사용돼요.

기본값: 기본 HTTP 인증

4

모든 변경사항 제출을 클릭해요.

휴대폰에 프로필을 수동으로 적용해요

TFTP 서버에서 구성 파일을 전화기로 다운로드해요

구성 파일을 PC의 TFTP 서버 애플리케이션에 다운로드하려면 다음 단계를 완료하세요.

1

컴퓨터를 전화기 LAN 포트에 연결해요.

2

컴퓨터에서 TFTP 서버 애플리케이션을 실행하고 TFTP 루트 디렉터리에 구성 파일이 있는지 확인하세요.

3

웹 브라우저에서 전화 LAN IP 주소, 컴퓨터 IP 주소, 파일 이름, 로그인 자격 증명을 입력하세요. 이 형식을 사용하세요:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>

예시:

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin

cURL로 구성 파일을 휴대폰에 다운로드해요

cURL을 사용하여 구성을 휴대폰에 다운로드하려면 다음 단계를 완료하세요. 이 명령줄 도구는 URL 구문으로 데이터를 전송하는 데 사용돼요. cURL를 다운로드하려면 다음 웹 사이트를 방문하세요.

https://curl.haxx.se/download.html

cURL을 사용하는 동안 사용자 이름과 암호가 캡처될 수 있으므로 구성을 전화기에 게시할 때는 cURL을 사용하지 않는 것이 좋습니다.

1

컴퓨터를 전화기 LAN 포트에 연결해요.

2

다음 cURL 명령을 입력하여 구성 파일을 휴대폰에 다운로드해요.

curl –d @my_config.xml
“http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

프로필 구성 관련 참고 자료

전화기가 XML 포맷으로 구성을 받아들여요.

이 섹션의 예제는 XML 구문의 구성 프로파일을 사용해요.

구성 프로필 포맷

구성 프로파일은 전화의 파라미터 값을 정의해요.

구성 프로파일 XML 형식은 표준 XML 저작 도구를 사용하여 매개변수와 값을 컴파일해요.

UTF-8 문자셋만 지원돼요. 편집기에서 프로필을 수정하는 경우 인코딩 형식을 변경하지 마세요. 그렇지 않으면 휴대폰이 파일을 인식하지 못해요.

전화기마다 기능 세트가 다르므로 매개 변수 집합도 다릅니다.

오픈 프로필 포맷

오픈 포맷 프로파일은 요소 계층 구조에 XML 같은 구문이 있고 요소 속성과 값이 있는 텍스트 파일이에요. 이 형식을 사용하면 표준 도구를 사용하여 구성 파일을 만들 수 있어요. XML 구성 파일은 바이너리 객체로 컴파일하지 않고 재동기화 작업 중에 프로비저닝 서버에서 전화기로 보낼 수 있어요.

전화기는 표준 도구가 생성하는 구성 형식을 받아들일 수 있어요. 이 기능을 사용하면 기존 데이터베이스에서 구성 프로파일을 생성하는 백엔드 프로비저닝 서버 소프트웨어를 쉽게 개발할 수 있어요.

구성 프로필의 기밀 정보를 보호하기 위해 프로비저닝 서버가 TLS 보안 채널을 통해 XML 구성 파일을 전화에 전송해요. 선택적으로 gzip 디플레이트 알고리즘 (RFC1951) 을 사용하여 파일을 압축할 수 있어요.

파일은 다음 암호화 방법 중 하나로 암호화될 수 있어요.

  • AES-256-CBC 암호화예요

  • AES-128-GCM 암호화를 사용한 RFC-8188 기반 HTTP 콘텐츠 암호화예요

구성 파일에는 다음 구성 요소가 포함될 수 있어요.

  • 엘리먼트 태그

  • 속성들

  • 매개변수들

  • 서식 지정 기능들

  • XML 코멘트

예: 오픈 프로필 포맷


<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>

<flat-profile>엘리먼트 태그는 휴대폰이 인식하는 모든 파라미터 엘리먼트를 포함해요.

엘리먼트 태그 속성

구성 파일을 만들거나 업데이트할 때 다음 규칙을 염두에 두세요.

  • XML 프로비전 형식하고 웹 UI로 같은 설정을 구성할 수 있어요. 웹 UI의 XML 태그 이름과 필드 이름은 비슷하지만 XML 요소 이름 제한으로 인해 달라져요. 예를 들어, XML 구성 파일에 웹 UI에 공백 대신 밑줄 (_) 을 넣으세요.

  • <flat-profile>전화기가 특수 요소에 캡슐화된 적절한 매개변수 이름을 가진 요소를 인식해요.

  • 요소 이름은 꺾쇠 괄호로 묶여 있어요.

  • 대부분의 요소 이름은 전화 웹 UI의 필드 이름과 비슷하지만 다음과 같이 수정되었습니다.

    • 요소 이름은 공백이나 특수 문자를 포함할 수 없어요. 웹 필드 이름에서 요소 이름을 가져오려면 모든 공백이나 특수 문자 [,], (,), /를 밑줄로 대체하세요.

      예: <Resync_On_Reset>요소가 재설정 시 재동기화 필드를 나타냅니다.

    • 각 요소 이름은 고유해야 해요. 전화 웹 UI에서 회선, 사용자, 내선 페이지 등 여러 웹 페이지에 같은 필드가 표시될 수 있어요. 요소 이름에 [n] 을 추가하여 페이지 탭에 표시되는 숫자를 나타내세요.

      예: <Dial_Plan_1_>요소가 라인 1의 다이얼 플랜을 나타낸대요.

  • 각 오프닝 요소 태그에 일치하는 마감 요소 태그가 있어야 해요. 예를 들자면:

    
    <flat-profile>
    <Resync_On_Reset> Yes
      </Resync_On_Reset>
    <Resync_Periodic> 7200
      </Resync_Periodic>
    <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg
      </Profile_Rule>
    </flat-profile>
    
  • 요소 태그는 대소문자를 구분해요.

  • 빈 요소 태그가 허용되고 값을 비우도록 구성하는 것으로 해석돼요. 상응하는 요소 태그 없이 오프닝 요소 태그를 입력하고 닫는 꺾쇠 괄호 (>) 앞에 공백과 슬래시를 삽입하세요. 이 예에서는 프로필 규칙 B가 비어 있어요.

    
    <Profile_Rule_B />
    
  • 빈 요소 태그를 사용하여 재동기화 작업 중에 사용자가 제공한 값을 덮어쓰는 것을 방지할 수 있어요. 다음 예에서는 사용자 스피드 다이얼 설정이 변경되지 않았어요.

    <flat-profile>
    <Speed_Dial_2_Name ua="rw"/>
    <Speed_Dial_2_Number ua="rw"/>
    <Speed_Dial_3_Name ua="rw"/>
    <Speed_Dial_3_Number ua="rw"/>
    <Speed_Dial_4_Name ua="rw"/>
    <Speed_Dial_4_Number ua="rw"/>
    <Speed_Dial_5_Name ua="rw"/>
    <Speed_Dial_5_Number ua="rw"/>
    <Speed_Dial_6_Name ua="rw"/>
    <Speed_Dial_6_Number ua="rw"/>
    <Speed_Dial_7_Name ua="rw"/>
    <Speed_Dial_7_Number ua="rw"/>
    <Speed_Dial_8_Name ua="rw"/>
    <Speed_Dial_8_Number ua="rw"/>
    <Speed_Dial_9_Name ua="rw"/>
    <Speed_Dial_9_Number ua="rw"/>
    </flat-profile>
    
  • 빈 값을 사용하여 해당 매개변수를 빈 문자열로 설정하세요. 여는 요소와 닫는 요소를 값 없이 입력하세요. 다음 예에서는 GPP_A 매개변수가 빈 문자열로 설정되어 있어요.

    
    <flat-profile>
    <GPP_A>
      </GPP_A>
    </flat-profile>
    
  • 인식할 수 없는 요소 이름은 무시돼요.

매개변수 속성

다음 속성이 매개변수에 적용돼요.

  • 프로필로 지정되지 않은 모든 매개변수는 전화기에 그대로 남아 있어요.

  • 인식할 수 없는 매개변수는 무시돼요.

  • 오픈 포맷 프로파일에 같은 파라미터 태그가 여러 번 나오면, 마지막으로 발생한 것이 이전 파라미터 태그보다 우선해요. 매개 변수의 구성 값을 실수로 재정의하는 것을 방지하려면 각 프로필에 매개 변수의 인스턴스를 최대 한 개만 지정하는 것이 좋습니다.

  • 마지막으로 처리된 프로필이 우선이에요. 여러 프로필이 같은 구성 매개변수를 지정하는 경우, 후자의 프로필의 값이 우선해요.

문자열 포맷

이 속성들은 문자열 포맷에 적용돼요.

  • 댓글은 표준 XML 구문을 통해 허용돼요.

    <!-- My comment is typed here -->
  • 가독성을 위해 선행 및 후행 공백은 허용되지만 매개변수 값에서 제거돼요.

  • 값 안의 새 줄은 공백으로 변환돼요.

  • < 형식의 XML 헤더예요??> 허용되는데 전화가 무시해요.

  • 특수 문자를 입력하려면 다음 표와 같이 기본 XML 문자 이스케이프를 사용하세요.

    특수 캐릭터

    XML 이스케이프 시퀀스

    & (앰퍼샌드)

    &

    < (보다 작음)

    <

    >(보다 큼)

    >

    '(아포스트로피)

    '

    ” (큰따옴표)

    “

    다음 예에서는 다이얼 플랜 규칙에 필요한 보다 크고 작은 기호를 나타내기 위해 문자 이스케이프를 입력했어요. 이 예에서는 <Dial_Plan_1_>매개 변수 (관리자 로그인 > 고급 > 음성 > 내선 번호 (n)) 를 (S0 <:18005551212>) 로 설정하는 정보 핫라인 다이얼 플랜을 정의해요.

    
    <flat-profile>
     <Dial_Plan_1_>
      (S0 &lt;:18005551212&gt;)
     </Dial_Plan_1_>
    </flat-profile>
  • 십진수와 16진수 값 (s.a. (및.) 을 사용하는 숫자 이스케이프가 번역돼요.

  • 전화 펌웨어는 ASCII 문자만 지원해요.

오픈 프로필 압축

지원되는 압축 방법은 gzip 디플레이트 알고리즘 (RFC1951) 이에요. gzip 유틸리티하고 같은 알고리즘 (zlib) 을 구현하는 압축 라이브러리는 인터넷 사이트에서 구할 수 있어요.

압축을 식별하기 위해 휴대폰은 압축 파일에 gzip 호환 헤더가 포함될 것으로 예상해요. 오리지널 오픈 프로필에서 gzip 유틸리티를 호출하면 헤더가 생성돼요. 휴대폰이 다운로드한 파일 헤더를 검사하여 파일 형식을 결정해요.

예를 들어, profile.xml 가 유효한 프로필이면 프로필.xml.gz 파일도 허용돼요. 다음 명령 중 하나로 이 프로필 유형을 생성할 수 있어요.

  • >gzip profile.xml

    원본 파일을 압축 파일로 대체해요.

  • >cat profile.xml | gzip > 프로필.xml.gz

    원본 파일을 제자리에 두고 새 압축 파일을 만들어요.

오픈 프로필 암호화예요

대칭키 암호화는 파일의 압축 여부에 상관없이 열린 구성 프로필을 암호화하는 데 사용할 수 있어요. 압축을 적용하면 암호화보다 먼저 적용해야 해요.

프로비저닝 서버는 배포 후 전화의 초기 프로비저닝을 처리하기 위해 HTTPS를 사용해요. 구성 프로파일을 오프라인으로 사전 암호화하면 이후에 프로필을 재동기화하는 데 HTTP를 사용할 수 있어요. 이렇게 하면 대규모 배포 시 HTTPS 서버의 부하가 줄어들어요.

휴대폰은 구성 파일 암호화를 두 가지 방법으로 지원해요.

  • AES-256-CBC 암호화예요

  • AES-128-GCM 암호화를 사용한 RFC 8188 기반 HTTP 콘텐츠 암호화예요

키 또는 입력 키 자료 (IKM) 를 더 일찍 장치에 미리 프로비전해야 해요. 비밀 키의 부트스트랩은 HTTPS를 사용하여 안전하게 수행할 수 있어요.

구성 파일 이름에는 특정 형식이 필요하지 않지만.cfg 확장자로 끝나는 파일 이름은 보통 구성 프로필을 나타냅니다.

AES-256-CBC 암호화예요

전화기가 구성 파일에 AES-256-CBC 암호화를 지원해요.

다양한 인터넷 사이트에서 다운로드할 수 있는 OpenSSL 암호화 도구로 암호화를 수행할 수 있어요. 256비트 AES 암호화를 지원하려면 AES 코드를 활성화하는 도구를 다시 컴파일해야 할 수도 있어요. 펌웨어는 openssl-1.1.1d 버전에서 테스트됐어요.

암호화된 파일의 경우, 프로필은 파일이 다음 명령으로 생성된 것과 같은 형식을 가질 것으로 예상해요.


# example encryption key = SecretPhrase1234

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg

# analogous invocation for a compressed xml file

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

비밀 키 앞에 소문자 -k가 붙는데, 비밀 키는 임의의 일반 텍스트 문구일 수 있고 임의의 64비트 솔트를 생성하는 데 사용돼요. -k 인수로 지정된 비밀을 사용하면 암호화 도구가 무작위 128비트 초기 벡터와 실제 256비트 암호화 키를 파생해요.

구성 프로파일에 이런 형태의 암호화를 사용하는 경우 파일을 해독하려면 비밀 키 값을 전화기에 알려야 해요. 이 값은 프로필 URL에 한정자로 지정돼요. 구문은 다음과 같고 명시적 URL을 사용해요.


[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg

이 값은 Profile_Rule 매개 변수 중 하나를 사용하여 프로그래밍돼요.

몇몇 프로비저닝 파라미터가 평가되기 전에 내부적으로 거시적으로 확장돼요. 이 사전 평가 단계를 통해 전화 재동기화 및 업그레이드 활동을 보다 유연하게 제어할 수 있어요.

이 파라미터 그룹은 평가 전에 거시적으로 확장돼요.

  • 리싱크_트리거_*

  • 프로필_규칙*

  • 로그_XXX_메시지

  • 업그레이드_규칙

특정 조건에서는 아래 선택적 재동기화 인수 섹션에 명시되어 있는 것처럼 일부 범용 파라미터 (GPP_*) 도 매크로 확장을 거쳐요.

매크로 확장 중에는 이름이 지정된 변수의 내용이 $NAME, $ (NAME) 형식의 표현식을 대체해요. 이러한 변수에는 범용 매개변수, 여러 제품 식별자, 특정 이벤트 타이머, 공급 상태 값이 포함돼요. 전체 목록을 보려면 프로비저닝 매개변수 아래의 매크로 확장 변수를 참조하세요.

다음 예에서는 MAC 주소 000E08012345 삽입에 $ (MAU) 표현식을 사용해요.

관리자가 입력해요: $ (MAU) config.cfg

MAC 주소가 000E08012345 인 장치의 매크로 확장 결과는: 000E08012345config.cfg

매크로 이름을 인식하지 못하면 확장되지 않은 상태로 남아요. 예를 들어 STRANGE라는 이름은 유효한 매크로 이름으로 인식되지 않는 반면 MAU는 유효한 매크로 이름으로 인식돼요.

관리자가 입력해요: $Strange$mau.cfg

MAC 주소가 000E08012345 인 기기의 매크로 확장은 다음과 같습니다. $Strange000E08012345.CFG

매크로 확장은 재귀적으로 적용되지 않아요. 예를 들어 “$$MAU”는 “$MAU”로 확장되고 ($$는 확장됨) MAC 주소가 입력되지 않아요.

특수 목적 매개변수인 GPP_SA~GPP_SD의 내용이 매크로 표현식 $SA~$SD에 매핑돼요. 이 매개변수들은 재동기화 URL의 --key, --uid, --pwd 옵션의 인수로 매크로 확장된 것일 뿐이에요.

조건식은 재동기화 이벤트를 트리거하고 재동기화 및 업그레이드 작업을 위한 대체 URL 중에서 선택할 수 있어요.

조건부 표현식은 및 연산자로 구분된 비교 목록으로 구성돼요. 조건이 맞으려면 모든 비교가 충족되어야 해요.

각 비교는 다음 세 가지 유형의 리터럴 중 하나와 관련이 있을 수 있어요.

  • 정수 값

  • 소프트웨어 또는 하드웨어 버전 번호

  • 큰따옴표 붙은 문자열

버전 번호

Cisco 비디오 폰 8875의 소프트웨어 버전은 다음 형식을 사용해요 (여기서 BN은 빌드 번호예요).

아이폰OS yyyyy.1-0-1-0001 - BN

여기서 yyyyy는 전화 모델이나 전화 시리즈를 나타내고, 1은 메이저 버전, 0은 마이너 버전, 1-0001은 마이크로 버전, BN은 빌드 번호예요.

비교 문자열이 같은 형식을 사용해야 해요. 그렇지 않으면 포맷 파싱 오류가 발생해요.

소프트웨어 버전을 비교할 때 메이저 버전, 마이너 버전, 마이크로 버전을 순서대로 비교하고 맨 왼쪽 숫자가 후자보다 우선해요. 버전 번호가 동일하면 빌드 번호를 비교해요.

유효한 버전 번호 예시

PHONEOS-8875.1-0-1-0001-19

비교요.

인용된 문자열은 평등인지 불평등인지 비교할 수 있어요. 정수와 버전 번호를 산술적으로 비교할 수도 있어요. 비교 연산자는 기호나 두문자어로 표현할 수 있어요. 두문자어는 오픈 포맷 프로파일에서 조건을 표현할 때 편리해요.

운영자

대체 문법

설명

정수 및 버전 피연산자에 적용 가능해요

따옴표로 묶인 문자열 피연산자에 적용 가능해요

=

EQ

하고 같네요

맞아요

맞아요

!=

원

같지 않아요

맞아요

맞아요

<

lt

보다 작아요

맞아요

아니요

<=

르

보다 작거나 같아요

맞아요

아니요

>

gt

보다 커요

맞아요

아니요

>=

나이

보다 크거나 같아요

맞아요

아니요

AND

그리고

맞아요

맞아요

문자열 리터럴이 필요한 경우 매크로 변수를 큰따옴표로 묶는 것이 중요해요. 번호나 버전 번호가 필요한 곳에서는 그러지 마세요.

Profile_Rule* 및 Upgrade_Rule 매개변수의 컨텍스트에서 사용할 경우 조건부 표현식은 “(expr)?” 구문 내에 포함되어야 해요.이 업그레이드 규칙 예시처럼요. 업그레이드할 펌웨어 로드의 빌드 번호로 BN을 바꿔야 한다는 거 잊지 마세요.

($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads

괄호와 함께 위의 구문을 사용하여 Resync_Trigger_* 매개변수를 구성하지 마세요.

표준 URL 구문을 사용하여 Profile_Rule* 및 Upgrade_Rule 매개변수에서 각각 구성 파일과 펌웨어 로드를 검색하는 방법을 지정하세요. 구문은 다음과 같아요.

[스킴://] [서버 [:포트]] 파일 경로

여기서 체계는 다음 값 중 하나예요:

  • tftp예요

  • http

  • https

스키마를 생략하면 tftp로 간주해요. 서버는 DNS에서 인식하는 호스트 이름이거나 숫자로 된 IP 주소일 수 있어요. 포트는 목적지 UDP 또는 TCP 포트 번호예요. 파일 경로는 루트 디렉토리 (/) 로 시작해야 해요. 절대 경로여야 해요.

서버가 없으면 DHCP를 통해 지정된 tftp 서버 (옵션 66) 를 사용해요.

업그레이드 규칙의 경우 서버를 지정해야 해요.

포트가 없으면 지정된 체계의 표준 포트가 사용돼요. TFTP는 UDP 포트 69를 사용하고, http는 TCP 포트 80을 사용하고, https는 TCP 포트 443을 사용해요.

파일 경로가 있어야 해요. 반드시 정적 파일을 참조할 필요는 없지만 CGI를 통해 얻은 동적 내용을 나타낼 수 있어요.

매크로 확장은 URL 내에서 적용돼요. 다음은 유효한 URL의 예시예요.


/$MA.cfg
/cisco/cfg.xml
192.168.1.130/profiles/init.cfg
tftp://prov.call.com/cpe/cisco$MA.cfg
http://neptune.speak.net:8080/prov/$D/$E.cfg
https://secure.me.com/profile?Linksys

DHCP 옵션 66을 사용할 때, 빈 구문은 업그레이드 규칙에서 지원되지 않아요. 프로필 규칙*에만 적용돼요.

RFC 8188 기반 HTTP 콘텐츠 암호화

전화기는 구성 파일에 대해 AES-128-GCM 암호화를 사용한 RFC 8188 기반 HTTP 콘텐츠 암호화를 지원해요. 이 암호화 방법을 사용하면 모든 개체가 HTTP 메시지 헤더를 읽을 수 있어요. 하지만 입력 키잉 자료 (IKM) 를 아는 주체만 페이로드를 읽을 수 있어요. 전화기에 IKM을 프로비전하면 전화와 프로비저닝 서버가 구성 파일을 안전하게 교환하면서 타사 네트워크 요소가 분석 및 모니터링 목적으로 메시지 헤더를 사용할 수 있게 할 수 있어요.

XML 구성 파라미터 IKM_HTTP_암호화_콘텐츠는 전화기의 IKM을 보관해요. 보안상의 이유로 전화 관리 웹 페이지에서는 이 매개변수에 액세스할 수 없어요. 또한 전화의 구성 파일에서도 보이지 않아요. 전화의 IP 주소나 프로비저닝 서버로 보낸 전화의 구성 보고서에서 액세스할 수 있어요.

RFC 8188 기반 암호화를 사용하려면 다음 사항을 확인하세요.

  • 프로비저닝 서버에서 전화기로 보내는 구성 파일에 IKM_HTTP_Encrypt_Content라는 XML 매개변수로 IKM을 지정해서 전화기에 IKM을 프로비전하세요.

  • 프로비저닝 서버에서 전화기로 보낸 구성 파일에 이 암호화가 적용되는 경우 구성 파일의 콘텐츠 인코딩 HTTP 헤더의 aes128gcm인지 확인하세요.

    이 헤더가 없으면 AES-256-CBC 방식이 우선이에요. 프로필 규칙에 AES-256-CBC 키가 있으면 IKM과 상관없이 전화가 AES-256-CBC 암호 해독을 적용해요.

  • 전화기가 프로비저닝 서버로 보내는 구성 보고서에 이 암호화를 적용하도록 하려면 보고서 규칙에 AES-256-CBC 키가 지정되지 않았는지 확인하세요.

선택적 재동기화 인수

Profile_Rule* 매개변수에 입력된 URL 앞에 선택적 인수인 key, uid, pwd가 올 수 있으며, 총체적으로 대괄호로 묶여 있어요.

--key 옵션은 프로비저닝 서버에서 받는 구성 파일이 AES-256-CBC 암호화로 암호화되었음을 휴대폰에 알려줘요. 파일의 콘텐츠 인코딩 헤더가 aes128gcm 암호화를 가리키는 경우는 예외예요. 키 자체는 --key라는 용어 뒤에 오는 문자열로 지정돼요. 키는 선택적으로 큰따옴표 (“) 로 묶을 수 있어요. 전화가 키를 사용하여 구성 파일을 해독해요.

사용 예시


[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]

괄호 안의 선택적 인수는 매크로 확장이에요. 특수 목적 매개변수, GPP_SA~GPP_SD는 키 옵션 인수로 사용되는 경우에만 $SA~$SD 매크로 변수로 매크로로 확장돼요. 다음 예시를 보세요.

[--key $SC]
[--key “$SD”]

오픈 포맷 프로필에서 --key에 대한 인수는 openssl에 주어진 -k 옵션의 인수와 같아야 해요.

uid 및 pwd 옵션은 지정된 URL 요청 시 HTTP 기본 및 다이제스트 인증 문제에 대한 응답으로 보낼 사용자 ID와 암호를 지정하는 데 사용할 수 있어요. 괄호 안의 선택적 인수는 매크로 확장이에요. 특수 목적 매개변수, GPP_SA~GPP_SD는 키 옵션 인수로 사용되는 경우에만 $SA~$SD 매크로 변수로 매크로로 확장돼요. 다음 예시를 보세요.

GPP_SA = MyUserID
GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml

그러면 다음으로 확장될 거예요:

[--uid 내 사용자 ID --PWDMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml

데이터 타입

이러한 데이터 유형은 구성 프로파일 매개변수와 함께 사용돼요.

  • {a, b, c,...} —a, b, c,... 중에서 선택할 수 있어요.

  • 부울—"예” 또는 “아니오”의 부울 값이에요.

  • CADScript—신호의 케이던스 파라미터를 지정하는 미니스크립트예요. 최대 127자까지.

    구문: S 1 [; S 2], 여기서:

    • S i =D i (온 i,1 /오프 i,1 [, 온 i,2 /오프 i,2 [, 온 i,3 /오프 i,3 [, 온 i,4 /4 [, 온 i,5 /오프 i,5 [, 온 i,6 /오프 i,6]]]) 섹션으로 알려져 있어요.

    • on i, j, off i, j는 세그먼트의 켜기/끄기 지속 시간 (초) 이에요. i = 1 또는 2이고 j = 1~6이에요.

    • D i는 섹션의 총 길이 (초) 예요.

    모든 지속 시간의 소수점 3자리까지 1ms 해상도를 제공할 수 있어요. 와일드카드 문자 “*”는 길이 무한을 의미해요. 섹션 내의 세그먼트가 순서대로 재생되고 총 재생 시간까지 반복돼요.

    예시 1:

    
    60(2/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60 s
    Number of Segments = 1
    Segment 1: On=2s, Off=4s
    
    Total Ring Length = 60s
    
    

    예 2—독특한 반지 (숏, 쇼트, 쇼트, 롱):

    
    60(.2/.2,.2/.2,.2/.2,1/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60s
    Number of Segments = 4
    Segment 1: On=0.2s, Off=0.2s
    Segment 2: On=0.2s, Off=0.2s
    Segment 3: On=0.2s, Off=0.2s
    Segment 4: On=1.0s, Off=4.0s
    
    Total Ring Length = 60s
    
    
  • 다이얼플랜스크립트—라인 1과 라인 2 다이얼 플랜을 지정하는 데 사용되는 스크립팅 구문이에요.

  • 플로트 <n>—소수점 n자리까지의 부동 소수점 값이에요.

  • FQDN—정규화된 도메인 이름이에요. 최대 63자까지 입력할 수 있어요. 예시는 다음과 같아요.

    • sip.cisco.com:5060 또는 109.12.14. 12:12345

    • SIP.Cisco.com 또는 109.12.14.12

  • FREQScript—톤의 주파수와 레벨 매개변수를 지정하는 미니스크립트예요. 최대 127자까지 들어있어요.

    구문: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 3 [, F 4 @L 4 [, F 5]]]]], 여기서: @L @L

    • F 1 —F 6은 주파수 (Hz) 예요 (부호 없는 정수만).

    • L 1 —L 6은 dBm 단위의 해당 레벨이에요 (소수점 한 자리까지).

    쉼표 앞뒤의 공백은 허용되지만 권장되지는 않아요.

    예 1—통화 대기음:

    
    440@-10
    
    Number of Frequencies = 1
    Frequency 1 = 440 Hz at –10 dBm
    
    

    예 2—다이얼 톤:

    
    350@-19,440@-19
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    
  • IP— x.x.x 형식의 유효한 IPv4 주소. 여기서 x는 0에서 255 사이예요. 예: 10.1.2.100이에요.

  • 사용자 ID—URL에 표시되는 사용자 ID예요. 최대 63자예요.

  • 전화—14081234567, *69, *72, 345678과 같은 전화번호 문자열이나 일반 URL (예: 1234 @10 .10.10. 100:5068 또는 jsmith@Cisco.com) 문자열은 최대 39자까지 포함할 수 있어요.

  • phtmplt—전화번호 템플릿이에요. 각 템플릿에는 쉼표 (,) 로 구분된 패턴이 하나 이상 포함될 수 있어요. 각 패턴 시작 부분의 공백은 무시돼요. “?”그리고 “*”는 와일드카드 문자를 나타낸대요. 문자 그대로 표현하려면 %xx를 사용하세요. 예를 들어, %2a는 *를 나타낸대요. 템플릿은 최대 39자까지 포함할 수 있어요. 예: “1408*, 1510*”, “1408123???, 555?1이에요.”.

  • 포트—TCP/UDP 포트 번호 (0-65535). 십진수 또는 16진수 형식으로 지정할 수 있어요.

  • 프로비저닝 규칙 구문 - 구성 재동기화 및 펌웨어 업그레이드 규칙을 정의하는 데 사용되는 스크립팅 구문이에요.

  • PWR 레벨—전력 레벨을 dBm, 소수점 한 자리까지 표시해요, 예: —13.5 또는 1.5 (dBm).

  • RSCTMPLT—SIP 응답 상태 코드 템플릿이에요. 예: “404, 5*”, “61?”, “407, 408, 487, 481". 최대 39자까지 입력할 수 있어요.

  • SIG <n>—부호있는 엔비트 값이에요. 십진수 또는 16진수 형식으로 지정할 수 있어요. 음수 값 앞에는 “-” 기호가 와야 해요. 양수 앞의 + 기호는 선택사항이에요.

  • 별표 - 보조 서비스 활성화 코드 (예: *69). 코드는 최대 7자까지 입력할 수 있어요.

  • Str <n>- 예약되지 않은 최대 n개의 문자로 구성된 일반 문자열이에요.

  • 시간 <n>—지속 시간 (초), 소수점 n자리까지. 추가로 지정한 소수점 자리는 무시돼요.

  • 톤스크립트—통화 진행음의 빈도, 레벨, 케이던스 파라미터를 지정하는 미니스크립트예요. 스크립트는 최대 127자까지 포함할 수 있어요.

    구문: 프리스크립트; Z 1 [; Z 2].

    섹션 Z 1은 CADScript의 S 1 섹션과 비슷한데, 각 켜기/끄기 세그먼트 뒤에 주파수 성분 매개변수인 Z 1 = D 1 (온 i,1 /off i,1 /f i,1 [, 온 i,2 /f i,2 [, 온 i,3 /f i,3 [, 온 i,4 /off i,4 f i, 4 [, 온 i,5 /오프 i,5 /f i,5 [, 온 아이, 6 /오프 i,6 /fi,6]]]]) 어디서:

    • 만약, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]]].

    • 1 < n k < 6은 해당 세그먼트에 사용되는 FreqScript의 주파수 성분을 지정해요.

    세그먼트에 주파수 성분이 두 개 이상 사용되면 구성 요소가 합산돼요.

    예 1—발신음:

    
    350@-19,440@-19;10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 10 s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 10s
    
    

    예 2—말더듬음:

    
    350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 2
    Cadence Section 1: Section Length = 2s
    Number of Segments = 1
    Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
    Cadence Section 2: Section Length = 10s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 12s
    
    
  • Uns <n>—부호 없는 n비트 값이에요. 여기서 n은 8, 16, 32예요. 값이 n비트이면 12나 0x18 같은 십진수나 16진수 형식으로 지정할 수 있어요.

다음 사항을 고려하세요.

  • <Par Name>구성 매개변수 이름을 나타냅니다. 프로필에서 해당 태그는 Par_Name처럼 공백을 밑줄 “_”로 바꿔서 구성해요.
  • 빈 기본값 필드는 빈 문자열 < “” >을 의미해요.
  • 휴대폰은 특정 프로필에 없는 태그에 마지막으로 구성한 값을 계속 사용해요.
  • 템플릿은 주어진 순서대로 비교돼요. 가장 가까운 것이 아니라 첫 번째 경기가 선택돼요. 매개변수 이름이 정확히 일치해야 해요.
  • 프로필에 매개변수 정의가 두 개 이상 제공되면 파일에 있는 마지막 정의가 전화기에 적용되는 정의예요.
  • 매개변수 값이 비어 있는 매개변수 사양은 매개변수를 강제로 기본값으로 되돌립니다. 빈 문자열을 대신 지정하려면 매개 변수 값으로 빈 문자열 “" 을 사용하세요.
이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?