Zugriff auf das Auditprotokoll
The audit log lists events triggered by activities that affect your organization within the last 90 days. Nur Organisationsinhaber können auf das Auditprotokoll einer Organisation zugreifen.
- In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations.
- Next to the organization, click Settings.
- Klicke auf der Seitenleiste „Settings“ (Einstellungen) auf Audit log (Auditprotokoll).
Auditprotokoll durchsuchen
Das Protokoll enthält die folgenden Informationen zu jeder Aktion:
- an welchem Repository eine Aktion durchgeführt wurde,
- der Benutzer, der die Aktion durchgeführt hat
- die Aktion, die durchgeführt wurde,
- in welchem Land die Aktion durchgeführt wurde,
- Datum und Uhrzeit der Aktion.
Beachte, dass Du nicht mit Text nach Einträgen suchen kannst. Du kannst jedoch Suchabfragen mit den verschiedensten Filtern erstellen. Viele Operatoren, die für die Abfrage des Log verwendet werden - wie z.B. -
, >
oder <
- haben das gleiche Format wie die Suche über GitHub Enterprise Server. Weitere Informationen findest Du unter „Suchen nach GitHub.“
Vorgangsbasierte Suche
Verwende den Qualifizierer operation
(Vorgang) um Aktionen für spezifische Typen von Vorgängen zu beschränken. Ein Beispiel:
operation:access
(Vorgangszugriffe) findet alle Ereignisse, bei denen auf eine Ressource zugegriffen wurde.operation:authentication
(Vorgangsauthentifizierung) findet alle Ereignisse, bei denen ein Authentifizierungsereignis durchgeführt wurde.operation:create
(Vorgangserstellung) findet alle Ereignisse, bei denen eine Ressource erstellt wurde.operation:modify
(Vorgangsveränderung) findet alle Ereignisse, bei denen eine vorhandene Ressource verändert wurde.operation:remove
(Vorgangsentfernung) findet alle Ereignisse, bei denen eine vorhandene Ressource entfernt wurde.operation:restore
(Vorgangswiederherstellung) findet alle Ereignisse, bei denen eine vorhandene Ressource wiederhergestellt wurde.operation:transfer
(Vorgangsübertragung) findet alle Ereignisse, bei denen eine vorhandene Ressource übertragen wurde.
Suche nach Repository
Verwende den Qualifizierer repo
(Repository) um Aktionen auf ein spezifisches Repository einzuschränken. Ein Beispiel:
repo:my-org/our-repo
findet alle Ereignisse, die im Repositoryour-repo
der Organisationmy-org
aufgetreten sind.repo:my-org/our-repo repo:my-org/another-repo
findet alle Ereignisse, die in den Repositorysour-repo
undanother-repo
der Organisationmy-org
aufgetreten sind.-repo:my-org/not-this-repo
schließt alle Ereignisse aus, die im Repositorynot-this-repo
der Organisationmy-org
aufgetreten sind.
Beachte, dass Du den Kontonamen im Qualifizierer repo
einfügen musst; nur nach repo:our-repo
zu suchen, wird nicht funktionieren.
Suche nach Benutzer
Der Qualifizierer actor
(Akteur) kann Ereignisse einschränken basierend darauf, wer die Aktion durchgeführt hat. Ein Beispiel:
actor:octocat
findet alle Ereignisse in Verbindung mit Aktionen, die vonoctocat
ausgeführt wurden.actor:octocat actor:hubot
findet alle Ereignisse in Verbindung mit Aktionen, die vonoctocat
oderhubot
ausgeführt wurden.-actor:hubot
schließt alle Ereignisse in Verbindung mit Aktionen aus, die vonhubot
ausgeführt wurden.
Beachten Sie, dass Sie nur den in GitHub Enterprise Server verwendeten Benutzernamen, nicht den wirklichen Namen eines Benutzers, verwenden können.
Suche nach der Art der durchgeführten Aktion
Zur Suche nach bestimmten Ereignissen verwende in Deiner Abfrage den Qualifizierer action
. Die im Auditprotokoll aufgezeichneten Aktionen unterteilen sich in die folgenden Kategorien:
Kategoriename | Beschreibung |
---|---|
discussion_post (Diskussionsbeitrag) | Umfasst alle Aktivitäten in Verbindung mit Diskussionen auf einer Teamseite. |
discussion_post_reply (Antwort auf Diskussionsbeitrag) | Umfasst alle Aktivitäten in Verbindung mit Antworten auf Diskussionen auf einer Teamseite. |
Hook | Umfasst alle Aktivitäten in Verbindung mit Webhooks. |
integration_installation_request (Antrag zur Installation einer Integration) | Umfasst alle Aktivitäten in Verbindung mit Anfragen von Organisationsmitgliedern an Organisationsinhaber zur Genehmigung von Integrationen zur Verwendung innerhalb der Organisation. |
Issue | Contains activities related to deleting an issue. |
org | Contains activities related to organization membership. |
organization_label | Contains all activities related to default labels for repositories in your organization. |
oauth_application | Contains all activities related to OAuth Apps. |
profile_picture | Umfasst alle Aktivitäten in Verbindung mit dem Profilbild Deiner Organisation. |
project (Projekt) | Umfasst alle Aktivitäten in Verbindung mit Projektboards. |
protected_branch | Umfasst alle Aktivitäten in Verbindung mit geschützten Branches. |
repo | Contains activities related to the repositories owned by your organization. |
repository_dependency_graph | Contains repository-level activities related to enabling or disabling the dependency graph for a |
| repository. For more information, see "About the dependency graph."
| repository_vulnerability_alert
| Contains all activities related to Dependabot alerts for vulnerable dependencies.
| Team
| Umfasst alle Aktivitäten in Verbindung mit Teams in Ihrer Organisation. |
| team_discussions
| Umfasst Aktivitäten in Verbindung mit der Verwaltung der Teamdiskussionen für eine Organisation. |
Mit den folgenden Suchbegriffen kannst Du nach bestimmten Aktionsgruppen suchen. Ein Beispiel:
action:team
findet alle Ereignisse innerhalb der Kategorie „Team“.-action:hook
schließt alle Ereignisse aus der Kategorie „Webhook “ aus.
Each category has a set of associated actions that you can filter on. Ein Beispiel:
action:team.create
findet alle Ereignisse in Verbindung mit der Erstellung eines Teams.-action:hook.events_changed
schließt alle Ereignisse in Verbindung mit geänderten Webhook-Ereignissen aus.
Suche nach dem Zeitpunkt der Aktion
Use the created
qualifier to filter events in the audit log based on when they occurred. Die Datumsformatierung muss dem ISO8601-Standard entsprechen, der YYYY-MM-DD
(Jahr-Monat-Tag) ist. Du kannst nach dem Datum auch optionale Zeitinformationen THH:MM:SS+00:00
hinzufügen, um nach der Stunde, Minute und Sekunde zu suchen. Das ist T
, gefolgt von HH:MM:SS
(Stunden:Minuten:Sekunden) und einem UTC-Offset (+00:00
).
When you search for a date, you can use greater than, less than, and range qualifiers to further filter results. For more information, see "Understanding the search syntax."
Ein Beispiel:
created:2014-07-08
findet alle Ereignisse vom 8. Juli 2014.created:>=2014-07-08
findet alle Ereignisse vom und nach dem 8. Juli 2014.created:<=2014-07-08
findet alle Ereignisse vom und vor dem 8. Juli 2014.created:2014-07-01..2014-07-31
findet alle Ereignisse im Juli 2014.
Das Auditprotokoll enthält Daten der letzten 90 Tage. Mit dem Kennzeichner created
können Sie jedoch auch nach früheren Ereignissen suchen.
Suche nach Standort
Using the qualifier country
, you can filter events in the audit log based on the originating country. Hierzu verwenden Sie den zweistelligen Kurzcode oder den vollständigen Namen des Landes. Ländernamen mit Leerzeichen müssen in Anführungszeichen eingeschlossen sein. Ein Beispiel:
country:de
findet alle Ereignisse, die in Deutschland aufgetreten sind.country:Mexico
findet alle Ereignisse, die in Mexiko aufgetreten sind.country:"United States"
findet alle Ereignisse, die in den USA aufgetreten sind.
Using the audit log API
You can interact with the audit log using the GraphQL API.
Note: The audit log GraphQL API is available for organizations using GitHub Enterprise.
To ensure a secure IP and maintain compliance for your organization, you can use the audit log GraphQL API to keep copies of your audit log data and monitor:
- Zugriff auf Deine Organisation oder Deine Repository-Einstellungen
- Changes in permissions
- Added or removed users in an organization, repository, or team
- Users being promoted to admin
- Changes to permissions of a GitHub App
Die GraphQL-Antwort kann Daten für bis zu 90 bis 120 Tage beinhalten.
Sie können beispielsweise eine GraphQL-Anforderung erstellen, die alle Ihrer Organisation neu hinzugefügten Organisationsmitglieder zurückgibt. For more information, see the "GraphQL API Audit Log."
Audit log actions
An overview of some of the most common actions that are recorded as events in the audit log.
discussion_post
category actions
Aktion | Beschreibung |
---|---|
aktualisieren | Wird ausgelöst, wenn ein Beitrag zu einer Teamdiskussion bearbeitet wird. |
destroy | Wird ausgelöst, wenn ein Beitrag zu einer Teamdiskussion gelöscht wird. |
discussion_post_reply
category actions
Aktion | Beschreibung |
---|---|
aktualisieren | Wird ausgelöst, wenn eine Antwort auf einen Beitrag zu einer Teamdiskussion bearbeitet wird. |
destroy | Wird ausgelöst, wenn eine Antwort auf einen Beitrag zu einer Teamdiskussion gelöscht wird. |
enterprise
category actions
Aktion | Beschreibung |
---|---|
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. Weitere Informationen findest Du unter "selbst-gehostete Runner hinzufügen." |
runner_group_created | Triggered when a self-hosted runner group is created. For more information, see "About self-hosted runner groups. |
runner_group_removed | Triggered when a self-hosted runner group is removed. For more information, see "Removing a self-hosted runner group." |
runner_group_renamed | Triggered when the self-hosted runner group is renamed. |
runner_group_visiblity_updated | Triggered when the visibility settings of the self-hosted runner group are changed. |
runner_group_runner_removed | Triggered when the REST API is used to remove a self-hosted runner from a group. |
runner_group_runners_added | Triggered when a self-hosted runner is added to a group. For more information, see "Moving a self-hosted runner to a group." |
runner_group_runners_updated | Triggered when a runner group's list of members is updated. For more information, see "Set self-hosted runners in a group for an organization." |
self_hosted_runner_updated | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "About self-hosted runners." |
hook
category actions
Aktion | Beschreibung |
---|---|
create | Wird ausgelöst, wenn einem Repository Ihrer Organisation ein neuer Hook hinzugefügt wird. |
config_changed | Wird ausgelöst, wenn die Konfiguration eines vorhandenen Hooks geändert wird. |
destroy | Wird ausgelöst, wenn ein vorhandener Hook aus einem Repository entfernt wird. |
events_changed | Wird ausgelöst, wenn sich die Ereignisse eines Hooks ändern. |
integration_installation_request
category actions
Aktion | Beschreibung |
---|---|
create | Wird ausgelöst, wenn ein Mitglied der Organisation bei einem Organisationsinhaber die Installation einer Integration zur Verwendung innerhalb der Organisation anfordert. |
close (schließen) | Wird ausgelöst, wenn eine Anforderung zur Installation einer Integration zur Verwendung innerhalb der Organisation von einem Organisationsinhaber genehmigt oder abgelehnt wird oder wenn die Anforderung von dem Organisationsmitglied, das die Anfrage gestellt hat, abgebrochen wird. |
issue
category actions
Aktion | Beschreibung |
---|---|
destroy | Wird ausgelöst, wenn ein Organisationsinhaber oder eine Person mit Administratorberechtigungen für ein Repository ein Issue aus einem Repository der Organisation löscht. |
org
category actions
Aktion | Beschreibung |
---|---|
create_actions_secret | Triggered when a GitHub Actions secret is created for an organization. For more information, see "Creating encrypted secrets for an organization." |
disable_member_team_creation_permission | Wird ausgelöst, wenn ein Organisationsinhaber die Möglichkeit der Teamerstellung auf Inhaber beschränkt. Weitere Informationen findest Du unter „Berechtigungen für die Teamerstellung in Deiner Organisation festlegen.“ |
disable_two_factor_requirement | Triggered when an owner disables a two-factor authentication requirement for all members and outside collaborators in an organization. |
enable_member_team_creation_permission | Wird ausgelöst, wenn ein Organisationsinhaber Mitgliedern die Erstellung von Teams erlaubt. Weitere Informationen findest Du unter „Berechtigungen für die Teamerstellung in Deiner Organisation festlegen.“ |
enable_two_factor_requirement | Triggered when an owner requires two-factor authentication for all members and outside collaborators in an organization. |
invite_member | Triggered when a new user was invited to join your organization. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. For more information, see "Adding a self-hosted runner to an organization." |
remove_actions_secret | Triggered when a GitHub Actions secret is removed. |
remove_member | Triggered when an owner removes a member from an organization or when two-factor authentication is required in an organization and an organization member doesn't use 2FA or disables 2FA. Wird auch ausgelöst, wenn ein Organisationsmitglied sich selbst aus einer Organisation entfernt. |
remove_outside_collaborator | Triggered when an owner removes an outside collaborator from an organization or when two-factor authentication is required in an organization and an outside collaborator does not use 2FA or disables 2FA. |
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. For more information, see "Removing a runner from an organization." |
runner_group_created | Triggered when a self-hosted runner group is created. For more information, see "Creating a self-hosted runner group for an organization." |
runner_group_removed | Triggered when a self-hosted runner group is removed. For more information, see "Removing a self-hosted runner group." |
runner_group_updated | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "Changing the access policy of a self-hosted runner group." |
runner_group_runners_added | Triggered when a self-hosted runner is added to a group. For more information, see Moving a self-hosted runner to a group. |
runner_group_runner_removed | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "Remove a self-hosted runner from a group for an organization." |
runner_group_runners_updated | Triggered when a runner group's list of members is updated. For more information, see "Set self-hosted runners in a group for an organization." |
update_actions_secret | Triggered when a GitHub Actions secret is updated. |
update_default_repository_permission | Wird ausgelöst, wenn ein Inhaber die Standard-Berechtigungsebene für Repositorys für die Organisationsmitglieder ändert. |
update_member | Wird ausgelöst, wenn ein Inhaber die Rolle einer Person von Inhaber in Mitglied oder von Mitglied in Inhaber ändert. |
update_member_repository_creation_permission | Triggered when an owner changes the create repository permission for organization members. |
organization_label
category actions
Aktion | Beschreibung |
---|---|
create | Wird ausgelöst, wenn eine Standardkennzeichnung erstellt wird. |
aktualisieren | Wird ausgelöst, wenn eine Standardkennzeichnung bearbeitet wird. |
destroy | Wird ausgelöst, wenn eine Standardkennzeichnung gelöscht wird. |
oauth_application
category actions
Aktion | Beschreibung |
---|---|
create | Wird ausgelöst, wenn eine neue OAuth App erstellt wird. |
destroy | Wird ausgelöst, wenn eine vorhandene OAuth App gelöscht wird. |
reset_secret | Wird ausgelöst, wenn das Client-Geheimnis einer OAuth App zurückgesetzt wird. |
revoke_tokens | Wird ausgelöst, wenn die Benutzertoken einer OAuth App zurückgezogen werden. |
übertragen | Wird ausgelöst, wenn eine vorhandene OAuth App auf eine neue Organisation übertragen wird. |
profile_picture
category actions
Aktion | Beschreibung |
---|---|
aktualisieren | Wird ausgelöst, wenn Sie das Profilbild Ihrer Organisation festlegen oder ändern. |
project
category actions
Aktion | Beschreibung |
---|---|
create | Wird bei der Erstellung eines Projektboards ausgelöst. |
link | Wird ausgelöst, wenn ein Repository mit einem Projektboard verknüpft wird. |
rename | Wird ausgelöst, wenn ein Projektboard umbenannt wird. |
aktualisieren | Wird ausgelöst, wenn ein Projektboard geändert wird. |
delete | Wird ausgelöst, wenn ein Projektboard gelöscht wird. |
unlink | Wird ausgelöst, wenn die Verknüpfung eines Repositorys mit einem Projektboard aufgehoben wird. |
update_org_permission | Wird ausgelöst, wenn die Berechtigungen auf Basisebene für alle Organisationsmitglieder geändert oder entfernt werden. |
update_team_permission | Wird ausgelöst, wenn sich die Berechtigungsebene eines Teams für ein Projektboard ändert oder wenn ein Team in einem Projektboard hinzugefügt oder entfernt wird. |
update_user_permission | Wird ausgelöst, wenn ein Organisationsmitglied oder ein externer Mitarbeiter in einem Projektboard hinzugefügt oder entfernt wird oder wenn sich dessen Berechtigungsebene ändert. |
protected_branch
category actions
Aktion | Beschreibung |
---|---|
create | Wird ausgelöst, wenn für einen Branch der Branch-Schutz aktiviert wird. |
destroy | Wird ausgelöst, wenn für einen Branch der Branch-Schutz deaktiviert wird. |
update_admin_enforced | Wird ausgelöst, wenn der Branch-Schutz für Repository-Administratoren erzwungen wird. |
update_require_code_owner_review | Wird ausgelöst, wenn die Erzwingung erforderlicher Reviews durch einen Codeinhaber für einen Branch akualisiert wird. |
dismiss_stale_reviews | Wird ausgelöst, wenn die Erzwingung des Verwerfens veralteter Pull Requests für einen Branch akualisiert wird. |
update_signature_requirement_enforcement_level | Wird ausgelöst, wenn die Erzwingung der obligatorischen Commit-Signatur für einen Branch akualisiert wird. |
update_pull_request_reviews_enforcement_level | Wird ausgelöst, wenn die Erzwingung erforderlicher Pull-Request-Reviews für einen Branch akualisiert wird. |
update_required_status_checks_enforcement_level | Wird ausgelöst, wenn die Erzwingung erforderlicher Statuschecks für einen Branch akualisiert wird. |
update_strict_required_status_checks_policy | Triggered when the requirement for a branch to be up to date before merging is changed. |
rejected_ref_update | Wird ausgelöst, wenn eine Branch-Aktualisierung abgelehnt wird. |
policy_override | Triggered when a branch protection requirement is overridden by a repository administrator. |
update_allow_force_pushes_enforcement_level | Wird ausgelöst, wenn erzwungene Pushes für einen geschützten Branch aktiviert oder deaktiviert werden. |
update_allow_deletions_enforcement_level | Wird ausgelöst, wenn die Branch-Löschung für einen geschützten Branch aktiviert oder deaktiviert wird. |
update_linear_history_requirement_enforcement_level | Wird ausgelöst, wenn der erforderliche lineare Commit-Verlauf für einen geschützten Branch aktiviert oder deaktiviert wird. |
repo
category actions
Aktion | Beschreibung |
---|---|
access | Triggered when a user changes the visibility of a repository in the organization. |
actions_enabled | Triggered when GitHub Actions is enabled for a repository. Can be viewed using the UI. This event is not included when you access the audit log using the REST API. For more information, see "Using the REST API." |
add_member | Wird ausgelöst, wenn ein Benutzer eine Einladung für den Zugriff auf ein Repository als Mitarbeiter akzeptiert. |
add_topic | Triggered when a repository admin adds a topic to a repository. |
archived | Wird ausgelöst, wenn ein Repository-Administrator ein Repository archiviert. |
config.disable_anonymous_git_access | Wird ausgelöst, wenn für ein öffentliches Repository der anonyme Git-Lesezugriff deaktiviert wird. |
config.enable_anonymous_git_access | Wird ausgelöst, wenn für ein öffentliches Repository der anonyme Git-Lesezugriff aktiviert wird. |
config.lock_anonymous_git_access | Wird ausgelöst, wenn für ein Repository die Einstellung für den anonymen Git-Lesezugriff gesperrt wird. |
config.unlock_anonymous_git_access | Wird ausgelöst, wenn für ein Repository die Einstellungssperre für den anonymen Git-Lesezugriff aufgehoben wird. |
create | Triggered when a new repository is created. |
create_actions_secret | Triggered when a GitHub Actions secret is created for a repository. For more information, see "Creating encrypted secrets for a repository." |
destroy | Wird ausgelöst, wenn ein Repository gelöscht wird. |
aktivieren | Triggered when a repository is reenabled. |
remove_actions_secret | Triggered when a GitHub Actions secret is removed. |
remove_member | Triggered when a user is removed from a repository as a collaborator. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. For more information, see "Adding a self-hosted runner to a repository." |
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. For more information, see "Removing a runner from a repository." |
remove_topic | Wird ausgelöst, wenn ein Repository-Administrator ein Thema aus einem Repository entfernt. |
rename | Triggered when a repository is renamed. |
self_hosted_runner_updated | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "About self-hosted runners." |
übertragen | Wird ausgelöst, wenn ein Repository übertragen wird. |
transfer_start | Wird ausgelöst, wenn die Übertragung eines Repositorys initiiert wurde. |
unarchived | Triggered when a repository admin unarchives a repository. |
update_actions_secret | Triggered when a GitHub Actions secret is updated. |
repository_dependency_graph
category actions
Aktion | Beschreibung |
---|---|
deaktivieren | Triggered when a repository owner or person with admin access to the repository disables the dependency graph for a repository. For more information, see "About the dependency graph." |
aktivieren | Triggered when a repository owner or person with admin access to the repository enables the dependency graph for a repository. |
repository_vulnerability_alert
category actions
Aktion | Beschreibung |
---|---|
create | Triggered when GitHub Enterprise Server creates a Dependabot alert for a repository that uses a vulnerable dependency. For more information, see "About alerts for vulnerable dependencies." |
verwerfen | Triggered when an organization owner or person with admin access to the repository dismisses a Dependabot alert about a vulnerable dependency. |
beheben | Triggered when someone with write access to a repository pushes changes to update and resolve a vulnerability in a project dependency. |
team
category actions
Aktion | Beschreibung |
---|---|
add_member | Wird ausgelöst, wenn ein Mitglied einer Organisation einem Team hinzugefügt wird. |
add_repository | Wird ausgelöst, wenn ein Team die Kontrolle über ein Repository erhält. |
change_parent_team | Wird ausgelöst, wenn ein untergeordnetes Team erstellt wird oder das übergeordnete Team eines untergeordneten Teams geändert wird. |
change_privacy | Wird ausgelöst, wenn die Datenschutzstufe eines Teams geändert wird. |
create | Triggered when a new team is created. |
team_discussions
category actions
Aktion | Beschreibung |
---|---|
deaktivieren | Wird ausgelöst, wenn ein Organisationsinhaber für eine Organisation Teamdiskussionen deaktiviert. Weitere Informationen findest Du unter „Teamdiskussionen innerhalb Deiner Organisation deaktivieren.“ |
aktivieren | Wird ausgelöst, wenn ein Organisationsinhaber für eine Organisation Teamdiskussionen aktiviert. |
workflows
category actions
Aktion | Beschreibung |
---|