์น์ฌ์ดํธ, ์์, ๋ฐฑ์๋์์ HTTP ํธ์ถ ํ ๋ฒ์ผ๋ก ๊ณ ๊ฐ์ ๋ฑ๋กํ๊ณ , ๋ชจ๋ ๋ณ๊ฒฝ ์ฌํญ์ HMAC-SHA256์ผ๋ก ์๋ช ํด ์๋ฒ๋ก ๋ฐ์ ๋ณด์ธ์.
CRM์ ๋ ์ด์ ๋ค์ด๊ฐ์ ์ง์ ์ ๋ ฅํ๋ ๊ณณ์ด ์๋๋ผ, ์์คํ ์ด ํธ์ถํ๋ ์๋ํฌ์ธํธ๊ฐ ๋ผ์.
AIsToHire์ CRM ์ฑ์ธ AiCrm์ ๋ด ์ฐ๋ฝ์ฒ์ ๋ํ ๊ณต๊ฐ REST API๋ฅผ ์ ๊ณตํด์. `X-Api-Key` ํค๋์ ํค๋ฅผ ๋ด์ผ๋ฉด ์น์ฌ์ดํธ ์์, ์ฑ๋ด, Zap, Python ์คํฌ๋ฆฝํธ, ์์ฒด ๋ฐฑ์๋ ์ด๋์์๋ ์ฐ๋ฝ์ฒ๋ฅผ ์์ฑ, ๋ชฉ๋ก ์กฐํ, ์์ธ ์กฐํ, ์์ , ์ญ์ ํ๊ณ ์ฐ๋ฝ์ฒ์ ํ๋์ ์ถ๊ฐํ ์ ์์ด์. ์๋ต์ `{ success, data }` ํํ์ JSON์ด๊ณ , ์ ํ์ ํค๋น ๋ถ๋น 100๊ฑด์ด์์.
API๋ก ๋ฑ๋กํด๋ ์ค๋ณต์ด ์๊ธฐ์ง ์์์. ๋ณด๋ธ ์ด๋ฉ์ผ์ด ์ด๋ฏธ DB์ ์์ผ๋ฉด AiCrm์ด ๊ธฐ์กด ์นด๋๋ฅผ ์ ๋ฐ์ดํธํ๊ณ (๋น ์ ธ ์๋ ์ ํ๋ฒํธ, ์ด๋ฆ, ํ์ฌ๋ฅผ ์ฑ์ฐ๊ณ ํ๊ทธ๋ฅผ ํฉ์ณ์) ํ์๋ผ์ธ์ ์ ์ ์ถ ๋ด์ญ์ ๊ธฐ๋กํ ๋ค HTTP 200์ ๋ฐํํด์. ์๋ก์ด ์ฐ๋ฝ์ฒ๋ฉด ์์ฑํ๊ณ 201์ ๋ฐํํด์. API๋ก ๋ค์ด์จ ์ฐ๋ฝ์ฒ์๋ ์๋์ผ๋ก `api-lead` ํ๊ทธ๊ฐ ๋ถ๊ณ , ๋ณด๋ธ ํ๊ทธ๊ฐ ์ ์ง๋๋ฉฐ, ์ ์ `subId`์ ํจ๊ป ์ ์ํ ๊ตญ๊ฐ, IP, ๋ธ๋ผ์ฐ์ ๋ ์ ์ฅ๋ผ์.
์ด๋ฆ์ ๋ถ์ธ API ํค๋ฅผ ์ฑ ๋ด๋ถ ํค์ ๋ณ๊ฐ๋ก ์ต๋ 20๊ฐ๊น์ง ๋ง๋ค ์ ์์ด์. ์น์ฌ์ดํธ, 5์ ์บ ํ์ธ ์์, ์ธํด, ํ๋ ฅ์ ์ฒด์ฒ๋ผ ์ฐ๋๋ง๋ค ๋ค๋ฅธ ํค๋ฅผ ์ฃผ๊ณ , ํด๋น ์ฐ๋์ด ๋๋๋ฉด ๋ค๋ฅธ ๊ฒ์ ๊ฑด๋๋ฆฌ์ง ์๊ณ ๊ทธ ํค๋ง ํ๊ธฐํ๋ฉด ๋ผ์. ํค์ ์ ์ฒด ๊ฐ์ ๋ง๋ค ๋ ๋จ ํ ๋ฒ๋ง ํ์๋๊ณ , ์ดํ ๋ชฉ๋ก์์๋ ๊ฐ๋ ค์ง ์ํ๋ก๋ง ๋ณด์ฌ์.
๋ฐ๋ ๋ฐฉํฅ์ผ๋ก๋ ์นํ ์ด ์์คํ ์ ์๋ ค ์ค์. ๋์์ ์ต๋ 10๊ฐ๊น์ง ์ค์ ํ๊ณ ๊ฐ๊ฐ์ด ๊ตฌ๋ ํ ์ด๋ฒคํธ(`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`)๋ฅผ ๊ณ ๋ฅด๋ฉด, AiCrm์ด `X-AiCrm-Event`์ `X-AiCrm-Signature: sha256=โฆ` ํค๋๋ฅผ ๋ถ์ฌ ๋ด URL๋ก POSTํด์. ์๋ช ์ ํด๋น ์นํ ์ ๋น๋ฐ ํค๋ก ๋ณธ๋ฌธ์ ๋ํด ๊ณ์ฐํ HMAC-SHA256 ๊ฐ์ด๋ฏ๋ก ์ ์ก์ด ์ ์์ธ์ง ๊ฒ์ฆํ ์ ์์ด์. URL์ ์ ์ฅํ ๋ SSRF ๋ฐฉ์ด ๊ธฐ๋ฅ์ด localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0, ๊ทธ๋ฆฌ๊ณ `.local`๊ณผ `.internal` ๋๋ฉ์ธ์ ๊ฑฐ๋ถํด์.
API ํ ๋ฒ ํธ์ถ๋ก ์ฐ๋ฝ์ฒ ๋ฑ๋ก
์ด๋ฉ์ผ๊ณผ ์ํ๋ ํ๊ทธ๋ฅผ ๋ด์ `/api/apps/public/crm/customers`๋ก POSTํ๋ฉด, ๋ฆฌ๋๊ฐ ๋ถ๋ฅ๋ ์ํ๋ก CRM์ ๋ฐ๋ก ๋ค์ด์์.
Ventaja 2
์ค๊ณ๋ถํฐ ์ค๋ณต์ด ์์ด์. ์ด๋ฉ์ผ์ด ์ด๋ฏธ ์์ผ๋ฉด ์นด๋๋ฅผ ์ ๋ฐ์ดํธํ๊ณ ์ ์ ์ถ ๋ด์ญ์ ํ์๋ผ์ธ์ ๊ธฐ๋กํ ๋ฟ, ๋ ๋ฒ์งธ ์นด๋๋ฅผ ๋ง๋ค์ง ์์์.
Ventaja 3
์ด๋ฆ์ ๋ถ์ธ ํค๋ฅผ ์ต๋ 20๊ฐ๊น์ง ๋ง๋ค ์ ์์ด์. ์ฐ๋๋ง๋ค ํ๋์ฉ ์ฐ๊ณ ๋ฐ๋ก ํ๊ธฐํ ์ ์์ด์. ํค๊ฐ ์ ์ถ๋๋ฉด ๊ทธ ํค๋ง ์ญ์ ํ๋ฉด ๋๊ณ , ๋ค๋ฅธ ๊ฒ์ ์ํฅ์ด ์์ด์.
HMAC-SHA256์ผ๋ก ์๋ช ๋ ์นํ
๋น๋ฐ ํค๋ก `X-AiCrm-Signature` ํค๋๋ฅผ ๊ฒ์ฆํ๋ฉด, ์๋ฆผ์ด ์ 3์๊ฐ ์๋ ๋ด CRM์์ ์จ ๊ฒ์์ ํ์ธํ ์ ์์ด์.
Ventaja 5
SSRF ๋ฐฉ์ด ๊ธฐ๋ฅ์ด ๊ธฐ๋ณธ ์ ๊ณต๋ผ์. ์ฑ์ด localhost๋ ์ฌ์ค ๋คํธ์ํฌ ๋์ญ์ผ๋ก๋ ์นํ ์ ์ ๋ฌํ์ง ์์ผ๋ฏ๋ก, CRM์ด ๋ด๋ถ ๋คํธ์ํฌ๋ฅผ ํ์ํ๋ ๋ฐ ์ ์ฉ๋ ์ ์์ด์.
Ventaja 6
๋ฑ๋ก๋ง ๋๋ ๊ฒ ์๋๋ผ CRUD๋ฅผ ๋ชจ๋ ์ง์ํด์. ํ์ด์ง๋ค์ด์ ๊ณผ ํํฐ(๊ฒ์, ์ํ, ํ๊ทธ, ๊ตญ๊ฐ)๋ก ๋ชฉ๋ก ์กฐํ, ํ๋ ๋ด์ญ์ ํฌํจํ ์ฐ๋ฝ์ฒ ์กฐํ, ์์ , ์ญ์ , ํ๋ ๊ธฐ๋ก๊น์ง ๊ฐ๋ฅํด์.
Ventaja 7
์ ์ ๊ฒฝ๋ก๊ฐ ์๋์ผ๋ก ๊ธฐ๋ก๋ผ์. API๋ก ๋ฑ๋กํ ๋๋ง๋ค ๋ณด๋ด ์ค `subId`์ ๊ตญ๊ฐ, IP, ๋ธ๋ผ์ฐ์ ๊ฐ ์ ์ฅ๋๊ณ `api-lead` ํ๊ทธ๊ฐ ๋ถ์ผ๋ฏ๋ก ๋์ค์ ์ฑ์์ ์ฝ๊ฒ ํํฐ๋งํ ์ ์์ด์.
Ventaja 8
์ถ์ธก ์์ด ํ ์คํธํด์. ์ฑ์ ๋ณต์ฌํด์ ์ธ ์ ์๋ `curl` ์์๊ฐ ํฌํจ๋ ์๋ํฌ์ธํธ ๋ฌธ์๊ฐ ์๊ณ , ๊ฐ ์นํ ์ ํ ์คํธ ์ ์ก์ ๋ณด๋ด๋ ๋ฒํผ๊ณผ ๋ง์ง๋ง ์๋์ ์ํ ๋ฐ ์๊ฐ๋ ํ์ธํ ์ ์์ด์.

AiCrm์ REST API๋ก ์ฐ๋ฝ์ฒ๋ฅผ ๋ฐ๊ณ ์๋ช ๋ ์นํ ์ผ๋ก ์์คํ ์ ์๋ ค ์ฃผ๋ AIsToHire์ CRM ๋๊ตฌ์์. ๊ณ์ ์ ๋ง๋ค๊ณ ํค๋ฅผ ์์ฑํ ๋ค์ ์ฒซ ๋ฒ์งธ ํธ์ถ์ ํด ๋ณด์ธ์.