설명서 Audience Manager Audience Manager 사용 안내서

디지털 서명된 `HTTP(S)`개 요청 digitally-signed-http-requests

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

Audience Manager을 사용하려면 유효성을 위해 서버 간 HTTP(S) 요청에 디지털 서명해야 합니다. 이 문서에서는 개인 키로 HTTP(S) 요청에 서명하는 방법에 대해 설명합니다.

개요 overview

귀하가 제공하고 Audience Manager과(와) 공유하는 개인 키를 사용하여 IRIS와(과) HTTP(S) 서버 간에 전송되는 HTTP(S) 요청에 디지털 서명을 할 수 있습니다. 이렇게 하면 다음 사항이 보장됩니다.

인증: 개인 키(IRIS)가 있는 보낸 사람만 파트너에게 유효한 HTTP(S)개의 메시지를 보낼 수 있습니다.
메시지 무결성: 이 방법을 사용하면 HTTP에서도 메시지가 왜곡되는 중간 공격의 남자로부터 보호됩니다.

IRIS은(는) 아래 개인 키 회전 섹션에 표시된 대로 가동 중지 시간 없이 키를 회전할 수 있는 기본 지원을 제공합니다.

제공해야 하는 정보 info-to-provide

HTTP(S) 실시간 서버 간 대상에 대해서는 Audience Manager 컨설턴트에게 연락하여 다음을 지정하십시오.

요청 서명에 사용되는 키입니다.
생성된 서명을 보유할 HTTP(S) 헤더의 이름입니다(아래 예제 헤더의 X-Signature).
선택 사항: 서명에 사용되는 해시 유형(md5, sha1, sha256).

* Connected to partner.website.com (127.0.0.1) port 80 (#0)
> POST /webpage HTTP/1.1
> Host: partner.host.com
> Accept: */*
> Content-Type: application/json
> Content-Length: 20
> X-Signature: +wFdR/afZNoVqtGl8/e1KJ4ykPU=
POST message content

작동 방식 how-it-works

IRIS이(가) 파트너에게 보낼 HTTP(S) 메시지를 만듭니다.
IRIS은(는) HTTP(S) 메시지와 파트너가 통신한 개인 키를 기반으로 서명을 만듭니다.
IRIS이(가) HTTP(S) 요청을 파트너에게 보냅니다. 이 메시지에는 위의 예와 같이 서명과 실제 메시지가 포함되어 있습니다.
파트너 서버가 HTTP(S) 요청을 받습니다. IRIS에서 받은 메시지 본문과 서명을 읽습니다.
수신한 메시지 본문 및 개인 키를 기반으로 파트너 서버는 서명을 다시 계산한다. 이 작업을 수행하는 방법에 대한 아래의 서명 계산 방법 섹션을 참조하십시오.
파트너 서버(받는 사람)에서 만든 서명을 IRIS (보낸 사람)에서 받은 서명과 비교합니다.
서명이 일치하면 정품 인증 및 메시지 무결성 의 유효성을 검사했습니다. 개인 키를 가진 발신자만 유효한 서명(진정성)을 보낼 수 있다. 또한 중간에 있는 사람은 개인 키(메시지 무결성)가 없기 때문에 메시지를 수정하고 유효한 새 서명을 생성할 수 없습니다.

서명 계산 방법 calculate-signature

HMAC (해시 기반 메시지 인증 코드)은 IRIS에서 메시지 서명에 사용하는 메서드입니다. 구현과 라이브러리는 기본적으로 모든 프로그래밍 언어로 사용할 수 있습니다. HMAC에 알려진 확장 공격이 없습니다. 아래 Java의 예제를 참조하십시오.

// Message to be signed.
// For GET type HTTP(S) destinations, the message used for signing will be the REQUEST_PATH + QUERY_STRING
// For POST type HTTP(S) destinations, the message used for signing will be the REQUEST_BODY.
// String getData = "/from-aam-s2s?sids=1,2,3";
String postData = "POST message content";
// Algorithm used. Currently supported: HmacSHA1, HmacSHA256, HmacMD5.
String algorithm = "HmacSHA1";
// Private key shared between the partner and Adobe Audience Manager.
String key = "sample_partner_private_key";

// Perform signing.
SecretKeySpec signingKey = new SecretKeySpec(key.getBytes(), algorithm);
Mac mac = Mac.getInstance(algorithm);
mac.init(signingKey);
byte[] result = mac.doFinal(postData.getBytes());

String signature = Base64.encodeBase64String(result).trim();
// signature = +wFdR/afZNoVqtGl8/e1KJ4ykPU=

HMAC 해시 구현에 대한 RFC는 https://www.ietf.org/rfc/rfc2104.txt입니다. 테스트 사이트: https://asecuritysite.com/encryption/hmac(16진수 인코딩을 base64로 변환해야 함).

개인 키 회전 rotate-private-key

개인 키를 회전하려면 파트너는 Adobe Audience Manager 컨설턴트에게 새 개인 키를 전달해야 합니다. Audience Manager에서 이전 키가 제거되었으며 IRIS은(는) 새 서명 헤더만 보냅니다. 키가 회전되었습니다.

서명에 사용된 데이터 data-signing

GET 유형 대상의 경우 서명에 사용되는 메시지는 REQUEST_PATH + QUERY STRING(예: /from-aam-s2s?sids=1,2,3)입니다. IRIS는 호스트 이름 또는 HTTP(S) 헤더를 고려하지 않습니다. 경로를 따라 수정/잘못 구성되거나 잘못 보고될 수 있습니다.

POST 형식 대상의 경우 서명에 사용되는 메시지는 요청 본문 입니다. 헤더 또는 기타 요청 매개 변수는 다시 무시됩니다.

recommendation-more-help

de293fbf-b489-49b0-8daa-51ed303af695

디지털 서명된 HTTP(S)개 요청 digitally-signed-http-requests