Skip to main content

Informationen zu benutzerdefinierten Repositoryrollen

Du kannst den Zugriff auf die Repositorys deiner Organisation mit benutzerdefinierten Repositoryrollen genauer steuern.

Informationen zu benutzerdefinierten Repositoryrollen

Zum Ausführen von Aktionen für GitHub Enterprise Server, z. B. zum Erstellen eines Pull Requests in einem Repository oder zum Ändern der Abrechnungseinstellungen einer Organisation, muss eine Person über ausreichenden Zugriff auf das relevante Konto oder die entsprechende Ressource verfügen. Dieser Zugriff wird mit Berechtigungen gesteuert. Eine Berechtigung ist die Möglichkeit, eine bestimmte Aktion auszuführen. Die Möglichkeit, ein Issue zu löschen, ist beispielsweise eine Berechtigung. Eine Rolle ist eine Reihe von Berechtigungen, die du Personen oder Teams zuweisen kannst.

Innerhalb einer Organisation kannst du Rollen auf Organisations-, Team- und Repositoryebene zuweisen. Weitere Informationen zu den verschiedenen Rollenebenen findest du unter Rollen in einer Organisation.

Du kannst die Berechtigungen, die du auf Repositoryebene gewährst, präziser steuern, indem du bis zu fünf benutzerdefinierte Repositoryrollen erstellst. Eine benutzerdefinierte Repositoryrolle ist eine konfigurierbare Reihe von Berechtigungen mit einem benutzerdefinierten Namen, den du selbst auswählst. Weitere Informationen findest du unter Verwalten benutzerdefinierter Repositoryrollen für eine Organisation.

Nachdem du eine benutzerdefinierte Rolle erstellt hast, können Benutzer*innen mit Administratorzugriff auf ein Repository die Rolle einer Person oder einem Team zuweisen. Weitere Informationen finden Sie unter Den Zugriff einer Person auf ein Repository einer Organisation verwalten und unter Den Teamzugriff auf ein Repository einer Organisation verwalten.

Du kannst auch die REST-API verwenden, um benutzerdefinierte Repositoryrollen zu erstellen und zu verwalten. Weitere Informationen finden Sie unter „REST-API-Endpunkte für benutzerdefinierte Repositoryrollen“.

Informationen zur geerbten Rolle

Wenn du eine benutzerdefinierte Repositoryrolle erstellst, beginnst du mit einer geerbten Rolle aus einer Reihe vordefinierter Optionen. Die geerbte Rolle bestimmt die anfänglichen Berechtigungen für die benutzerdefinierte Rolle. Anschließend kannst du die Rolle weiter anpassen, indem du zusätzliche Berechtigungen für sie auswählst. Eine vollständige Liste der verfügbaren Berechtigungen findest du unter Zusätzliche Berechtigungen für benutzerdefinierte Rollen.

Deine Optionen für die geerbte Rolle werden für verschiedene Arten von Mitwirkenden in deinem Repository standardisiert.

Geerbte RolleVorgesehener Zweck
LesenPersonen, die nicht zum Code beitragen und sich das Projekt nur ansehen oder darüber sprechen möchten
EingrenzungMitwirkende, die ohne Schreibzugriff proaktiv Issues und Pull Requests verwalten müssen
SchreibenOrganisationsmitglieder und Projektmitarbeiter*innen, die aktiv an dein Projekt pushen
VerwaltenProjektmanager*innen, die das Repository ohne Zugriff auf vertrauliche oder destruktive Aktionen verwalten müssen

Beispiele für benutzerdefinierte Rollen

Hier findest du einige Beispiele für benutzerdefinierte Repositoryrollen, die du konfigurieren kannst.

Benutzerdefinierte RepositoryrolleZusammenfassungGeerbte RolleZusätzliche Berechtigungen
Security EngineerKann am Code mitwirken und die Sicherheitspipeline verwaltenVerwaltenLöschen von Ergebnissen des Codescans
ContractorKann Webhooks-Integrationen entwickelnSchreibenVerwalten von Webhooks
Community-ManagerKann alle Communityinteraktionen durchführen, ohne Code beitragen zu könnenLesen- Markieren eines Issue als Duplikat
- Verwalten von GitHub-Seiteneinstellungen
- Verwalten von Wiki-Einstellungen
- Festlegen der Vorschau für soziale Netzwerke
- Bearbeiten von Repositorymetadaten
- Triagediskussionen

Zusätzliche Berechtigungen für benutzerdefinierte Rollen

Nachdem du eine geerbte Rolle ausgewählt hast, kannst du zusätzliche Berechtigungen für deine benutzerdefinierte Rolle auswählen.

Du kannst nur zusätzliche Berechtigungen auswählen, die noch nicht in der geerbten Rolle enthalten sind. Wenn die geerbte Rolle beispielsweise Schreibzugriff auf ein Repository bietet, ist die Berechtigung „Pull Request schließen“ bereits in der geerbten Rolle enthalten.

Discussions

  • Create a discussion category
  • Edit a discussion category
  • Delete a discussion category
  • Mark or unmark discussion answers
  • Hide or unhide discussion comments
  • Convert issues to discussions

For more information, see "Dokumentation zu GitHub Discussions."

Issue and Pull Requests

  • Assign or remove a user
  • Add or remove a label

Issue

  • Close an issue
  • Reopen a closed issue
  • Delete an issue
  • Mark an issue as a duplicate

Pull Request

  • Close a pull request
  • Reopen a closed pull request
  • Request a pull request review

Repository

  • Set milestones
  • Manage wiki settings
  • Manage project settings
  • Manage pull request merging settings
  • Manage GitHub Pages settings (see "Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren")
  • Manage webhooks
  • Manage deploy keys
  • Edit repository metadata
  • Set the social preview
  • Push commits to protected branches
    • Base role must be write
    • Branch protection rules will still apply
  • Create protected tags
  • Delete protected tags
  • Bypass branch protections
  • Edit repository rules

Security

  • View code scanning results
  • Dismiss or reopen code scanning results
  • Delete code scanning results
  • View Dependabot alerts
  • Dismiss or reopen Dependabot alerts
  • View secret scanning results
  • Dismiss or reopen secret scanning results

Rangfolge für unterschiedliche Zugriffsstufen

Rollen und Berechtigungen sind additiv. Wenn eine Person auf verschiedenen Wegen unterschiedliche Zugriffsstufen erhält, z. B. die Teammitgliedschaft und die Basisberechtigungen für eine Organisation, verfügt der Benutzer über alle Zugriffserteilungen. Wenn eine Organisationsbesitzerin Organisationsmitgliedern beispielsweise eine benutzerdefinierte Rolle zuteilt, die die geerbte Rolle „Lesezugriff“ verwendet, und dann eine Organisationsbesitzerin die Basisberechtigung der Organisation auf „Schreibzugriff“ festlegt, verfügen Mitglieder mit dieser benutzerdefinierten Rolle über Schreibzugriff sowie über alle zusätzlichen Berechtigungen, die in der benutzerdefinierten Rolle enthalten sind.

Wenn einer Person widersprüchliche Zugriffsrechte erteilt wurden, wird auf der Seite für den Repositoryzugriff eine Warnung angezeigt. Die Warnung wird mit dem Hinweis „ Gemischte Rollen“ neben der Person mit dem widersprüchlichen Zugriff angezeigt. Um die Ursache des Zugriffskonflikts anzuzeigen, bewege den Mauszeiger auf das Warnsymbol, oder klicke auf Gemischte Rollen.

Um Probleme durch miteinander im Widerspruch stehende Zugriffsberechtigungen zu lösen, kannst du die Basisberechtigungen deiner Organisation oder den Zugriff des Teams anpassen oder die benutzerdefinierte Rolle bearbeiten. Weitere Informationen finden Sie unter: