HTTPS 인증서 (IoT)

*Hypertext Transfer Protocol Secure*(HTTPS)는 웹 브라우저와 웹사이트 간 데이터 통신에 사용되는 기본 프로토콜인 *Hypertext Transfer Protocol*(HTTP)를 안전하게 암호화한 버전입니다. 이전에는 *Secure Sockets Layer*(SSL)라고 불리던 *Transport Layer Security*(TLS)라는 암호화 프로토콜을 사용하여 통신을 보호합니다. . HTTPS 의 보안은 TLS /SSL 인증서에 의존하고 있으며, 이를 통해 공급자를 인증하고 신원을 확인합니다.

The use of HTTPS is required to communicate with certain network devices, particularly payment terminals. If the HTTPS certificate is not valid, some devices cannot interact with the IoT system.

참고

이 문서와 Odoo 전반에서 *HTTPS 인증서*라는 용어는 HTTPS 연결을 허용하는 유효한 SSL 인증서를 의미합니다.

HTTPS 인증서 생성

HTTPS 인증서는 자동으로 생성됩니다. IoT 시스템이 (다시) 시작되면 (예: Odoo 데이터베이스에 연결된 후) https://www.odoo.com 으로 요청이 전송되고 IoT 시스템과 데이터베이스가 적격성 기준을 충족하는 경우 HTTPS 인증서가 반환됩니다.

  • 데이터베이스는 프로덕션 인스턴스여야 합니다. 데이터베이스 인스턴스는 복사본, 중복, 스테이징 또는 개발 환경이 아니어야 합니다.

  • The Odoo subscription must be ongoing (In Progress status) and have an IoT box subscription line.

인증서가 수신된 경우:

  • The IoT system’s homepage address is updated to a new HTTPS URL ending with .odoo-iot.com. Click the URL to establish a secure HTTPS connection.

    Odoo IoT 앱 IoT 박스에 .odoo-iot.com 도메인이 표시된 모습
  • The HTTPS certificate banner displays the certificate’s validity period. To view this information, click the (cogs) button on the IoT system’s homepage.

    IoT 박스 홈페이지에 HTTPS 유효기간이 표시되어 있는 모습입니다.

HTTPS 인증서 생성 문제 및 오류

HTTPS 인증서가 생성되지 않음

원인이 될 수 있는 내용은 다음과 같습니다:

  • 계정에 연결되어 있는 IoT 박스 구독 항목이 없습니다.

  • The IoT box subscription was added after connecting the IoT system to the database. In this case, refresh the IoT system’s homepage or reboot/restart the IoT system to regenerate the HTTPS certificate.

  • 방화벽이 HTTPS 인증서가 올바르게 생성되는 것을 방해하고 있습니다. 이 경우 인증서가 성공적으로 생성될 때까지 방화벽을 비활성화하세요.

    참고

    내장 방화벽이 있는 라우터와 같은 일부 장치는 HTTPS 인증서 생성을 방해할 수 있습니다.

IoT 시스템의 홈페이지는 IP 주소로는 접근할 수 있지만 xxx.odoo-iot.com URL로는 접근할 수 없습니다.

문제 해결을 위해 시스템 또는 네트워크 관리자에게 문의하세요. 네트워크 관련 문제는 Odoo 지원 서비스 범위를 벗어납니다.

  • 라우터가 수동 DNS 구성을 허용하는 경우 `Google DNS <https://developers.google.com/speed/public-dns>`_를 사용하도록 설정을 업데이트하세요.

  • 라우터가 해당 기능을 지원하지 않는 경우 IoT 시스템과 연동되는 각 장치에서 DNS 설정을 직접 업데이트해야 Google DNS <https://developers.google.com/speed/public-dns> 를 사용할 수 있습니다. 개별 장치에서 DNS를 설정하는 방법에 대한 지침은 각 제조업체의 웹사이트에서 확인할 수 있습니다.

참고

  • 결제 단말기와 같은 일부 IoT 장치는 일반적으로 사용자 정의 DNS 설정으로 미리 구성되어 있으므로 DNS 변경이 필요하지 않을 수 있습니다.

  • 일부 브라우저에서 DNS와 관련된 오류 코드(예: DNS_PROBE_FINISHED_NXDOMAIN)가 표시됩니다.

오류

A specific error code is displayed on the IoT system’s homepage if any issues occur during the generation or reception of the HTTPS certificate.

IoT 시스템 홈페이지에 접속하면 자동으로 HTTPS 인증서를 확인하고, 인증서가 없을 경우 인증서 생성을 시도합니다. 오류가 표시될 경우 페이지 새로고침을 통해 문제 해결 여부를 확인합니다.

ERR_IOT_HTTPS_CHECK_NO_SERVER

The server configuration is missing, i.e., the Odoo instance is not connected to the IoT system.

ERR_IOT_HTTPS_CHECK_CERT_READ_EXCEPTION

An error occurred while attempting to read the existing HTTPS certificate. Verify that the HTTPS certificate file is readable.

ERR_IOT_HTTPS_LOAD_NO_CREDENTIAL

계약 혹은 데이터베이스 UUID 를 IoT에서 찾을 수 없습니다.

Verify that both values are correctly configured. To update them, access the IoT box’s or Windows virtual IoT’s homepage, click the (cogs) button, then click Credential.

ERR_IOT_HTTPS_LOAD_REQUEST_EXCEPTION

IoT 시스템이 `<https://www.odoo.com>`_에 도달하려고 시도하는 동안 예기치 않은 오류가 발생했습니다. 이는 다음과 같은 네트워크 관련 문제로 인한 것일 수 있습니다:

  • IoT 시스템이 인터넷에 액세스할 수 없습니다.

  • 네트워크 제한(예: 방화벽 또는 VPN)으로 인해 https://www.odoo.com 에 연결할 수 없습니다.

참고

  • 전체적인 요청 예외 세부 정보에 액세스하여 오류와 관련된 내용을 확인하려면 개발자 모드 활성화 를 클릭하고 IoT 앱에서 IoT 시스템 카드를 클릭한 다음 IoT 시스템 양식 에서 로그 다운로드 를 클릭합니다. IoT 시스템의 로그 파일에 기록된 로그 수준을 지정하려면 IoT 상자 관련 또는 Windows 가상 IoT 관련 홈페이지에 액세스한 후 (톱니바퀴) 버튼을 클릭한 다음 페이지 하단에 있는 로그 수준 을 클릭합니다.

  • 네트워크 관련 문제를 해결하려면 시스템 또는 네트워크 관리자에게 문의하세요. 이러한 문제는 Odoo 지원 서비스 범위를 벗어납니다.

ERR_IOT_HTTPS_LOAD_REQUEST_STATUS

IoT 시스템이 <https://www.odoo.com>`_에 성공적으로 연결되었으나 예상치 못한 `HTTP 응답 (상태 코드) 을 수신했습니다.

이 오류 코드에는 HTTP 상태가 포함됩니다. 예를 들어 `ERR_IOT_HTTPS_LOAD_REQUEST_STATUS 404`는 서버가 “페이지를 찾을 수 없음” 응답을 반환했음을 의미합니다.

이 문제를 해결하려면:

  1. 웹 브라우저에서 `<https://www.odoo.com>`_를 열어 웹사이트가 유지관리를 위해 일시적으로 중단되었는지 확인하세요.

  2. 유지 관리로 인해 https://www.odoo.com 이 다운된 경우 다시 시작될 때까지 대기합니다.
    웹사이트가 작동 중이면 `지원 티켓 <https://www.odoo.com/help>`_을 열고 티켓에 3자리 HTTPS 상태 코드를 포함해야 합니다.

ERR_IOT_HTTPS_LOAD_REQUEST_NO_RESULT

The IoT system successfully connected to https://www.odoo.com, but the server refused to provide the HTTPS certificate.

IoT 시스템과 데이터베이스가 HTTPS 인증서에 대한 :ref:`자격 요건 <iot/https_certificate_iot/iot-eligibility>`을 충족하는지 확인하세요.