사전 확인 사항

Figma의 SCIM API를 통합하려면 아래 사항이 필요합니다.

- Figma 관리자 계정이 필요합니다.

- Figma에서 Org 이상의 플랜을 구독중이어야 합니다.

- Figma에서 SAML SSO 설정을 활성화해야 합니다.

- Figma 앱 인스턴스에서 SCIM API를 통합한 후 추가된 사용자부터 조회할 수 있습니다.

개요

Figma의 SCIM API를 통합하면, PoPs에서 Figma의 사용자 정보들을 확인할 수 있습니다.

- Figma 사용자의 이름
- Figma 사용자의 이메일
- Figma 사용자의 상태

또한 아래와 같은 기능을 사용할 수 있습니다.

- 사용자 프로비저닝

사용자 프로비저닝 기능에 대한 자세한 안내는 다음 가이드를 참고해주세요.

사용자 프로비저닝이란?

Figma 앱 인스턴스에 SCIM API 통합하기

1. Megazone PoPs 워크스페이스 관리 콘솔에 관리자 계정으로 로그인합니다.
   
   
2. Figma 앱 인스턴스 상세 페이지에서 [통합] 탭으로 이동하여 SCIM API의 [통합하기] 버튼을 클릭합니다.
   
   
   
3. API 사용 권한 인증 다이얼로그가 노출되면 API 인증 정보 및 추가 정보를 입력합니다.
   
   [Token]과 [API base URL]은 다음과 같은 방법으로 확인하여 입력합니다.
   1. Figma에 조직 관리자 계정으로 로그인합니다.
   2. 좌측 메뉴에서 API를 통합할 조직의 [Admin] 메뉴를 클릭합니다.
   
   3. [로그인 및 프로비저닝 섹션]에서 SAML SSO를 활성화합니다. 이미 활성화된 경우, 해당 단계를 건너뛰어도 됩니다. 아직 활성화되지 않았다면 Figma 앱에 SAML SSO 설정하기 또는 Figma에서 제공하는 가이드 를 참고하여 SAML SSO를 활성화해주세요.
   4. [로그인 및 프로비저닝 섹션]에서 활성화된 SAML SSO를 클릭하여 SAML SSO 다이얼로그가 노출되면 [Tenant ID]를 복사합니다.
   
   5. [로그인 및 프로비저닝 섹션]에서 SCIM Provisioning을 클릭하여 SCIM Provisioning 다이얼로그가 노출되면 [Generate API token]을 클릭합니다.
   
   6. 다이얼로그에 표시되는 [API Token]을 복사합니다. 
   
   
4. Figma에서 복사한 [Tenant ID]와 [Token]을 PoPs의 API 사용 권한 인증 다이얼로그에 입력한 뒤 [인증] 버튼을 클릭합니다.
   
   
5. API를 사용하기 위한 권한이 충분히 부여되어 있으면 인증 성공 토스트가 노출됩니다. 
   
   ※ 만약 통합에 실패하면 아래 사항을 확인한 뒤 다시 시도해주세요.
   - API를 사용하기 위한 Plan 조건을 만족하는 Figma 조직에서 발급한 API Token으로 통합을 시도했는지
   - API 통합 시 요구하는 정보를 정확히 입력했는지
   
   
6. API 통합이 완료되면, Figma 앱 인스턴스 내 [사용자] 탭에서 Figma 사용자 정보를 확인할 수 있습니다.
   ※ 단, Figma 정책에 따라 SCIM API를 통합한 이후에 Figma에 추가된 사용자부터 조회할 수 있습니다. 따라서 API를 통합하기 전, 기존에 Figma에 이미 추가되어 있던 사용자들도 PoPs 앱 인스턴스에서 조회하려면, 해당 사용자들을 PoPs 앱 인스턴스에서 할당합니다. 이 경우, 해당 사용자들을 Figma에 새로 프로비저닝함으로써 SCIM 통합 이후 생성된 사용자로 업데이트되어 PoPs 앱 인스턴스에서 조회할 수 있습니다.