カスタム組織ロールの権限

カスタム組織役割を作成することで、organization とリポジトリの設定に付与するアクセスをより細かく制御できます。 組織の役割は、組織とそのリポジトリの完全な管理制御を許可することなく、組織のメンバーに設定の特定のサブセットを管理する権限を許可する方法です。 たとえば、「組織監査ログビュー」 のアクセス許可を含む役割を作成できます。

Organization の設定で、カスタム Organization ロールを作成して割り当てることができます。 REST API を使用してカスタム ロールを管理することもできます。 「カスタム組織の役割の管理」を参照してください。

組織とリポジトリのアクセス許可の組み合わせ

リポジトリに対するアクセス許可を含むカスタム Organization ロールを作成することもできます。 リポジトリに対するアクセス許可は、Organization 内の現在および今後のすべてのリポジトリに対するアクセス権を付与します。

リポジトリと Organization に対するアクセス許可を組み合わせる方法はいくつかあります。

• Organization 設定に対するアクセス許可を含むロール、リポジトリ アクセス権のための基本ロール、またはその両方を含むロールを作成できます。
• リポジトリ アクセス権のための基本ロールを追加した場合は、リポジトリに対するさらなるアクセス許可を追加することもできます。 基本リポジトリ ロールがないと、リポジトリに対するアクセス許可を追加することはできません。

リポジトリに対するアクセス許可や基本リポジトリ ロールがない場合、その Organization ロールにはどのリポジトリに対するアクセス権も付与されません。

Organization 内の特定のリポジトリに対するアクセス権を付与するために、カスタム リポジトリ ロールを作成できます。 「カスタムリポジトリロールについて」を参照してください。

Organization に対するアクセス許可

カスタム Organization ロールにアクセス許可を含めると、そのロールを持つすべてのユーザーは、そのアクセス許可に対応する設定に、Web ブラウザーと API の両方からアクセスできるようになります。 ブラウザー上の Organization 設定画面では、ユーザーにはアクセスできる設定ページのみが表示されます。

Organization のアクセス許可によって、リポジトリに対する読み取り、書き込み、または管理者アクセス権が付与されることはありません。 一部のアクセス許可によっては、以下の表に示すように、リポジトリのメタデータの可視性が暗黙的に付与される場合があります。

リポジトリ アクセス権のための基本ロール

基本リポジトリ ロールによって、カスタム ロールに含まれるアクセス許可の初期セットが決まります。 リポジトリ アクセス権は Organization の現在および今後のすべてのリポジトリに付与されます。

基本リポジトリ ロールは次のとおりです。

• 読み取り: Organization のすべてのリポジトリに対する読み取りアクセス権を付与します。
• 書き込み: Organization のすべてのリポジトリに対する書き込みアクセス権を付与します。
• トリアージ: Organization のすべてのリポジトリに対するトリアージ アクセス権を付与します。
• メンテナンス: Organization のすべてのリポジトリに対するメンテナンス アクセス権を付与します。
• 管理: Organization のすべてのリポジトリに対する管理アクセス権を付与します。

リポジトリ アクセス権のための追加のアクセス許可

基本リポジトリ ロールを選択した後、カスタム Organization ロール用に追加のアクセス許可を選択できます。

追加のアクセス許可は、基本リポジトリ ロールにまだ含まれていないもののみ選択できます。 たとえば、基本ロールでリポジトリに対する書き込みアクセス権が付与されている場合は、"プル要求を終了する" アクセス許可は基本ロールに既に含まれています。

ディスカッション

• ディスカッション カテゴリを作成する
• ディスカッション カテゴリを編集する
• ディスカッション カテゴリを削除する
• ディスカッションの回答をマークまたはマーク解除する
• ディスカッション コメントを非表示または非表示解除する
• issue をディスカッションに変換する

詳しくは、「GitHub Discussions ドキュメント」をご覧ください。

イシューとプル要求

• ユーザーの割り当てまたは削除
• ラベルの追加または削除

問題

• issue をクローズする
• クローズされた issue を再オープンする
• issue を削除する
• issue を複製としてマークする

マージ キュー

• ソロ マージを要求する
• キューの先頭に移動する

詳しくは、「マージキューの管理」をご覧ください。

Pull request（プルリクエスト）

• pull request をクローズする
• クローズされた pull request を再オープンする
• pull request レビューを要求する

リポジトリ

• マイルストーンを設定する
• wiki 設定を管理する
• プロジェクト設定を管理する
• pull request のマージ設定を管理する
• GitHub Pages 設定を管理する (「GitHub Pages サイトの発行ソースの構成」を参照してください)
• webhookの管理
• デプロイキーの管理
• リポジトリ メタデータの編集
• 相互作用の制限を設定する
• ソーシャル プレビューを設定する
• 保護されたブランチへコミットをプッシュする
  • 基本ロールは write である必要があります
  • ブランチ保護ルールは引き続き適用されます
• 保護されたタグを作成する
• 保護されたタグを削除する
• ブランチ保護をバイパスする
• リポジトリ ルールを編集する

セキュリティ

• code scanning アラートを確認する
• code scanning アラートを閉じる、またはもう一度開く
• code scanning のアラートを削除する
• Dependabot alertsを表示する
• Dependabot alertsを閉じる、またはもう一度開く
• secret scanning アラートを表示する
• secret scanning アラートを閉じる、もう一度開くまたは割り当てる

Actions

• GitHub Actions の全般設定を管理する
• ランナーを管理する
• シークレットを管理する
• 変数の管理
• 環境を管理する (環境シークレットと変数を含む)

様々なアクセスレベルの優先順位

役割とアクセス許可は付加的なものです。 チームのメンバーシップや organization の基本アクセス許可など、さまざまな方法を通じてさまざまなレベルのアクセスがユーザーに付与されている場合、そのユーザーにはすべてのアクセス許可の合計が付与されます。 たとえば、organization の所有者が organization のメンバーに継承役割の "Read" を使うカスタム役割を付与し、そして organization の所有者が organization の基本アクセス許可を "Write" にした場合、このカスタム役割を持つメンバーはカスタム役割に含まれている追加のアクセス許可とともに、書き込みアクセス権限を持つことになります。

ユーザーに競合するアクセス権が付与されている場合は、リポジトリのアクセス ページに警告が表示されます。 競合するアクセス権を持つユーザーの横に、[ Mixed roles] という警告が表示されます。 競合するアクセス権のソースを表示するには、警告アイコンをポイントするか、 [混合ロール] をクリックします。

競合するアクセスを解決するには、Organizationの基本アクセスあるいはTeamのアクセスを調整するか、カスタムロールを編集してください。 詳細については、次を参照してください。

• Organization の基本レベルの権限の設定
• Organization のリポジトリに対するチームのアクセスを管理する
• リポジトリ ロールの編集
• カスタム組織の役割の管理