Skip to content

Commit 784981f

Browse files
authored
[GHEC version] Version content about domain verification and restricting email notifications to verified domains (github#26876)
1 parent 5272ad3 commit 784981f

File tree

5 files changed

+41
-21
lines changed

5 files changed

+41
-21
lines changed

content/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,14 @@ topics:
1515
- Profiles
1616
shortTitle: Organization's profile
1717
---
18+
1819
You can optionally choose to add a description, location, website, and email address for your organization, and pin important repositories.{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4749 %} You can customize your organization's profile by adding a README.md file. For more information, see "[Customizing your organization's profile](/organizations/collaborating-with-groups-in-organizations/customizing-your-organizations-profile)."{% endif %}
1920

20-
{% ifversion fpt or ghec %}To confirm your organization's identity and display a "Verified" badge on your organization profile page, you must verify your organization's domains with {% data variables.product.product_name %}. For more information, see "[Verifying or approving a domain for your organization](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)."{% endif %}
21+
{% ifversion fpt %}
22+
Organizations that use {% data variables.product.prodname_ghe_cloud %} can confirm their organization's identity and display a "Verified" badge on their organization's profile page by verifying the organization's domains with {% data variables.product.product_name %}. For more information, see "[Verifying or approving a domain for your organization](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)" in the {% data variables.product.prodname_ghe_cloud %} documenatation.
23+
{% elsif ghec or ghes > 3.1 %}
24+
To confirm your organization's identity and display a "Verified" badge on your organization profile page, you can verify your organization's domains with {% data variables.product.prodname_dotcom %}. For more information, see "[Verifying or approving a domain for your organization](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)."
25+
{% endif %}
2126

2227
{% ifversion fpt or ghes > 3.2 or ghec %}
2328
![Sample organization profile page](/assets/images/help/organizations/org_profile_with_overview.png)

content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
---
22
title: Restricting email notifications for your organization
33
intro: 'To prevent organization information from leaking into personal email accounts, you can restrict the domains where members can receive email notifications about organization activity.'
4-
product: '{% data reusables.gated-features.restrict-email-domain %}'
54
permissions: Organization owners can restrict email notifications for an organization.
65
redirect_from:
76
- /articles/restricting-email-notifications-about-organization-activity-to-an-approved-email-domain
@@ -10,7 +9,6 @@ redirect_from:
109
- /organizations/keeping-your-organization-secure/restricting-email-notifications-to-an-approved-domain
1110
- /organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization
1211
versions:
13-
fpt: '*'
1412
ghes: '>=3.2'
1513
ghec: '*'
1614
type: how_to
@@ -26,18 +24,16 @@ shortTitle: Restrict email notifications
2624

2725
When restricted email notifications are enabled in an organization, members can only use an email address associated with a verified or approved domain to receive email notifications about organization activity. For more information, see "[Verifying or approving a domain for your organization](/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization)."
2826

29-
{% data reusables.enterprise-accounts.approved-domains-beta-note %}
30-
31-
{% data reusables.notifications.email-restrictions-verification %}
32-
33-
{% ifversion fpt or ghec %}
27+
{% ifversion ghec %}
3428
{% note %}
3529

3630
**Note:** To restrict email notifications, your organization must use {% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise.link-to-ghec-trial %}
3731

3832
{% endnote %}
3933
{% endif %}
4034

35+
{% data reusables.notifications.email-restrictions-verification %}
36+
4137
Outside collaborators are not subject to restrictions on email notifications for verified or approved domains. For more information about outside collaborators, see "[Roles in an organization](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#outside-collaborators)."
4238

4339
If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified or approved for the enterprise account, in addition to any domains verified or approved for the organization. For more information, see "[Verifying or approving a domain for your enterprise](/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."

content/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,13 @@
11
---
22
title: Verifying or approving a domain for your organization
33
intro: 'You can verify your ownership of domains with {% data variables.product.company_short %} to confirm your organization''s identity. You can also approve domains that {% data variables.product.company_short %} can send email notifications to for members of your organization.'
4-
product: '{% data reusables.gated-features.verify-and-approve-domain %}'
54
redirect_from:
65
- /articles/verifying-your-organization-s-domain
76
- /articles/verifying-your-organizations-domain
87
- /github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain
98
- /organizations/managing-organization-settings/verifying-your-organizations-domain
109
permissions: Organization owners can verify or approve a domain for an organization.
1110
versions:
12-
fpt: '*'
1311
ghes: '>=3.2'
1412
ghec: '*'
1513
type: how_to
@@ -23,15 +21,25 @@ shortTitle: Verify or approve a domain
2321

2422
## About domain verification
2523

26-
After verifying ownership of your organization's domains, a "Verified" badge will display on the organization's profile. {% ifversion fpt or ghec %}If your organization is on {% data variables.product.prodname_ghe_cloud %} and has agreed to the Corporate Terms of Service, organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. For more information, see "[About your organization's profile page](/articles/about-your-organization-s-profile/)" and "<a href="/articles/upgrading-to-the-corporate-terms-of-service" class="dotcom-only">Upgrading to the Corporate Terms of Service</a>."{% endif %}
24+
After verifying ownership of your organization's domains, a "Verified" badge will display on the organization's profile. {% ifversion ghec %}If your organization has agreed to the Corporate Terms of Service, organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. For more information, see "[About your organization's profile page](/articles/about-your-organization-s-profile/)" and "<a href="/articles/upgrading-to-the-corporate-terms-of-service" class="dotcom-only">Upgrading to the Corporate Terms of Service</a>."{% endif %}
2725

28-
{% ifversion fpt or ghec %}If your organization is owned by an enterprise account, a{% elsif ghes %}A{% endif %} "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. Organization owners can view any domains that an enterprise owner has verified or approved, and edit the domains if the organization owner is also an enterprise owner. {% ifversion fpt or ghec %}For more information, see "[Verifying or approving a domain for your enterprise](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}{% ifversion ghes > 3.1 %}For more information, see "[Verifying or approving a domain for your enterprise](/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}
26+
{% ifversion ghec %}If your organization is owned by an enterprise account, a{% elsif ghes %}A{% endif %} "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. Organization owners can view any domains that an enterprise owner has verified or approved, and edit the domains if the organization owner is also an enterprise owner. For more information, see "[Verifying or approving a domain for your enterprise](/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."
27+
28+
{% ifversion ghec %}
29+
{% note %}
30+
31+
**Note:** To verify or approve domains, your organization must use {% data variables.product.prodname_ghe_cloud %}. {% data reusables.enterprise.link-to-ghec-trial %}
32+
33+
{% endnote %}
34+
{% endif %}
2935

3036
{% data reusables.organizations.verified-domains-details %}
3137

32-
{% ifversion fpt or ghec %}On {% data variables.product.prodname_ghe_cloud %}, after verifying ownership of your organization's domain, you can restrict email notifications for the organization to that domain. For more information, see "[Restricting email notifications for your organization](/organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization)." {% ifversion fpt %}{% data reusables.enterprise.link-to-ghec-trial %}{% endif %}{% endif %}
38+
{% ifversion ghec or ghes > 3.1 %}
39+
After verifying ownership of your organization's domain, you can restrict email notifications for the organization to that domain. For more information, see "[Restricting email notifications for your organization](/organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization)."
40+
{% endif %}
3341

34-
{% ifversion fpt or ghec %}You can also verify custom domains used for {% data variables.product.prodname_pages %} to prevent domain takeovers when a custom domain remains configured but your {% data variables.product.prodname_pages %} site is either disabled or no longer uses the domain. For more information, see "[Verifying your custom domain for {% data variables.product.prodname_pages %}](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages)."{% endif %}
42+
{% ifversion ghec %}You can also verify custom domains used for {% data variables.product.prodname_pages %} to prevent domain takeovers when a custom domain remains configured but your {% data variables.product.prodname_pages %} site is either disabled or no longer uses the domain. For more information, see "[Verifying your custom domain for {% data variables.product.prodname_pages %}](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages)."{% endif %}
3543

3644
## About domain approval
3745

@@ -43,7 +51,7 @@ After you approve domains for your organization, you can restrict email notifica
4351

4452
Enterprise owners cannot see which organization members or email addresses receive notifications within approved domains.
4553

46-
Enterprise owners can also approve additional domains for organizations owned by the enterprise. {% ifversion fpt or ghec %}For more information, see "[Verifying or approving a domain for your enterprise](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}{% ifversion ghes > 3.1 %}For more information, see "[Verifying or approving a domain for your enterprise](/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}
54+
Enterprise owners can also approve additional domains for organizations owned by the enterprise. {% ifversion ghec %}For more information, see "[Verifying or approving a domain for your enterprise](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}{% ifversion ghes > 3.1 %}For more information, see "[Verifying or approving a domain for your enterprise](/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise)."{% endif %}
4755

4856
## Verifying a domain for your organization
4957

@@ -66,12 +74,8 @@ To verify a domain, you must have access to modify domain records with your doma
6674

6775
## Approving a domain for your organization
6876

69-
{% ifversion fpt or ghes > 3.1 or ghec %}
70-
7177
{% data reusables.enterprise-accounts.approved-domains-beta-note %}
7278

73-
{% endif %}
74-
7579
{% data reusables.profile.access_org %}
7680
{% data reusables.profile.org_settings %}
7781
{% data reusables.organizations.verified-domains %}

content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,9 +91,9 @@ Some of the features listed below are limited to organizations using {% data var
9191
| Set scheduled reminders (see "[Managing scheduled reminders for pull requests](/github/setting-up-and-managing-organizations-and-teams/managing-scheduled-reminders-for-pull-requests)") | **X** | | | | |
9292
| Add collaborators to **all repositories** | **X** | | | | |
9393
| Access the organization audit log | **X** | | | | |
94-
| Edit the organization's profile page (see "[About your organization's profile](/github/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile)") | **X** | | | | |
94+
| Edit the organization's profile page (see "[About your organization's profile](/github/setting-up-and-managing-your-github-profile/customizing-your-profile/about-your-organizations-profile)") | **X** | | | | |{% ifversion ghec %}
9595
| Verify the organization's domains (see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)") | **X** | | | | |
96-
| Restrict email notifications to verified or approved domains (see "[Restricting email notifications for your organization](/organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization)") | **X** | | | | |
96+
| Restrict email notifications to verified or approved domains (see "[Restricting email notifications for your organization](/organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization)") | **X** | | | | |{% endif %}
9797
| Delete **all teams** | **X** | | | | |
9898
| Delete the organization account, including all repositories | **X** | | | | |
9999
| Create teams (see "[Setting team creation permissions in your organization](/articles/setting-team-creation-permissions-in-your-organization)") | **X** | **X** | **X** | | **X** |

lib/redirects/static/redirect-exceptions.txt

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -467,6 +467,21 @@
467467
/enterprise-cloud@latest/code-security/security-overview/filtering-alerts-in-the-security-overview
468468
- /code-security/security-overview/filtering-alerts-in-the-security-overview
469469

470+
/enterprise-cloud@latest/organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization
471+
- /organizations/managing-organization-settings/verifying-or-approving-a-domain-for-your-organization
472+
- /articles/verifying-your-organization-s-domain
473+
- /articles/verifying-your-organizations-domain
474+
- /github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain
475+
- /organizations/managing-organization-settings/verifying-your-organizations-domain
476+
477+
/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization
478+
- /organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/restricting-email-notifications-for-your-organization
479+
- /articles/restricting-email-notifications-about-organization-activity-to-an-approved-email-domain
480+
- /articles/restricting-email-notifications-to-an-approved-domain
481+
- /github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain
482+
- /organizations/keeping-your-organization-secure/restricting-email-notifications-to-an-approved-domain
483+
- /organizations/keeping-your-organization-secure/restricting-email-notifications-for-your-organization
484+
470485
/enterprise-cloud@latest/organizations/managing-git-access-to-your-organizations-repositories
471486
- /organizations/managing-git-access-to-your-organizations-repositories
472487
- /articles/managing-git-access-to-your-organizations-repositories-using-ssh-certificate-authorities

0 commit comments

Comments
 (0)