ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋œ ์‚ฌ์šฉ์ž์˜ ์ฝ˜ํ…์ธ  ์ด์ „

์ด ์ฐธ์กฐ ๋ฌธ์„œ์— ์žˆ๋Š” ๋‚ด์šฉ

์ด ๋ฌธ์„œ์—์„œ๋Š” ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๊ฐ€ ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ ์›Œํฌ์ŠคํŽ˜์ด์Šค์—์„œ ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋œ ๋ฉค๋ฒ„์˜ ์ฝ˜ํ…์ธ ๋ฅผ ์ด์ „ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•ด ๋“œ๋ฆด๊ฒŒ์š”.


์‚ฌ์šฉ์ž๊ฐ€ ์ œ๊ฑฐ๋˜์—ˆ๊ฑฐ๋‚˜, ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋˜์—ˆ๊ฑฐ๋‚˜, ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ๋‚˜๊ฐ€๋Š” ๊ฒฝ์šฐ, ๊ฐœ์ธ ํŽ˜์ด์ง€ ์ฝ˜ํ…์ธ ๋ฅผ ๋‚จ๊ธฐ๊ณ  ๊ฐˆ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๋Š” ๋‚จ์€ ์ฝ˜ํ…์ธ ๋ฅผ ๋‹ค๋ฅธ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ด์ „ํ•˜์—ฌ ์‰ฝ๊ฒŒ ๋ณต๊ตฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ฐธ๊ณ : ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ๋‚˜๊ฐ„ ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€ ์ฝ˜ํ…์ธ ์— ์ ์šฉ๋˜๋Š” ํ”„๋กœ์„ธ์Šค์ž…๋‹ˆ๋‹ค. ํ˜„์žฌ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฉค๋ฒ„์™€ ๊ณต์œ ๋œ ์ฝ˜ํ…์ธ ๋Š” ์ด์ „ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.

์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ฒฝ์šฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ์ตœ๊ทผ์— ๋‚˜๊ฐ„ ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€ ์ฝ˜ํ…์ธ ๋ฅผ ์ด์ „ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • ์‚ฌ์šฉ์ž๊ฐ€ ํ˜„์žฌ ์›Œํฌ์ŠคํŽ˜์ด์Šค์˜ ์ผ์›์ด ์•„๋‹Œ ๊ฒฝ์šฐ(ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋จ)

  • ์‚ฌ์šฉ์ž์—๊ฒŒ ๊ฐœ์ธ ํŽ˜์ด์ง€๊ฐ€ ์žˆ๋Š” ๊ฒฝ์šฐ

  • ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€๊ฐ€ ๋‹ค๋ฅธ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ด๋ฏธ ์ด์ „๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ

  • ์‚ฌ์šฉ์ž๊ฐ€ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ๋‚˜๊ฐ„ ์ง€ 30์ผ์ด ์ง€๋‚˜์ง€ ์•Š์€ ๊ฒฝ์šฐ

  • ์›Œํฌ์ŠคํŽ˜์ด์Šค์—์„œ ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ๋ฅผ ๊ตฌ๋… ์ค‘์ธ ๊ฒฝ์šฐ

  1. ์„ค์ •์œผ๋กœ ์ด๋™ํ•œ ํ›„ ๋ฉค๋ฒ„ ์„น์…˜์„ ํด๋ฆญํ•˜์„ธ์š”.

  2. ์ตœ๊ทผ ๋‚˜๊ฐ ํƒญ์œผ๋กœ ์ด๋™ํ•˜์„ธ์š”.

  3. ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋œ ์‚ฌ์šฉ์ž์˜ ๊ฒฝ์šฐ('์ตœ๊ทผ ๋‚˜๊ฐ„ ์‚ฌ์šฉ์ž'), ํ•ด๋‹น ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€๋ฅผ ๋ณด๋‚ด๊ณ ์ž ํ•˜๋Š” ๋Œ€์ƒ์„ ์„ ํƒํ•˜์„ธ์š”.

  4. ํ™•์ธ์ฐฝ์ด ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. ๊ฐœ์ธ ํŽ˜์ด์ง€ ์ด์ „์„ ์„ ํƒํ•˜์—ฌ ๊ฐœ์ธ ํŽ˜์ด์ง€ ์ด์ „ ํ”„๋กœ์„ธ์Šค๋ฅผ ๊ณ„์†ํ•˜์„ธ์š”.

  5. ํ”„๋กœ๋น„์ €๋‹ ํ•ด์ œ๋œ ์‚ฌ์šฉ์ž์˜ ๋ชจ๋“  ๊ฐœ์ธ ํŽ˜์ด์ง€๊ฐ€ ์ด์ „ ๋Œ€์ƒ ์‚ฌ์šฉ์ž์˜ ์‚ฌ์ด๋“œ๋ฐ”์— ํ‘œ์‹œ๋˜๋ฉฐ, ์ƒˆ๋กœ์šด ์ตœ์ƒ์œ„ ๊ฐœ์ธ ํŽ˜์ด์ง€ ์•ˆ์— ์ค‘์ฒฉ๋ฉ๋‹ˆ๋‹ค.

์ฐธ๊ณ : ๋ชจ๋“  ๊ฐœ์ธ ํŽ˜์ด์ง€๊ฐ€ ์žฌํ• ๋‹น๋œ ์‚ฌ์šฉ์ž๋Š” ๋” ์ด์ƒ ์ตœ๊ทผ ๋‚˜๊ฐ ๋ฆฌ์ŠคํŠธ์— ๋‚˜ํƒ€๋‚˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๋Š” ์ฝ˜ํ…์ธ  ์ด์ „ API๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ตœ๊ทผ์— ์ œ๊ฑฐ๋œ ์›Œํฌ์ŠคํŽ˜์ด์Šค ๋ฉค๋ฒ„์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€๋ฅผ ๋‹ค๋ฅธ ๋ฉค๋ฒ„์—๊ฒŒ ์ด์ „ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด API๋Š” ์œ„์—์„œ ์–ธ๊ธ‰๋œ ๊ฒƒ๊ณผ ๋™์ผํ•œ ์ž๊ฒฉ ์š”๊ฑด์„ ํ•„์š”๋กœ ํ•ฉ๋‹ˆ๋‹ค.

์ด API๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•ด ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๊ฐ€ ํ•  ์ˆ˜ ์žˆ๋Š” ์ž‘์—…์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

  1. ์ฝ˜ํ…์ธ  ์ด์ „ ๊ธฐ๋Šฅ์œผ๋กœ ๋‚ด๋ถ€์šฉ ํ†ตํ•ฉ์„ ์ƒˆ๋กœ ๋งŒ๋“ญ๋‹ˆ๋‹ค.

  2. ์ฝ˜ํ…์ธ ๋ฅผ ์ด์ „ํ•˜๋ ค๋ฉด ๋‹ค์Œ API ํ˜ธ์ถœ์„ ์‚ฌ์šฉํ•˜์„ธ์š”.

curl -X POST '<https://api.notion.com/v1/users/transfer>' \\

-H 'Authorization: Bearer <token>' \\

-H 'Notion-Version: 2022-06-28' \\

-H "Content-Type: application/json" \\

-d '{ "from_user_id": <from_user_id>,"to_user_id":<to_user_id>}'

  • from_user_id๋Š” ์ œ๊ฑฐ๋œ ์‚ฌ์šฉ์ž๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. SCIM ์›นํ›…์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ user_id๊ฐ€ ํŽ˜์ด๋กœ๋“œ์— ํฌํ•จ๋ฉ๋‹ˆ๋‹ค.

  • to_user_id๋Š” ์ด์ „๋œ ์ฝ˜ํ…์ธ ์˜ ์ˆ˜์‹ ์ธ์„ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ์ด user_id๋ฅผ ๊ฒ€์ƒ‰ํ•˜๋ ค๋ฉด ๋ฆฌ์ŠคํŠธ users API ์—”๋“œํฌ์ธํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ID ๊ณต๊ธ‰์ž๊ฐ€ ์ œ๊ณตํ•œ API๋ฅผ ์‚ฌ์šฉํ•ด Notion ๊ณต๊ฐœ API๋ฅผ ์ฟผ๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, Okta๋Š” listAppUsers API๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. appUser์˜ externalID๋Š” Notion ์‚ฌ์šฉ์ž ID์ž…๋‹ˆ๋‹ค.

curl '<https://api.notion.com/v1/users>' \\\\

-H 'Authorization: Bearer '"$NOTION_API_KEY"'' \\\\

-H "Notion-Version: 2022-06-28"

3. ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ๊ฐ€ ์‹คํŒจํ•˜๋ฉด API๊ฐ€ ์‹คํŒจ ์‘๋‹ต์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ๋ฐœ์‹ ์ธ ์‚ฌ์šฉ์ž๊ฐ€ ์—ฌ์ „ํžˆ ์›Œํฌ์ŠคํŽ˜์ด์Šค์— ์žˆ๊ฑฐ๋‚˜ ์›Œํฌ์ŠคํŽ˜์ด์Šค๊ฐ€ ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์š”๊ธˆ์ œ๊ฐ€ ์•„๋‹Œ ๊ฒฝ์šฐ ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ๊ฐ€ ์‹คํŒจํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ๊ฐ€ ํ†ต๊ณผ๋˜๋ฉด API๊ฐ€ ์„ฑ๊ณต ์‘๋‹ต์„ ๋ฐ˜ํ™˜ํ•˜๊ณ  ์ด์ „ ์ฒ˜๋ฆฌ๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ์ด์ „์ด ์™„๋ฃŒ๋˜๋ฉด ์ด์ „๋œ ์ฝ˜ํ…์ธ ๊ฐ€ ์ˆ˜์‹ ์ธ์˜ ๊ฐœ์ธ Notion ์ฝ˜ํ…์ธ ์— ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. ์ˆ˜์‹ ์ธ์€ ์ˆ˜์‹ ํ•จ๊ณผ ์ด๋ฉ”์ผ ์•Œ๋ฆผ๋„ ๋ฐ›๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

์‚ฌ์šฉ์ž๊ฐ€ ์›Œํฌ์ŠคํŽ˜์ด์Šค๋ฅผ ๋– ๋‚ฌ๋‹ค๊ฐ€ ์ง€๋‚œ 30์ผ ๋‚ด์— ๋‹ค์‹œ ๊ฐ€์ž…ํ•˜๋Š” ๊ฒฝ์šฐ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์†Œ์œ ์ž๋Š” ํ•ด๋‹น ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ธ ํŽ˜์ด์ง€, ๊ณต์œ ๋œ ํŽ˜์ด์ง€, ๊ทธ๋ฃน ๋ฉค๋ฒ„์‹ญ, ํŒ€์ŠคํŽ˜์ด์Šค ๋ฉค๋ฒ„์‹ญ์„ ๋ณต์›ํ•  ์ˆ˜ ์žˆ์–ด์š”.

์ด๋ฅผ ์ˆ˜ํ–‰ํ•˜๋ ค๋ฉด ์„ค์ • โ†’ ์‚ฌ๋žŒ ๋˜๋Š” ๋ฉค๋ฒ„(์š”๊ธˆ์ œ์— ๋”ฐ๋ผ ๋‹ค๋ฆ„)๋กœ ์ด๋™ํ•˜์—ฌ ๋ฉค๋ฒ„๋ฅผ ์›Œํฌ์ŠคํŽ˜์ด์Šค์— ๋‹ค์‹œ ์ถ”๊ฐ€ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค. ๋ฉค๋ฒ„๊ฐ€ ๋‹ค์‹œ ์ถ”๊ฐ€๋˜๋ฉด ๋™์ผํ•œ ์„ค์ •์—์„œ ์ด๋ฆ„ ์˜†์˜ ํ™”์‚ดํ‘œ๋ฅผ ์„ ํƒํ•˜์—ฌ ์‚ฌ์šฉ ๊ถŒํ•œ๊ณผ ์ฝ˜ํ…์ธ ๋ฅผ ๋ณต์›ํ•˜์„ธ์š”.


ํ”ผ๋“œ๋ฐฑ ๋ณด๋‚ด๊ธฐ

์ด ๋‚ด์šฉ์ด ๋„์›€์ด ๋˜์—ˆ๋‚˜์š”?


๋‹ค์Œ

๊ฐ์‚ฌ ๋กœ๊ทธ

๊ฐ์‚ฌ ๋กœ๊ทธ๋Š” ์—”ํ„ฐํ”„๋ผ์ด์ฆˆ ์กฐ์ง ์†Œ์œ ์ž์—๊ฒŒ ๋ณด์•ˆ ๋ฐ ์•ˆ์ „ ๊ด€๋ จ ํ™œ๋™์— ๋Œ€ํ•œ ์ƒ์„ธ ์ •๋ณด์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋Š” ์‚ฌ์šฉ ๊ถŒํ•œ์„ ๋ถ€์—ฌํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ์ž ์žฌ์ ์ธ ๋ณด์•ˆ ๋ฌธ์ œ๋ฅผ ์‹๋ณ„ํ•˜๊ณ , ์˜์‹ฌ์Šค๋Ÿฌ์šด ํ–‰๋™์„ ์กฐ์‚ฌํ•˜๋ฉฐ, ์‚ฌ์šฉ ๊ถŒํ•œ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋Š” ๋ฐ ๋„์›€์ด ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Powered by Fruition