Figma 정보
Iru는 OAuth 2.0(authorization code)을 사용합니다. 소스를 활성화하면 브라우저 팝업이 Figma로 이동하여 로그인하고 범위(파일, 프로젝트, 조직, 팀, 컴포넌트, 웹훅, 분석 등)를 승인하도록 합니다. 일부 범위(예:variables:read)에는 Enterprise가 필요합니다. 하위 요금제에서는 연결이 실패하는 대신 해당 데이터 세트만 생략됩니다.
작동 방식
Iru는 Figma의 OAuth 2.0 authorization code 흐름을 사용합니다. 소스를 켜면 브라우저 팝업이 Figma로 이동하며, 로그인하여 범위를 검토하고 액세스 권한을 부여합니다. Figma는 인증 코드를 반환하고, Iru는 이를 액세스 토큰(해당하는 경우 새로 고침 토큰 포함)으로 교환합니다.
대표적인 범위에는
files:read, projects:read, org:read, org_teams:read, components:read, webhooks:write(증분 업데이트용) 및 **analytics:read**가 포함됩니다. 정확한 목록은 Figma 인증 화면을 따릅니다.
공식 참고 자료: Authentication, Scopes, REST API.
사전 요구 사항
- Iru가 읽을 Figma 조직의 관리자 또는 소유자 권한.
Figma를 Iru에 연결
- Figma
- Iru Compliance
올바른 조직 멤버가 OAuth를 완료할 수 있도록 Iru Compliance에서 Figma를 활성화하기 전에 이 탭을 완료하세요.
1
Figma에 로그인
figma.com을 열고 Iru가 읽을 조직의 관리자 또는 소유자 계정으로 로그인합니다.
2
조직 및 파일 가시성 확인
컴플라이언스 프로그램에서 증거로 필요한 팀, 프로젝트 및 파일을 엽니다. Enterprise 전용 범위(예: 일부 variables 읽기)에는 적절한 요금제와 역할이 필요합니다.
3
범위 문서 검토
동의 화면이 예상과 일치하도록 Figma authentication 및 Scopes를 훑어봅니다.
4
Iru에 대한 팝업 허용
Compliance에 사용할 브라우저 프로필에서 Figma OAuth 창이 차단되지 않도록 Iru 호스트 이름에 대한 팝업을 허용합니다.
Iru Compliance 탭에서 계속 진행하세요.
문제 해결
소스를 켜도 아무것도 열리지 않음
소스를 켜도 아무것도 열리지 않음
Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
팝업 차단됨
팝업 차단됨
Iru에 대한 팝업을 허용하고 소스를 껐다가 다시 켜세요.
액세스 거부됨
액세스 거부됨
조직 관리자/소유자로 승인하세요. Editor에게는 조직 범위가 없을 수 있습니다.
팀/파일 누락
팀/파일 누락
해당 팀/프로젝트에 액세스할 수 있는 사용자로 다시 승인하세요.
토큰 만료
토큰 만료
Iru에서 OAuth 흐름을 다시 실행하세요.
고려 사항
승인한 사용자를 조직에서 제거하면…
승인한 사용자를 조직에서 제거하면 액세스가 무효화될 수 있습니다. 지속적으로 유지되는 관리자 계정으로 다시 연결하세요.
관련 문서
Sources 관리
모든 Compliance 소스를 찾아보고 관리합니다.
Compliance 시작하기
프레임워크, 작업 및 아티팩트.
Iru 개요
Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
Artifacts 관리
소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.
