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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

curl -X POST '<https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=v1 mem-invalid-attributes-holder=users mem-invalid-attributes-holder=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๋Š” ์ด์ „๋œ ์ฝ˜ํ…์ธ ์˜ ์ˆ˜์‹ ์ž๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ๋ฆฌ์ŠคํŠธ ์‚ฌ์šฉ์ž API ์—”๋“œํฌ์ธํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ Notion ์˜คํ”ˆ API๋ฅผ ์ฟผ๋ฆฌํ•˜๊ฑฐ๋‚˜ ID ๊ณต๊ธ‰์ž๊ฐ€ ์ œ๊ณตํ•œ API๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ด user_id๋ฅผ ๊ฒ€์ƒ‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด, Okta๋Š” listAppUsers API๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. appUser์˜ externalID๋Š” Notion ์‚ฌ์šฉ์ž ID์ž…๋‹ˆ๋‹ค.

curl '<https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=v1 mem-invalid-attributes-holder=users>
' \\\\

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

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

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

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

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


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

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


๋‹ค์Œ

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

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

Powered by Fruition