Figma について
Iru は OAuth 2.0(認可コード)を使用します。ソースを有効にすると、ブラウザのポップアップ で Figma に移動し、サインインしてスコープ(ファイル、プロジェクト、組織、チーム、コンポーネント、Webhook、分析など)を承認します。一部のスコープ(例:variables:read)には Enterprise が必要です。下位のプランでは、接続が失敗するのではなく、それらのデータセットが単に省略されます。
仕組み
Iru は Figma の OAuth 2.0 認可コード フローを使用します。ソースをオンにすると、ブラウザのポップアップ で Figma に移動します。サインインしてスコープを確認し、アクセスを許可します。Figma は 認可コード を返し、Iru はそれを アクセストークン(および該当する場合はリフレッシュトークン)に交換します。
代表的なスコープには
files:read、projects:read、org:read、org_teams:read、components:read、webhooks:write(増分更新用)、analytics:read が含まれます。正確な一覧は Figma の認可画面に従います。
公式リファレンス: 認証、スコープ、REST API。
前提条件
- Iru に読み取らせる Figma 組織 の 管理者 または 所有者。
Figma を Iru に接続する
- Figma
- Iru Compliance
適切な組織メンバーが OAuth を完了できるよう、Iru Compliance で Figma を有効にする前にこのタブの手順を完了してください。
1
Figma にサインインする
figma.com を開き、Iru が読み取る 組織 の 管理者 または 所有者 でサインインします。
2
組織とファイルの可視性を確認する
コンプライアンスプログラムでエビデンスとして想定している チーム、プロジェクト、ファイル を開きます。Enterprise 専用のスコープ(例: 一部の variables の読み取り)には、適切なプランとロールが必要です。
4
Iru のポップアップを許可する
Compliance で使用するブラウザプロファイルで、Figma の OAuth ウィンドウがブロックされないよう、Iru のホスト名に対して ポップアップ を許可します。
Iru Compliance タブに進んでください。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
ポップアップがブロックされる
ポップアップがブロックされる
Iru のポップアップを許可し、ソースをオフにしてから再度オンにしてください。
アクセスが拒否される
アクセスが拒否される
組織管理者/所有者 で承認してください。Editor には組織スコープがない場合があります。
チーム/ファイルが表示されない
チーム/ファイルが表示されない
それらのチーム/プロジェクトにアクセスできるユーザーで再承認してください。
トークンの有効期限切れ
トークンの有効期限切れ
Iru から OAuth フローを再実行してください。
考慮事項
承認したユーザーを組織から削除すると…
承認したユーザーを組織から削除すると、アクセスが無効になる場合があります。継続的に利用できる管理者アカウントで再接続してください。
関連記事
Sources の管理
すべての Compliance ソースを参照、管理します。
Compliance を使い始める
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
