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“.
Benutzerdefinierte Repositoryrollen verwalten den Zugriff auf bestimmte Repositorys in Ihrer Organisation. Um den Zugriff auf die Verwaltungseinstellungen Ihrer Organisation zu steuern, können Sie benutzerdefinierte Organisationsrollen verwenden. Weitere Informationen finden Sie unter „Informationen zu benutzerdefinierten Organisationsrollen“.
Benutzerdefinierte Organisationsrollen unterscheiden sich von Repositoryrollen dahingehend, dass Berechtigungen für alle aktuellen und zukünftigen Repositorys in der Organisation gewährt werden. Benutzerdefinierte Repositoryrollen ermöglichen es Ihnen jedoch, Berechtigungen für bestimmte Repositorys innerhalb der Organisation zu erteilen.
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 Rolle | Vorgesehener Zweck |
|---|---|
| Lesen | Personen, die nicht zum Code beitragen und sich das Projekt nur ansehen oder darüber sprechen möchten |
| Eingrenzung | Mitwirkende, die ohne Schreibzugriff proaktiv Issues und Pull Requests verwalten müssen |
| Schreiben | Organisationsmitglieder und Projektmitarbeiter*innen, die aktiv an dein Projekt pushen |
| Verwalten | Projektmanager*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 Repositoryrolle | Zusammenfassung | Geerbte Rolle | Zusätzliche Berechtigungen |
|---|---|---|---|
| Security Engineer | Kann am Code mitwirken und die Sicherheitspipeline verwalten | Verwalten | Löschen von Ergebnissen des Codescans |
| Contractor | Kann Webhooks-Integrationen entwickeln | Schreiben | Verwalten von Webhooks |
| Community-Manager | Kann alle Communityinteraktionen durchführen, ohne Code beitragen zu können | Lesen | - 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
- Base role must be
- 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: