Newer Version Available

This content describes an older version of this product. View Latest

Setting up My Domain for the Environment Hub


User Permissions Needed
To set up a domain name: “Customize Application”

You can create new organizations in Environment Hub without using My Domain. However, if you want to enable single sign-on or connect existing organizations to Environment Hub, you need to set up and deploy My Domain first.

  1. Find a domain name that’s available and sign up for it.
    1. From Setup, click Domain Management | My Domain.
    2. Enter the subdomain name you want to use within the sample URL. You can use up to 40 characters.
    3. Click Check Availability. If your name is already taken, choose a different one.
    4. Click Terms and Conditions to review your agreement, then select the checkbox.
    5. Click Register Domain.
    You'll receive an email when your domain name is ready for testing. It can take from 10 minutes to 24 hours.
  2. Test your domain name and deploy it to your entire organization.
    1. From Setup, click Domain Management | My Domain, then click Click here to login, or click the URL in the confirmation email, to login to Salesforce using your new domain name.
    2. Test the new domain name by clicking tabs and links within your application. You’ll notice that all pages show your new domain name. If you’ve customized your Salesforce UI with features such as custom buttons or Visualforce pages, make sure you test custom elements thoroughly before deploying your domain name. Your customizations should not use instance-based URLs.
    3. To roll out the new domain name to your organization, from Setup, click Domain Management | My Domain and then click Deploy to Users .
    The domain is activated immediately and all users are redirected to pages with new domain addresses.
  3. Set the domain login policy for users accessing your pages.
    1. From Setup, click Domain Management | My Domain.
    2. Under My Domain Settings, click Edit.
    3. To turn off authentication for users who do not use your domain-specific login page, select the login policy. For example, this will prevent users from logging in at the generic https://<instance>.salesforce.com/ login page, and being redirected to your pages after login. This option enhances security by preventing login attempts by anyone who does not know your domain name.
    4. Choose a redirect policy, based on the level of security desired. You have three options, in order of increasing security:
      • Redirect users to the same page within the domain.
      • Redirect users with a warning.
      • Prevent redirecting, so users have to enter the new domain name.
  4. Optionally, customize your login page and add or change identity providers available on your login page. For details, see the Salesforce online help.