폐쇄망(air-gapped) 설치

인터넷이 차단된 폐쇄망 환경에서 Sophonz Browser SDK를 설치하는 네 가지 방법을 안내합니다.

폐쇄망(인터넷이 차단된 환경)에서 Sophonz Browser SDK를 설치하는 방법입니다. Web 앱과 WebView에서 모두 적용 가능하며, 아래 설치 방법 중 하나를 선택하여 진행합니다.

NOTE — 적용 범위

Web 앱과 WebView에서 모두 적용 가능하며, 아래 설치 방법 중 하나를 선택하여 진행합니다.

TIP — 앱 키 발급

Sophonz 콘솔 로그인 → 프로젝트 > 앱 추가로 앱을 등록하고 앱 관리에서 앱 키 발급. 모든 설치 완료 후 계측은 자동으로 수행되며, 커스텀 데이터 수집 등 추가 사용법은 Sophonz Browser SDK API 문서를 참고하세요.

설치 방법

네 가지 중 환경에 맞는 하나를 선택하여 진행합니다.

  1. 폐쇄망에서는 CDN을 통해 직접 실행할 수 없으므로 인터넷이 연결된 환경에서 미리 번들링된 자바스크립트 파일을 다운로드합니다.

    다운로드 URL: https://cdn.sophonz.com/release/npm/@browser-sdk/latest/index.js

  2. 다운로드된 index.js 파일을 적절한 이름 sophonz-agent.js로 변경하여 프로젝트 내부에 포함시킵니다. 아래 예시는 프로젝트 내 public 폴더 내에 위치하고 있다고 가정합니다.

  3. 아래 코드와 같이 <head> 태그 안에 추가합니다.

<script src="./public/sophonz-agent.js">
</script>
<script>
  window.Sophonz.init({
    collectorUrl: '{{SOPHONZ_TRACES_COLLECTOR_URL}}',
    appName: '{{YOUR_APP_NAME}}',
    appVersion: '{{YOUR_APP_VERSION}}',
    appKey: '{{YOUR_APP_KEY}}',
    project: '{{YOUR_PROJECT}}',
    deploymentEnvironment: '{{DEPLOYMENT_ENVIRONMENT}}',
  });
</script>

CAUTION — 패키지 이름 설정

appName은 앱 등록 시 입력한 패키지명과 동일해야 하며 패키지 이름에는 a-z, A-Z, 0-9, -, _, .만 입력할 수 있습니다.

  1. collectorUrl, appName, appVersion, appKey 값은 필수값입니다.

    • collectorUrl 주소는 내부망 또는 외부망 접근 환경에 맞추어 설정해야 합니다. IP 주소로 적용할 경우 http://xxx.xxx.xxx.xxx:4318 형태로 입력합니다.
    • appName 앱 이름 (앱 등록할 때의 패키지명)
    • appVersion 앱 버전
    • appKey 앱 키
    • project 프로젝트
    • deploymentEnvironment 배포 환경

  2. 모든 준비가 완료되었습니다. 이후 모든 계측은 자동으로 수행됩니다. 커스텀 데이터 수집이 필요한 경우 Sophonz Browser SDK API 문서를 참조하세요.