19 KiB
title, intro, redirect_from, versions
| title | intro | redirect_from | versions | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Reviewing your security log | You can review the security log for your user account to better understand actions you've performed and actions others have performed that involve you. |
|
|
Accessing your security log
The security log lists all actions performed within the last 90 days{% if currentVersion ver_lt "enterprise-server@2.20" %}, up to 50{% endif %}.
{% data reusables.user_settings.access_settings %}
{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
2. In the user settings sidebar, click Security log.
{% else %}
{% data reusables.user_settings.security %}
3. Under "Security history," your log is displayed.
4. Click on an entry to see more information about the event.
{% endif %}
{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %}
Searching your security log
{% data reusables.audit_log.audit-log-search %}
Search based on the action performed
{% else %}
Understanding events in your security log
Actions listed in your security log are grouped within the following categories: {% endif %}
| Category Name | Description
|------------------|-------------------{% if currentVersion == "free-pro-team@latest" %}
| account_recovery_token | Contains all activities related to adding a recovery token.
| billing | Contains all activities related to your billing information.
| marketplace_agreement_signature | Contains all activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement.
| marketplace_listing | Contains all activities related to listing apps in {% data variables.product.prodname_marketplace %}.{% endif %}
| oauth_access | Contains all activities related to {% data variables.product.prodname_oauth_app %}s you've connected with.{% if currentVersion == "free-pro-team@latest" %}
| payment_method | Contains all activities related to paying for your {% data variables.product.prodname_dotcom %} subscription.{% endif %}
| profile_picture | Contains all activities related to your profile picture.
| project | Contains all activities related to project boards.
| public_key | Contains all activities related to your public SSH keys.
| repo | Contains all activities related to the repositories you own.{% if currentVersion == "free-pro-team@latest" %}
| sponsors | Contains all events related to {% data variables.product.prodname_sponsors %} and sponsor buttons (see "About {% data variables.product.prodname_sponsors %}" and "Displaying a sponsor button in your repository"){% endif %}{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %}
| team | Contains all activities related to teams you are a part of.{% endif %}{% if currentVersion != "github-ae@latest" %}
| two_factor_authentication | Contains all activities related to two-factor authentication.{% endif %}
| user | Contains all activities related to your account.
A description of the events within these categories is listed below.
{% if currentVersion == "free-pro-team@latest" %}
The account_recovery_token category
| Action | Description |
|---|---|
| confirm | Triggered when you successfully store a new token with a recovery provider. |
| recover | Triggered when you successfully redeem an account recovery token. |
| recover_error | Triggered when a token is used but {% data variables.product.prodname_dotcom %} is not able to validate it. |
The billing category
| Action | Description |
|---|---|
| change_billing_type | Triggered when you change how you pay for {% data variables.product.prodname_dotcom %}. |
| change_email | Triggered when you change your email address. |
The marketplace_agreement_signature category
| Action | Description |
|---|---|
| create | Triggered when you sign the {% data variables.product.prodname_marketplace %} Developer Agreement. |
The marketplace_listing category
| Action | Description |
|---|---|
| approve | Triggered when your listing is approved for inclusion in {% data variables.product.prodname_marketplace %}. |
| create | Triggered when you create a listing for your app in {% data variables.product.prodname_marketplace %}. |
| delist | Triggered when your listing is removed from {% data variables.product.prodname_marketplace %}. |
| redraft | Triggered when your listing is sent back to draft state. |
| reject | Triggered when your listing is not accepted for inclusion in {% data variables.product.prodname_marketplace %}. |
{% endif %}
The oauth_access category
| Action | Description |
|---|---|
| create | Triggered when you grant access to an {% data variables.product.prodname_oauth_app %}. |
| destroy | Triggered when you revoke an {% data variables.product.prodname_oauth_app %}'s access to your account. |
{% if currentVersion == "free-pro-team@latest" %}
The payment_method category
| Action | Description |
|---|---|
| clear | Triggered when a payment method on file is removed. |
| create | Triggered when a new payment method is added, such as a new credit card or PayPal account. |
| update | Triggered when an existing payment method is updated. |
{% endif %}
The profile_picture category
| Action | Description |
|---|---|
| update | Triggered when you set or update your profile picture. |
The project category
| Action | Description |
|---|---|
create |
Triggered when a project board is created. |
rename |
Triggered when a project board is renamed. |
update |
Triggered when a project board is updated. |
delete |
Triggered when a project board is deleted. |
link |
Triggered when a repository is linked to a project board. |
unlink |
Triggered when a repository is unlinked from a project board. |
project.access |
Triggered when a project board's visibility is changed. |
update_user_permission |
Triggered when an outside collaborator is added to or removed from a project board or has their permission level changed. |
The public_key category
| Action | Description |
|---|---|
| create | Triggered when you add a new public SSH key to your {% data variables.product.product_name %} account. |
| delete | Triggered when you remove a public SSH key to your {% data variables.product.product_name %} account. |
The repo category
| Action | Description |
|---|---|
| access | Triggered when you a repository you own is switched from "private" to "public" (or vice versa). |
| add_member | Triggered when a {% data variables.product.product_name %} user is {% if currentVersion == "free-pro-team@latest" %}invited to have collaboration access{% else %}given collaboration access{% endif %} to a repository. |
| add_topic | Triggered when a repository owner adds a topic to a repository. |
| archived | Triggered when a repository owner archives a repository.{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} |
| config.disable_anonymous_git_access | Triggered when [anonymous Git read access is disabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. |
| config.enable_anonymous_git_access | Triggered when [anonymous Git read access is enabled](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository) in a public repository. |
| config.lock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is locked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access). |
| config.unlock_anonymous_git_access | Triggered when a repository's [anonymous Git read access setting is unlocked](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access).{% endif %} |
| create | Triggered when a new repository is created. |
| destroy | Triggered when a repository is deleted.{% if currentVersion == "free-pro-team@latest" %} |
| disable | Triggered when a repository is disabled (e.g., for insufficient funds).{% endif %}{% if currentVersion == "free-pro-team@latest" %} |
| enable | Triggered when a repository is re-enabled.{% endif %} |
| remove_member | Triggered when a {% data variables.product.product_name %} user is removed from a repository as a collaborator. |
| remove_topic | Triggered when a repository owner removes a topic from a repository. |
| rename | Triggered when a repository is renamed. |
| transfer | Triggered when a repository is transferred. |
| transfer_start | Triggered when a repository transfer is about to occur. |
| unarchived | Triggered when a repository owner unarchives a repository. |
{% if currentVersion == "free-pro-team@latest" %}
The sponsors category
| Action | Description |
|---|---|
| repo_funding_link_button_toggle | Triggered when you enable or disable a sponsor button in your repository (see "Displaying a sponsor button in your repository") |
| repo_funding_links_file_action | Triggered when you change the FUNDING file in your repository (see "Displaying a sponsor button in your repository") |
| sponsor_sponsorship_cancel | Triggered when you cancel a sponsorship (see "Downgrading a sponsorship") |
| sponsor_sponsorship_create | Triggered when you sponsor a developer (see "Sponsoring an open source contributor") |
| sponsor_sponsorship_preference_change | Triggered when you change whether you receive email updates from a sponsored developer (see "Managing your sponsorship") |
| sponsor_sponsorship_tier_change | Triggered when you upgrade or downgrade your sponsorship (see "Upgrading a sponsorship" and "Downgrading a sponsorship") |
| sponsored_developer_approve | Triggered when your {% data variables.product.prodname_sponsors %} account is approved (see "Setting up {% data variables.product.prodname_sponsors %} for your user account") |
| sponsored_developer_create | Triggered when your {% data variables.product.prodname_sponsors %} account is created (see "Setting up {% data variables.product.prodname_sponsors %} for your user account") |
| sponsored_developer_profile_update | Triggered when you edit your sponsored developer profile (see "Editing your profile details for {% data variables.product.prodname_sponsors %}") |
| sponsored_developer_request_approval | Triggered when you submit your application for {% data variables.product.prodname_sponsors %} for approval (see "Setting up {% data variables.product.prodname_sponsors %} for your user account") |
| sponsored_developer_tier_description_update | Triggered when you change the description for a sponsorship tier (see "Changing your sponsorship tiers") |
| sponsored_developer_update_newsletter_send | Triggered when you send an email update to your sponsors (see "Contacting your sponsors") |
| waitlist_invite_sponsored_developer | Triggered when you are invited to join {% data variables.product.prodname_sponsors %} from the waitlist (see "Setting up {% data variables.product.prodname_sponsors %} for your user account") |
| waitlist_join | Triggered when you join the waitlist to become a sponsored developer (see "Setting up {% data variables.product.prodname_sponsors %} for your user account") |
| {% endif %} |
{% if currentVersion == "free-pro-team@latest" %}
The successor_invitation category
| Action | Description |
|---|---|
| accept | Triggered when you accept a succession invitation (see "Maintaining ownership continuity of your user account's repositories") |
| cancel | Triggered when you cancel a succession invitation (see "Maintaining ownership continuity of your user account's repositories") |
| create | Triggered when you create a succession invitation (see "Maintaining ownership continuity of your user account's repositories") |
| decline | Triggered when you decline a succession invitation (see "Maintaining ownership continuity of your user account's repositories") |
| revoke | Triggered when you revoke a succession invitation (see "Maintaining ownership continuity of your user account's repositories") |
| {% endif %} |
{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %}
The team category
| Action | Description |
|---|---|
| add_member | Triggered when a member of an organization you belong to adds you to a team. |
| add_repository | Triggered when a team you are a member of is given control of a repository. |
| create | Triggered when a new team in an organization you belong to is created. |
| destroy | Triggered when a team you are a member of is deleted from the organization. |
| remove_member | Triggered when a member of an organization is removed from a team you are a member of. |
| remove_repository | Triggered when a repository is no longer under a team's control. |
{% endif %}
{% if currentVersion != "github-ae@latest" %}
The two_factor_authentication category
| Action | Description |
|---|---|
| enabled | Triggered when two-factor authentication is enabled. |
| disabled | Triggered when two-factor authentication is disabled. |
| {% endif %} |
The user category
| Action | Description |
|---|---|
| add_email | Triggered when you {% if currentVersion != "github-ae@latest" %}add a new email address{% else %}add a new email address{% endif %}. |
| create | Triggered when you create a new user account. |
| remove_email | Triggered when you remove an email address. |
| rename | Triggered when you rename your account.{% if currentVersion != "github-ae@latest" %} |
| change_password | Triggered when you change your password. |
| forgot_password | Triggered when you ask for a password reset.{% endif %} |
| login | Triggered when you log in to {% data variables.product.product_location %}. |
| failed_login | Triggered when you failed to log in successfully.{% if currentVersion != "github-ae@latest" %} |
| two_factor_requested | Triggered when {% data variables.product.product_name %} asks you for your two-factor authentication code.{% endif %} |
| show_private_contributions_count | Triggered when you publicize private contributions on your profile. |
| hide_private_contributions_count | Triggered when you hide private contributions on your profile.{% if currentVersion == "free-pro-team@latest" %} |
| report_content | Triggered when you report an issue or pull request, or a comment on an issue, pull request, or commit.{% endif %} |
The user_status category
| Action | Description |
|---|---|
| update | Triggered when you set or change the status on your profile. For more information, see "Setting a status." |
| destroy | Triggered when you clear the status on your profile. |
{% if currentVersion == "free-pro-team@latest" %}
Exporting your security log
{% data reusables.audit_log.export-log %} {% data reusables.audit_log.exported-log-keys-and-values %}
{% endif %}