From f0aa8398ca7e95528e1f572510920e37609d71be Mon Sep 17 00:00:00 2001 From: aevesdocker Date: Wed, 22 Jan 2025 09:28:50 +0000 Subject: [PATCH] editorial review --- .../admin-user-management/audit-and-monitor.md | 4 ++-- content/guides/admin-user-management/onboard.md | 16 ++++++++-------- content/guides/admin-user-management/setup.md | 6 ++++-- 3 files changed, 14 insertions(+), 12 deletions(-) diff --git a/content/guides/admin-user-management/audit-and-monitor.md b/content/guides/admin-user-management/audit-and-monitor.md index ee57e35296c..905dd7fbaab 100644 --- a/content/guides/admin-user-management/audit-and-monitor.md +++ b/content/guides/admin-user-management/audit-and-monitor.md @@ -27,7 +27,7 @@ It is available for Docker Team or Docker Business plans, with data retained for - Billing adjustments: Track who added or removed subscription seats to maintain budgetary control and compliance. -For more information, see [Activity logs](/manuals/admin/organization/activity-logs.md) +For more information, see [Activity logs](/manuals/admin/organization/activity-logs.md). ## Insights @@ -49,4 +49,4 @@ Insights provide data-driven views of Docker usage to improve team productivity - Container utilization: Analyze container activity across departments to ensure proper resource distribution and cost efficiency. - For more information, see [Insights](/manuals/admin/organization/insights.md) + For more information, see [Insights](/manuals/admin/organization/insights.md). diff --git a/content/guides/admin-user-management/onboard.md b/content/guides/admin-user-management/onboard.md index 4428b933874..674d1093348 100644 --- a/content/guides/admin-user-management/onboard.md +++ b/content/guides/admin-user-management/onboard.md @@ -9,15 +9,15 @@ This page guides you through onboarding owners and members, and using tools like ## Step 1: Invite owners -When you create a Docker organization, you automatically become its sole owner. While optional, adding additional owners can significantly ease the process of onboarding and managing your organization by distributing administrative responsibilities. It also ensures continuity and does not cause a blocker if the primary own is unavailable. +When you create a Docker organization, you automatically become its sole owner. While optional, adding additional owners can significantly ease the process of onboarding and managing your organization by distributing administrative responsibilities. It also ensures continuity and does not cause a blocker if the primary owner is unavailable. -For detailed information on owners, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md) +For detailed information on owners, see [Roles and permissions](/manuals/security/for-admins/roles-and-permissions.md). -## Step 2: Invite members +## Step 2: Invite members and assign roles -Members are granted controlled access to resources and enjoy enhanced organizational benefits. +Members are granted controlled access to resources and enjoy enhanced organizational benefits. When you invite members to join you Docker organization, you immediately assign them a role. -### Why invite members? +### Benefits of inviting members - Enhanced visibility: Gain insights into user activity, making it easier to monitor access and enforce security policies. @@ -29,7 +29,7 @@ Members are granted controlled access to resources and enjoy enhanced organizati - Security control: Apply and enforce security settings at an organizational level, reducing risks associated with unmanaged accounts. -For detailed information, see [Manage organization members](/manuals/admin/organization/members.md) +For detailed information, see [Manage organization members](/manuals/admin/organization/members.md). ## Step 3: Future-proof user management @@ -47,7 +47,7 @@ SSO: - Simplifies onboarding as it works seamlessly with SCIM and group mapping for automated provisioning. -[SSO documentation](/manuals/security/for-admins/single-sign-on/_index.md) +[SSO documentation](/manuals/security/for-admins/single-sign-on/_index.md). ### Automate onboarding with SCIM and JIT provisioning @@ -77,4 +77,4 @@ It also: - Help you scale permissions as teams grow or change. -For more information on how it works, see [Group mapping](/manuals/security/for-admins/provisioning/group-mapping.md) +For more information on how it works, see [Group mapping](/manuals/security/for-admins/provisioning/group-mapping.md). diff --git a/content/guides/admin-user-management/setup.md b/content/guides/admin-user-management/setup.md index dc561930643..3bec55731ee 100644 --- a/content/guides/admin-user-management/setup.md +++ b/content/guides/admin-user-management/setup.md @@ -5,9 +5,9 @@ keywords: Docker roles, permissions management, access control, IT administratio weight: 10 --- -With the right configurations, you can ensure your developers have easy access to necessary resources while preventing unauthorized access. This page guides you through identifying Docker users, so you can allocate subscription seats efficiently, and assigning roles to align with your organization's structure. +With the right configurations, you can ensure your developers have easy access to necessary resources while preventing unauthorized access. This page guides you through identifying Docker users, so you can allocate subscription seats efficiently within your Docker organization, and assigning roles to align with your organization's structure. -## Step one: Identify your Docker users and accounts +## Step 1: Identify your Docker users and accounts Before setting up roles and permissions, it’s important to have a clear understanding of who in your organization requires Docker access. Focus on gathering a comprehensive view of active users, their roles within projects, and how they interact with Docker resources. This process can be supported by tools like device management software or manual assessments. Encourage all users to update their Docker accounts to use organizational email addresses, ensuring seamless integration with your subscription. @@ -15,6 +15,8 @@ For steps on how you can do this, see [step 1 of onboarding your organization](/ ## Step 2: Assign roles strategically +When you invite members to join you Docker organization, you assign them a role. + Docker’s predefined roles offer flexibility for various organizational needs. Assigning roles effectively ensures a balance of accessibility and security. - Member: Non-administrative role. Members can view other members that are in the same organization.