REST API ๋ฐ ์›นํ›…

์—ฌ๋Ÿฌ API ํ‚ค์™€ ์„œ๋ช…๋œ ์›นํ›…์„ ์ง€์›ํ•˜๋Š” ๊ณต๊ฐœ REST API

์›น์‚ฌ์ดํŠธ, ์–‘์‹, ๋ฐฑ์—”๋“œ์—์„œ 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` ๋„๋ฉ”์ธ์„ ๊ฑฐ๋ถ€ํ•ด์š”.

REST API ๋ฐ ์›นํ›…์˜ ์žฅ์ 

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` ์˜ˆ์‹œ๊ฐ€ ํฌํ•จ๋œ ์—”๋“œํฌ์ธํŠธ ๋ฌธ์„œ๊ฐ€ ์žˆ๊ณ , ๊ฐ ์›นํ›…์— ํ…Œ์ŠคํŠธ ์ „์†ก์„ ๋ณด๋‚ด๋Š” ๋ฒ„ํŠผ๊ณผ ๋งˆ์ง€๋ง‰ ์‹œ๋„์˜ ์ƒํƒœ ๋ฐ ์‹œ๊ฐ๋„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด์š”.

Claire Donovan

์˜ค๋Š˜ ์˜คํ›„์— ์›น์‚ฌ์ดํŠธ์™€ CRM์„ ์—ฐ๊ฒฐํ•˜์„ธ์š”

AiCrm์€ REST API๋กœ ์—ฐ๋ฝ์ฒ˜๋ฅผ ๋ฐ›๊ณ  ์„œ๋ช…๋œ ์›นํ›…์œผ๋กœ ์‹œ์Šคํ…œ์— ์•Œ๋ ค ์ฃผ๋Š” AIsToHire์˜ CRM ๋„๊ตฌ์˜ˆ์š”. ๊ณ„์ •์„ ๋งŒ๋“ค๊ณ  ํ‚ค๋ฅผ ์ƒ์„ฑํ•œ ๋‹ค์Œ ์ฒซ ๋ฒˆ์งธ ํ˜ธ์ถœ์„ ํ•ด ๋ณด์„ธ์š”.

์„œ๋ช…๋œ ์›นํ›…์„ ์ง€์›ํ•˜๋Š” CRM REST API | AiCrm