Oracle Cloud Infrastructure Documentation

Adding Domains

Add domains in Domain Management.

  • For existing customers, follow these instructions to add and verify a domain.

    1. Open the navigation menu and click Governance & Administration. Under Tenancy Management, click Domain Management.
    2. Click Add and Verify Domain. The Add and Verify Domain panel opens.

      If a policy hasn't already been created, an Add Policy Notification is displayed, informing you that a default policy must first be created, to allow Domain Management to write notifications in the particular tenancy and compartment.

      Click Add Policy to confirm. See Using the Console for more information on viewing the list of policies, where a new Domain_Governance_Policy is present on the Policies page after the policy has been added.

      After the policy has been added, Domain Management can create notifications, which are sent to the email address in the Add and Verify Domain panel. If you don't agree to policy creation, you can't proceed with the rest of the domain setup steps.

    3. In the Add and Verify Domain panel, enter the email address of the domain to be added. This email address is used when someone with the verified domain tries to create an Oracle Cloud account.
    4. Agree to the Oracle Notification Service rates. For more information, see Notifications.
    5. In Domain, enter the domain you want to add and verify. Don't include the protocol (neither http:// nor https://).
    6. Click Add and Verify Domain.

      The domain is added, and the TXT Record field is populated with a generated name and value. Copy the TXT file so you can sign in to the domain's account and add the TXT record information to the domain's registrar.

      After you have completed adding the TXT record, Oracle verifies that you own the domain. After verification, you receive an email notification that the status has changed from Pending to Verified. This process can take up to 72 hours to complete. See https://www.godaddy.com/help/add-a-txt-record-19232 for more information on TXT records.
    7. Click Close to return to the Domain Management page.
    After refreshing the page, the Domain Management page displays the new domain you have added according to the following:
    • Domain: The name of the domain and its associated OCID.
    • Notifications: Links to the Notifications topic. Topics aren't created, however, until verification has occurred.
      Important

      When a domain has been verified and the topics have been created, you receive an email to confirm the subscription. You must confirm the email subscription before you can start receiving email notifications.
    • TXT Record: The generated TXT record.
    • Email: The domain email.
    • Status: The domain verification status:
      • Pending: Verification in process.
      • Failed: Verification no good after 72 hours.
      • Active: Verified and governance enabled.
      • Disabled: Verified but not governed.
      • Releasing: Customer requested removal (work request triggered).
      • Released: The work request is complete, and will be removed from the Domain Management page after seven days.
    • Date: The last change date. This field updates when verified, enabled, disabled, or if the email was updated.
    After a domain's Status is Active, you can do the following:

  • Use the oci organizations domain create command and required parameters to start the registration process to claim a domain:

    oci organizations domain create --compartment-id, -c [text] --domain-name [text] ... [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the CreateDomain operation to start the registration process to claim a domain.