diff --git a/_data/toc.yaml b/_data/toc.yaml index dcba265e57..8bbf1ad71e 100644 --- a/_data/toc.yaml +++ b/_data/toc.yaml @@ -1262,26 +1262,8 @@ manuals: title: Quickstart - path: /docker-id/ title: Docker ID accounts - - sectiontitle: Security and authentication - section: - - path: /docker-hub/access-tokens/ - title: Manage access tokens - - sectiontitle: Two-factor authentication - section: - - path: /docker-hub/2fa/ - title: Enable two-factor authentication - - path: /docker-hub/2fa/disable-2fa/ - title: Disable two-factor authentication - - path: /docker-hub/2fa/recover-hub-account/ - title: Recover your Docker Hub account - - path: /docker-hub/2fa/new-recovery-code/ - title: Generate a new recovery code - - path: /docker-hub/orgs/ - title: Teams and organizations - path: /docker-hub/repos/ title: Repositories - - path: /docker-hub/vulnerability-scanning/ - title: Vulnerability scanning - path: /docker-hub/official_images/ title: Official images - sectiontitle: Automated builds @@ -1298,6 +1280,26 @@ manuals: title: Webhooks - path: /docker-hub/slack_integration/ title: Slack integration + - path: /docker-hub/orgs/ + title: Teams and organizations + - path: /docker-hub/vulnerability-scanning/ + title: Vulnerability scanning + - path: /docker-hub/audit-log/ + title: Audit log + - sectiontitle: Security and authentication + section: + - path: /docker-hub/access-tokens/ + title: Manage access tokens + - sectiontitle: Two-factor authentication + section: + - path: /docker-hub/2fa/ + title: Enable two-factor authentication + - path: /docker-hub/2fa/disable-2fa/ + title: Disable two-factor authentication + - path: /docker-hub/2fa/recover-hub-account/ + title: Recover your Docker Hub account + - path: /docker-hub/2fa/new-recovery-code/ + title: Generate a new recovery code - path: /docker-hub/download-rate-limit/ title: Download rate limit - sectiontitle: Administration diff --git a/docker-hub/audit-log.md b/docker-hub/audit-log.md new file mode 100644 index 0000000000..4f11616152 --- /dev/null +++ b/docker-hub/audit-log.md @@ -0,0 +1,67 @@ +--- +description: Audit log +keywords: Team, organization, activity, log, audit, activities +title: Audit log +--- + +> The Audit log feature is available for users subscribed to a Team plan. [Upgrade](https://www.docker.com/pricing){: target="_blank" rel="noopener" class="_"} your existing account to a Team account to start using the Audit log feature. + +Audit log displays a chronological list of activities that occur at organization and repository levels. It provides owners of Docker Team accounts a report of all their team member activities. This allows the team owners to view and track what changes were made, the date when a change was made, and who initiated the change. For example, the Audit log displays activities such as the date when a repository was created or deleted, the team member who created the repository, the name of the repository, and when there was a change to the privacy settings. + +Team owners can also see the Audit log for their repository if the repository is part of the organization subscribed to a Docker Team plan. + +## View the Audit log + +To view the Audit log: + +1. Sign into an owner account for the organization in Docker Hub. +2. Select your organization from the list and then click on the **Activity** tab. + + ![Organization activity tab](images/org-activity-tab.png){:width="700px"} + +The Audit log begins tracking activities from the date the feature is live, that is from **25 January 2021**. Activities that took place before this date are not captured. + +## Customize the Audit log + +By default, all activities that occur at organization and repository levels are displayed on the **Activity** tab. Use the calendar option to select a date range and customize your results. After you have selected a date range, the **Activity** tab displays the Audit log of all the activities that occurred during that period. + +![Activities list](images/activity-list.png){:width="600px"} + +
+ +> **Note** +> +> Activities created by the Docker Support team as part of resolving customer issues appear in the Audit log as **dockersupport**. + +
+ +Click the **All Activities** drop-down list to view activities that are specific to an organization or a repository. After choosing **Organization** or **Repository**, you can further refine the results using the **All Actions** drop-down list. If you select the **Activities** tab from the **Repository** view, you can only filter repository-level activities. + +![Refine org activities](images/org-all-actions.png){:width="600px"} + + +## Audit log event definitions + +Refer to the following section for a list of events and their descriptions: + +### Organization events + +| Event | Description | +|:------------------------------------------------------------------|:------------------------------------------------| +| Team Created | Activities related to the creation of a team | +| Team Deleted | Activities related to the deletion of a team | +| Team Member Added | Details of the member added to your team | +| Team Member Removed | Details of the member removed from your team | +| Team Member Invited | Details of the member invited to your team | +| Organization Member Removed | Details about member removed from your organization | +| Organization Created| Activities related to the creation of a new organization | + +### Repository events + +| Event | Description | +|:------------------------------------------------------------------|:------------------------------------------------| +| Repository Created | Activities related to the creation of a new repository | +| Repository Deleted | Activities related to the deletion of a repository | +| Privacy Changed | Details related to the privacy policies that were updated | +| Tag Pushed | Activities related to the tags pushed | +| Tag Deleted | Activities related to the tags deleted | diff --git a/docker-hub/images/activity-list.png b/docker-hub/images/activity-list.png new file mode 100644 index 0000000000..f01dfdfc40 Binary files /dev/null and b/docker-hub/images/activity-list.png differ diff --git a/docker-hub/images/org-activity-tab.png b/docker-hub/images/org-activity-tab.png new file mode 100644 index 0000000000..891f168a64 Binary files /dev/null and b/docker-hub/images/org-activity-tab.png differ diff --git a/docker-hub/images/org-all-actions.png b/docker-hub/images/org-all-actions.png new file mode 100644 index 0000000000..bfb46f113c Binary files /dev/null and b/docker-hub/images/org-all-actions.png differ diff --git a/docker-hub/release-notes.md b/docker-hub/release-notes.md index 83d8f41d11..f393774549 100644 --- a/docker-hub/release-notes.md +++ b/docker-hub/release-notes.md @@ -9,18 +9,26 @@ toc_max: 2 Here you can learn about the latest changes, new features, bug fixes, and known issues for each Docker Hub release. +# 2021-01-25 + +### New feature + +Docker introduces Audit log, a new feature that allows team owners to view a list of activities that occur at organization and repository levels. This feature begins tracking the activities from the release date, that is, **from 25 January 2021**. + +For more information about this feature and for instructions on how to use it, see [Audit log](audit-log.md). + # 2020-11-10 -### New features +### New feature -* The **Repositories** view now shows which images have gone stale because they haven't been +The **Repositories** view now shows which images have gone stale because they haven't been pulled or pushed recently. For more information, see [repository tags](repos.md/#viewing-repository-tags). # 2020-10-07 -### New features +### New feature -* Docker introduces Hub Vulnerability Scanning which enables you to automatically scan Docker images for vulnerabilities using Snyk. For more information, see [Hub Vulnerability Scanning](vulnerability-scanning.md). +Docker introduces Hub Vulnerability Scanning which enables you to automatically scan Docker images for vulnerabilities using Snyk. For more information, see [Hub Vulnerability Scanning](vulnerability-scanning.md). # 2020-05-14