IBM SmartCloud for Social Business (SmartCloud for Social Business) uses a CNAME record for the purpose of verifying an Internet domain name. The service requires you to create a CNAME record to prove ownership of a domain. Your domain host service should provide instructions for creating a CNAME record; however, if they do not, contact them directly.
After completing this exercise, you should be able to:
- Configure your CNAME record within SmartCloud for Social Business
- Verify ownership of your Internet domain(s)
A CNAME record or Canonical Name record is a type of resource record in the Domain Name System (DNS) that specifies that the domain name is an alias of another, canonical domain name.
Internet domain name
An organization's identity on the internet. For example, llntrain.com
A mail exchanger record (MX record) is a type of resource record in the Domain Name System that specifies a mail server responsible for accepting mail messages on behalf of a recipient's domain and a preference value used to priorities mail delivery if multiple mail servers are available. The set of MX records of a domain name specifies how mail should be routed with the Simple Mail Transfer Protocol (SMTP)
Parent topic: Lesson 1: Deploying IBM SmartCloud Notes in a Service-only environment
Previous topic: Exercise 1.2: Configuring IBM SmartCloud Notes service-only environment for your company
Next topic: Exercise 1.4: Configuring Mail file templates
1. Log into the service and navigate to the IBM SmartCloud Notes
For detailed steps, see the procedure document Accessing the SmartCloud Notes Administration panel
2. Click Account Settings
. Click Internet Domains
to see your existing domains.
3. Click Internet Domain Verification.
4. Look at the list of Internet domain names, and then for any Internet domain that requires verification, click Verify Ownership
The Internet Domain Verification window shows you the information you need to create your CNAME record on your company DNS.
Example: If mycompany.com
is the Internet domain name you are trying to verify, and notes-10sfnn8om3lz4-test
is the unique key, then notes-10sfnn8om3lz4-test.mycompany.com
is the CNAME information that points to the domain collabserv.com.com on your company DNS.
Background: SmartCloud for Social Business uses a CNAME record to verify your internet domain. A CNAME record is an entry in the domain name system that is used to define a host name alias for an internet domain.
5. Copy the unique key to the clipboard, click the Begin Verification
button, then configure the CNAME record with your DNS. When you click the button, the CNAME value is stored in the IBM SmartCloud Notes
service. You may then use the value to create the CNAME record.
Alternatively, you can leave the window open while creating the CNAME record, and then after you have configured the CNAME record in the DNS, click the Begin Verification
button. But be aware that your session may expire.
To create a CNAME record for your domain, you sign into your domain hosting service and use the DNS Management settings. There are two fields to complete in a CNAME record and the field names vary
by vendor. Be sure to put the unique key into the first field, which is sometimes referred to as Prefix or Alias. Enter collabserv.com
in the second field, which is sometimes referred to as Destination
or Target host
. The SmartCloud
for Social Business service uses the Alias in the CNAME record to query your domain. A successful query proves that you were able to create the CNAME record and therefore that you own the domain. If you need assistance creating a CNAME record, contact
your domain provider.
If you are in the process of switching vendors, it is ok to verify the domain before you make the switch.
If you do not have the authority to create a CNAME record for your domain, extra time may be required to contact your domain hosting service and have them create the record for you.
After ownership of the domain has been verified, you can delete the CNAME record from your domain host service.
6. If verification is not successful, check that the unique key shown on the screen exactly matches the one added to the CNAME record recognised by your domain host service. If the values are different, DO NOT click Restart Verification. Whenever you click Restart Verification, a new unique key is generated. Rather, add the key shown on the screen to the CNAME record configured in your domain host service, and wait again for verification to complete. Note:
Verification may complete right away and report success.
Verification may take some time. If it does not complete right away, it will be reported as in progress. When verification is in progress, you may exit your browser. Domain verification may take as long as 48 hours, although usually it takes 24 hours or less.
Do not Restart Verification simply because you think the current verification is taking too long.
7. After 48 hours, click Account Settings
-> Internet Domain Verification
You should see that your Internet domain (in this example, verified.com
) has completed verification.
8. Configure the MX record for your internet domain through your domain host service. You must configure a Mail Exchange record for the domain that points tosmtp.notes.na.collabserv.com
(if applicable). The MX record enables the service to route inbound internet mail to the domain.
If the domain is currently in use for mail routing in your environment, you will likely want to configure the MX record after user provisioning is complete. That way, users can continue to receive Internet mail until they are provisioned for the service.
To learn more, see the Help topic Configuring the MX record for a domain
You have cancelled domain verification because your company DNS administrator is unavailable for 1 week. You have made a note of the unique CNAME key. What should you do with this?
Discard the unique key. Restart the process when your company DNS administrator is available again. When you restart verification, a new unique key will be created. Give this key to your company DNS administrator.
When you are ready to perform the procedure to verify Internet domain verification in your production environment, gather the required data to verify ownership of your domain in your SmartCloud for Social Business environment.
Before you begin:
- Ensure you have the ability to configure your DNS settings through your Domain Host service, or access to your DNS administrator
- An administrator account login for SmartCloud for Social Business