Verifying or approving a domain for your enterprise account

You can verify your ownership of domains with GitHub to confirm the identity of organizations owned by your enterprise account. You can also approve domains that GitHub can send email notifications to for members of organizations owned by your enterprise account.

Enterprise owners can verify or approve a domain for an enterprise account.

Las cuentas empresariales se encuentran disponibles con GitHub Enterprise Cloud y Servidor de GitHub Enterprise. Para obtener más información, consulta la sección "Acerca de las cuentas empresariales".

En este artículo

About domain verification

You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account.

After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website www.example.com and the email address info@example.com, you would need to verify both www.example.com and example.com.

Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain.

After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "Restricting email notifications for your enterprise account."

Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications at any domains verified or approved for the enterprise account, in addition to any domains verified or approved for the organization. For more information about restricting notifications for an organization, see "Restricting email notifications for your organization."

Organization owners can also verify additional domains for their organizations. For more information, see "Verifying or approving a domain for your organization."

About domain approval

Note: Domain approval is currently in beta and subject to change.

If you want to allow members to receive email notifications at a domain you don't own, you can approve the domain, then allow GitHub to send email notifications to addresses within the domain. For example, you can allow a contractor who doesn't have an email address within your own domain to receive email notifications at a domain you feel comfortable with.

After you approve domains for your enterprise account, you can restrict email notifications for activity within your enterprise account to users with verified email addresses within verified or approved domains. For more information, see "Restricting email notifications for your enterprise account."

If you want to allow members to receive email notifications at a domain you don't own, you can approve the domain, then allow GitHub to send email notifications to addresses within the domain. For example, you can allow a contractor who doesn't have an email address within your own domain to receive email notifications at a domain you feel comfortable with.

To receive email notifications, the owner of the user account must verify the email address in on GitHub. For more information, see "Verifying your email address."

Organization owners cannot see the email address or which user account is associated with an email address from an approved domain.

Organization owners can also approve additional domains for their organizations. For more information, see "Verifying or approving a domain for your organization."

Verifying a domain for your enterprise account

To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service.

  1. Visita la cuenta de tu empresa en https://github.com/enterprises/ENTERPRISE-NAME, reemplazando ENTERPRISE-NAME por el nombre de la cuenta de tu empresa.
  2. En la barra lateral de la cuenta de empresa, haz clic en Settings (Configuraciones). Pestaña Settings (Configuraciones) en la barra lateral de la cuenta de empresa
  3. Under "Settings", click Verified & approved domains. "Verified & approved domains" tab
  4. Click Add a domain. Add a domain button
  5. In the domain field, type the domain you'd like to verify, then click Add domain. Add a domain field
  6. Follow the instructions under Add a DNS TXT record to create a DNS TXT record with your domain hosting service. Instructions to create a DNS txt record
  7. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the dig command on the command line, replacing ENTERPRISE-ACCOUNT with the name of your enterprise account, and example.com with the domain you'd like to verify. You should see your new TXT record listed in the command output.
    dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT
  8. After confirming your TXT record is added to your DNS, follow steps one through four above to navigate to your enterprise account's approved and verified domains.
  9. To the right of the domain that's pending verification, click , then click Continue verifying. Continue verifying domain button
  10. Click Verify. Verify button
  11. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. Verified badge

Approving a domain for your enterprise account

Note: Domain approval is currently in beta and subject to change.

  1. Visita la cuenta de tu empresa en https://github.com/enterprises/ENTERPRISE-NAME, reemplazando ENTERPRISE-NAME por el nombre de la cuenta de tu empresa.
  2. En la barra lateral de la cuenta de empresa, haz clic en Settings (Configuraciones). Pestaña Settings (Configuraciones) en la barra lateral de la cuenta de empresa
  3. Under "Settings", click Verified & approved domains. "Verified & approved domains" tab
  4. Click Add a domain. Add a domain button
  5. In the domain field, type the domain you'd like to verify, then click Add domain. Add a domain field
  6. To the right of "Can't verify this domain?", click Approve it instead. "Approve it instead" text when verifying a domain
  7. Read the information about domain approval, then click Approve DOMAIN. "Approve DOMAIN" button in confirmation dialog

Removing an approved or verified domain

  1. Visita la cuenta de tu empresa en https://github.com/enterprises/ENTERPRISE-NAME, reemplazando ENTERPRISE-NAME por el nombre de la cuenta de tu empresa.
  2. En la barra lateral de la cuenta de empresa, haz clic en Settings (Configuraciones). Pestaña Settings (Configuraciones) en la barra lateral de la cuenta de empresa
  3. Under "Settings", click Verified & approved domains. "Verified & approved domains" tab
  4. To the right of the domain to remove, click , then click Delete. "Delete" for a domain

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.