이 가이드에서는 소유하고 있는 도메인을 통해 프록시 서버를 설정하고 Hackle SDK와 함께 사용하는 방법을 설명합니다.
이는 광고차단(Ad block) 프로그램이 사용자 행동 추적에 미치는 영향을 줄이는데 유용합니다.

프록시 서버를 설정하고 적용하려면 아래 두단계를 설정해야 합니다.

프록시 서버 설정
SDK에서 프록시 서버를 가리키도록 설정

1. 프록시 서버 설정

클라우드를 통한 설정

대부분의 주요 클라우드 제공업체는 프록시 서비스를 쉽게 개발하고 배포할 수 있습니다.

아래는 AWS CloudFront 를 이용한 프록시 서비스를 설정하는 예시입니다.

AWS CloudFront Console 접속
Create distribution 클릭
Origin 영역
- Origin domain: event.hackle.io 설정
- Protocol: HTTPS Only 설정

Default cache behavior 영역
- Viewer protocol policy: Redirect HTTP to HTTPS 설정
- Allowed HTTP methods: GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE 설정
- Cache key and origin requests: 모든 Header와 Parameter가 Origin으로 전달되도록 허용하고 Origin에 대한 CORS 요청을 허용합니다.

In Function associations 영역
- Origin request: Host 헤더를 event.hackle.io 로 변경하기 위해 Lambda@Edge Function 을 추가합니다.
  참고: Tutorial: Creating a simple Lambda@Edge function

아래 코드를 Lambda@Edge Function 에서 사용합니다.

export const handler = (event, context, callback) => {
  const request = event.Records[0].cf.request;
  request.headers.host[0].value = 'event.hackle.io';
  return callback(null, request);
};

화면 하단 Create distribution 클릭

프록시 서버 구축

프록시 서버를 직접 구축할 수도 있습니다.

NGINX를 이용한 프록시 서버 구축 예시입니다. 아래 설정은 프록시 서버에 대한 모든 호출을 Hackle로 리디렉션합니다.

events {}
http {
    server {
        listen 80;
        listen [::]:80;

        location / {
            proxy_set_header Host event.hackle.io;
            proxy_set_header X-Real-IP $http_x_forwarded_for;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Host $server_name;
            proxy_pass https://event.hackle.io/;
        }
    }
}

2. SDK 설정

SDK에서 프록시 서버를 가리키도록 설정해야 합니다. SDK 초기화시 eventUrl옵션을 통해 설정할 수 있습니다.

const config = {
  eventUrl: "https://<YOUR_PROXY_DOMAIN>"
};

createInstance(YOUR_SDK_KEY, config);

HackleConfig config = HackleConfig.builder()
  .eventUri("https://<YOUR_PROXY_DOMAIN>")
  .build();

HackleApp.initializeApp(getApplicationContext(), YOUR_SDK_KEY, config)

let config = HackleConfigBuilder()
  .eventUrl(URL(string: "https://<YOUR_PROXY_DOMAIN>")!)
  .build()

Hackle.initialize(sdkKey: YOUR_SDK_KEY, config: config)

HackleConfig config = HackleConfigBuilder()
  .eventUrl("https://<YOUR_PROXY_DOMAIN>")
  .build();

await HackleApp.initialize(YOUR_SDK_KEY, hackleConfig: config);