사용자 설명서

검색

홈웹 관리 도구 및 기타 OpenAPI 통해서 연계하기

# OpenAPI 통해서 연계하기

- 개요
- OpenAPI의 기본 설정을 하기
- 프록시 서버를 사용하기
- SSL로 통신하기
- 단일 로그온을 사용하기

## 개요

OpenAPI를 통해서 이 기기와 통신하는 컴퓨터 응용 프로그램을 이용하는 경우, 이 기기의 OpenAPI 설정을 합니다.

이 기기의 증명서를 등록해두면, 이 기기가 서버로써 클라이언트와 통신할 때, 통신을 SSL로 암호화할 수 있습니다.

또한, 이 기기의 SSDP(Simple Service Discovery Protocol) 기능을 이용하는 것으로, OpenAPI 연계 컴퓨터 응용 프로그램과의 원활한 연계를 할 수 있습니다.

OpenAPI를 통해서 연계하는 경우에는, 다음의 순서로 설정하십시오.

1. 이 기기의 IP 주소의 설정 등, 네트워크로 연결해서 사용하기 위한 설정을 하기

   - 설정 방법은, 여기를 읽어주십시오.

2. OpenAPI의 기본 설정을 하기

   - 설정 방법은, 여기를 읽어주십시오.

3. 사용하는 환경에 따라서, 다음의 옵션을 설정하기

   목적 | 참조처
   --- | ---
   프록시 서버를 경유해서 컴퓨터 응용 프로그램과와 통신하고 싶다 | 여기
   이 기기와 컴퓨터 응용 프로그램과의 통신을 SSL로 암호화하고 싶다 | 여기
   OpenAPI 응용 프로그램이 기동할 때에 확장 서버에서 인증 정보를 인용하고 싶다(단일 로그온) | 여기

## OpenAPI의 기본 설정을 하기

SSDP 기능을 유효로 합니다. 필요에 따라서, OpenAPI로 통신할 포트 번호를 변경합니다.

1. 관리자 모드의 [네트워크]-[SSDP 설정]에서, 다음의 설정을 합니다.

   설정 | 설명
   --- | ---
   [SSDP] | OpenAPI를 사용할 때는, [ON]을 선택합니다. 다음의 사항을 할 수 있도록 됩니다. 이 기기에서 OpenAPI 서비스가 기동한 것을 통지하기 OpenAPI 서비스 검색에 대해 응답하기 초기값은 [ON]입니다.
   [멀티캐스트 TTL 설정] | 필요에 따라서, SSDP 멀티 캐스트 패킷의, TTL(Time To Live)을 변경합니다. 라우터 등을 한번 경유할 때 마다 값이 1 감소하고, 값이 0이 되면 패킷이 파기됩니다. 초기값은 [1]입니다.

2. 관리자 모드의 [네트워크]-[OpenAPI 설정]에서, 필요에 따라서, 포트 번호를 변경합니다(초기값:[50001]).

   - 보통은 그대로 사용할 수 있습니다.

#####

- Web Connection 및 제어판에서, 복수의 포트 번호를 동시에 변경하고 [확인]을 클릭하면, 포트 번호 중복 오류가 표시될 수 있습니다. 포트 번호 중복 오류가 표시된 경우에는, 한번에 모아서 변경하지 않고, 1개씩 변경하십시오.

## 프록시 서버를 사용하기

사용하시는 네트워크 환경에서 프록시 서버를 사용하고 있는 경우에, 프록시 서버 경유로 응용 프로그램과 통신하도록 설정할 수 있습니다.

프록시 서버를 사용하려면, 이 기기에 프록시 서버의 정보를 등록합니다. 아울러, 프록시 서버로의 연결에 관한 설정을 수행합니다.

관리자 모드의 [네트워크]-[OpenAPI 설정]에서, 다음의 설정을 합니다.

설정 | 설명
--- | ---
[프럭시 서버 주소] | 프록시 서버의 주소를 입력합니다. 다음 포맷중의 하나를 입력합니다. 호스트명의 입력 예:"host.example.com" IP 주소(IPv4)의 입력 예:"192.168.1.1" IP 주소(IPv6)의 입력 예:"fe80::220:6bff:fe10:2f16"
[프럭시 서버 포트 번호] | 필요에 따라서, 프록시 서버의 포트 번호를 변경합니다. 초기값은 [8080]입니다.
[프럭시 서버 포트 번호(HTTPS)] | 필요에 따라서, HTTPS 프로토콜을 사용하는 경우의, 프록시 서버의 포트 번호를 변경합니다. 초기값은 [8080]입니다.
[프럭시 서버 포트 번호(FTP)] | 필요에 따라서, FTP 프로토콜을 사용하는 경우의, 프록시 서버의 포트 번호를 변경합니다. 초기값은 [21]입니다.
[소유자 이름] | 프록시 서버에 로그인 하기 위한 사용자명을 입력합니다(63문자 이내).
[암호] | [소유자 이름]에 입력한 사용자명의 암호를 입력합니다(63문자 이내). 암호를 입력(변경)하는 경우에는, [암호를 변경합니다.]에 체크를 하고 나서, 새로운 암호를 입력합니다.

## SSL로 통신하기

이 기기와 컴퓨터 응용 프로그램과의 OpenAPI를 통한 통신을, SSL로 암호화합니다.

1. 이 기기의 증명서를 등록하고, SSL 통신을 유효로 합니다.

   - 자세한 내용은, 여기를 읽어주십시오.

2. 관리자 모드의 [네트워크]-[OpenAPI 설정]에서, 다음의 설정을 합니다.

   설정 | 설명
   --- | ---
   [SSL/TLS 사용] | SSL로 통신할 때는, [SSL 통신만 가능] 또는 [SSL/비SSL 통신가능]을 선택합니다. 초기값은 [SSL 통신만 가능]입니다.
   [포트 번호 (SSL)] | 필요에 따라서, SSL 통신용의 포트 번호를 변경합니다. 보통은 그대로 사용할 수 있습니다. 초기값은 [50003]입니다.
   [증명서 검증 강도 설정] | 증명서의 검증을 수행하는 경우에는, 검증하는 항목을 선택합니다. 각각의 항목에서 [확인]을 선택하면, 그 항목에 대해서, 증명서의 검증을 수행합니다.
   | [클라이언트 증명서] | 이 기기에 연결할 클라이언트에 대해서, 증명서의 요구 여부를 선택합니다. 초기값은 [요구 안 함]입니다.
   [유효기간] | 증명서가 유효 기한 내인지 아닌지를 확인합니다. 초기값은 [확인]입니다.
   [CN] | 증명서의 CN(Common Name)이, 서버 주소와 일치하고 있는지 아닌지를 확인합니다. 초기값은 [확인 안 함]입니다.
   [키 사용법] | 증명서의 발행자가 승인한 사용 용도에 따라서, 증명서가 사용되고 있는지 아닌지를 확인합니다. 초기값은 [확인 안 함]입니다.
   [체인] | 증명서의 체인(증명서의 경로)에 문제가 있는지 아닌지를 확인합니다. 체인 확인은, 이 기기에서 관리하고 있는 외부 증명서를 참조해서 수행합니다. 초기값은 [확인 안 함]입니다.
   [유효 기간 확인] | 증명서의 실효 여부를 확인합니다. 증명서의 실효 확인은, 다음의 순서로 수행합니다. OCSP(Online Certificate Status Protocol) 서비스 CRL(Certificate Revocation List) 초기값은 [확인 안 함]입니다.

#####

- 관리자 모드의 [보안]-[증명서 검증 설정]에서, 증명서 검증의 수행 여부를 설정합니다. 초기 설정에서는, 증명서의 검증을 수행합니다. 자세한 내용은, 여기를 읽어주십시오.

## 단일 로그온을 사용하기

OpenAPI 응용 프로그램이 기동할 때에 확장 서버에서 인증 정보를 인용합니다. 이에 의해, 기동하는 OpenAPI 응용 프로그램, 및 OpenAPI 응용 프로그램과 연계할 백엔드 시스템과의 단일 로그온 환경을 구축할 수 있습니다.

관리자 모드의 [네트워크]-[OpenAPI 설정]-[단일 로그온 설정]에서 다음의 설정을 합니다.

설정 | 설명
--- | ---
[인증 정보 참고] | 이 기기에 등록된 OpenAPI 응용 프로그램이 기동할 때에, 확장 서버에서 인증 정보의 인용 허가 여부를 선택합니다. 초기값은 [인용 안 함]입니다.
[등록 프로그램 목록] | 이 기기에 등록되어 있는 OpenAPI 응용 프로그램 중, 어느 응용 프로그램에서 인증 정보의 인용을 허가할지를 설정합니다. [편집]을 클릭하고, 각각의 응용 프로그램에서 인증 정보의 인용 여부를 선택합니다.