Hub documentation

ゲーティンググループコレクション

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

ゲーティンググループコレクション

この機能は、Team & Enterprise プランの一部です。

Gating Group Collectionsを使用すると、組織はリポジトリ単位ではなく、コレクション内のすべてのモデルとデータセットへのアクセスを一括で許可(または拒否)できます。ユーザーは単一のアクセスリクエストの手続きだけで済みます。

コレクションでGating Groupを有効にするには:

  • コレクションの所有者は組織である必要があります
  • 組織はTeamまたはEnterpriseプランに加入している必要があります
  • コレクション内のすべてのモデルとデータセットは、コレクションと同じ組織によって所有されていなければなりません
  • コレクション内の各モデルまたはデータセットは、1つのGating Group Collectionにのみ属することができます(ただし、通常のコレクション(非ゲーティング)には引き続き含めることができます)。

Gatingはモデルとデータセットにのみ適用されます。コレクションの一部であるその他のリソース(SpaceやPaperなど)には影響しません。

組織管理者としてゲーティンググループを管理する

アクセスリクエストを有効にするには、コレクションページに移動し、右下隅のGating groupをクリックしてください。

Hugging Face collection page with gating group collection feature disabled

デフォルトでは、ゲーティンググループは無効化されています。アクセスリクエストの設定をクリックして設定を開きます。

Hugging Face gating group collection settings with gating disabled

デフォルトでは、コレクション内のリポジトリへのアクセス権は、ユーザーがリクエストした際に自動的に付与されます。これは自動承認と呼ばれます。このモードでは、ユーザーが連絡先情報を共有することに同意すると、誰でもリポジトリにアクセスできるようになります。

Hugging Face gating group collection settings with automatic mode selected

コレクション内のリポジトリへのアクセスを許可するユーザーを手動で承認したい場合は、Manual Reviewに設定する必要があります。この場合、新しいオプションが表示されます:

通知頻度は、新しいユーザーのアクセス要求について通知を受け取るタイミングを設定できます。1日1回またはリアルタイムに設定できます。デフォルトでは、メールは組織の最初の5人の管理者に送信されます。通知メールフィールドで別のメールアドレスを設定することもできます。

Hugging Face gating group collection settings with manual review mode selected

アクセス要求のレビュー

アクセス要求が有効になると、承認モードが手動であっても自動であっても、ゲーティンググループコレクション内のリポジトリへのアクセス権限を完全に管理できます。要求のレビューと管理は、UIまたはAPIのいずれからも行えます。

ゲーティンググループコレクション内のリポジトリへのリクエストを承認すると、そのコレクション内のすべてのリポジトリ(モデルとデータセット)へのアクセスが自動的に承認されます。

UIから

コレクション内のリポジトリのいずれかの設定ページから、アクセス要求を確認ボタンをクリックすることで、Gating Group Collection内のすべてのリポジトリへのアクセス権限を持つユーザーを確認できます。

Hugging Face repo access settings when repo is in a gating group collection

これにより、3つのユーザーリストを含むモーダルが開きます:

  • pending: リポジトリへのアクセス承認を待機しているユーザーのリストです。このリストは、Manual Review を選択していない限り空です。各リクエストに対して、Accept または Reject を選択できます。リクエストが拒否された場合、そのユーザーはリポジトリにアクセスできず、再度アクセスをリクエストすることもできません。
  • accepted: リポジトリへのアクセス権を持つユーザーの完全なリストです。承認モードが手動であっても自動であっても、いつでも任意のユーザーのアクセスをReject(拒否)できます。また、承認をCancel(キャンセル)すると、そのユーザーはpendingリストに移動されます。
  • rejected: 手動で拒否したユーザーのリストです。これらのユーザーはあなたのリポジトリにアクセスできません。リポジトリにアクセスすると、このリポジトリへのアクセスリクエストは、リポジトリの作成者によって拒否されました というメッセージが表示されます。
Manage access requests modal for a repo in a gating group collection

API経由

Gated Group Collectionでは、そのモデルまたはデータセットのいずれかのAPIを介して、アクセスリクエストをプログラムで管理できます。

詳細については、gated modelsまたはgated datasetsのドキュメントをご覧ください。

ダウンロードアクセスレポート

Gated Group Collectionのアクセスレポートは、そのモデルまたはデータセットのいずれかの設定ページからダウンロードできます。

詳細については、gated modelsまたはgated datasetsのドキュメントをご覧ください。

収集するプロファイルデータを選択

デフォルトでは、Hugging Face はリクエスト者のユーザー名とメインのメールアドレスを組織と共有します。ゲーティンググループの設定で、Hugging Face が共有する情報を制御し、変更できます。これらの設定はコレクション内のすべてのリポジトリに適用され、新しいリクエストにのみ影響します。

詳細については、gated modelsまたはgated datasetsのドキュメントをご覧ください。

要求される情報のカスタマイズ

組織は、ゲーティングのパラメータだけでなく、ゲーティング対象のリポジトリごとに収集されるユーザー情報もカスタマイズできます。詳細については、ゲーティング対象のモデルまたはゲーティング対象のデータセットのドキュメントをご覧ください。

上記のプロファイルデータ設定を除き、現在、ゲートパラメータと要求される情報を一元管理してカスタマイズする方法はありません。ユーザーがコレクション内のどのリポジトリへのアクセスを要求しても同じデータを収集したい場合は、コレクション内のすべてのモデルとデータセットのメタデータに同じゲートパラメータを追加し、同期を維持する必要があります。

高度な設定

Enterprise Plus 組織は、すべてのモデルとデータセットにおいて、特定の地域からの訪問者を自動的に拒否またはブロックできます。これらの設定は、Publisher Analytics 設定の Advanced Gating タブにあります。

強制

Enforcement設定は、ブロックされた訪問者に拒否される内容を制御します。

  • ゲート付きリポジトリ:組織のゲート付きリポジトリへのアクセスリクエストは自動的に拒否されます。
  • すべてのリポジトリ: アクセス要求の自動拒否に加えて、組織のすべてのリポジトリ(パブリックリポジトリを含む)でのダウンロードが拒否されます。ブロックされた訪問者は、リポジトリページで「あなたの地域では利用できません」という通知が表示され、データセットビューアが無効になります。

この強制適用は、ブロック対象の国や地域からの訪問者に適用されます。サインインの有無を問いません。組織のメンバーも例外ではありません。

ブロックされた場所

ブロック対象の場所を定義するリストは2つあります:

  • ブロック対象国: ISO 3166-1 alpha-2コードで識別される国。
  • ブロック対象の地域: 上記の国とは別にブロックする特定の地域。独立した国ではないため、上記のリストから選択できない地域に使用します。

Gating Group Collection内のゲート付きリポジトリにユーザーとしてアクセスする

Gated Group Collectionの名前の横には、特定のアイコンが表示されます:

Hugging Face collection page with gating group collection feature enabled

Gated Group Collection内のモデルとデータセットにアクセスするには、これらのリポジトリのいずれかのページで1回のアクセス申請が必要です。申請が承認されると、将来追加されるリポジトリを含む、コレクション内の他のすべてのリポジトリにアクセスできるようになります。

リポジトリへのアクセスをリクエストする方法について詳しく知るには、gated modelsまたはgated datasetsのドキュメントをご覧ください。

Update on GitHub