How to Begin with Address, Email, and Phone Verification

Here's a summary of the key steps to get new Address, Email, and Phone Verification subscriptions provisioned in an Oracle Cloud Infrastructure (OCI) data center.

  1. Order a subscription for Address, Email, and Phone Verification by contacting Oracle Sales. Your subscription will be made in the same data center region as your Oracle Cloud account.

    For details about ordering subscriptions, see Order Oracle Cloud Applications in Getting Started with Oracle Cloud Applications.

    1. Add subscription to your Oracle Cloud account.

      You'll receive an email titled “Action Required: Welcome to New Oracle Cloud Service Subscription(s).” Follow the instructions in the email:

      • If you have an Oracle Cloud account, then click the Add to existing cloud account button. We recommend using your existing Oracle Cloud account to manage all your Oracle services.

        1. Specify your cloud Tenant name and click Continue
        2. Specify your username and password and click Sign In.

          The Add Subscription page is displayed.

        3. Add the new subscription to your tenancy. This page indicates the subscription name, subscription ID, and subscription description (with product SKU).
          Note: Adding a subscription to a tenancy can't be done.
      • If you're a new customer, then click the Create new cloud account button. The New Cloud Account Information sign up form is displayed.

        1. Specify your First name, Last name, and Email address. The email address is also the username for signing into the account. The person you specify here is the first administrator who can access the account and can create other users. This role also has full administrator permissions in your account.
        2. Specify a password and confirm.
        3. Specify a Tenancy Name. This is also called your cloud account name. When choosing a tenancy name, note the following:
          • The tenancy name or cloud account name is used to identify your account. The name is also used to create the URLs to access your cloud services. For example, if you call your tenancy "abccorp", an application URL might look like:

            https://abccorp-oracleservice.service.us.phoenix-1.ocs

          • The tenancy name must be unique, start with a lowercase letter and have no more than 25 lowercase letters or numbers. You can't use spaces or special characters.
        4. Select a Home region where your services will be hosted.
          Note: Your home region is the geographic location where your account and identity resources will be created. You can't change this after signing up. If you are not sure which region to select as your home region, contact your sales representative before you create your account.
        5. Read the terms of use and click Create Tenancy.
    2. Create the Data Environment.

      You'll receive a another email titled “Get Started Now with Oracle Cloud”. Click the Sign In button in the email. The Create environment page is displayed.
      1. Specify the cloud account name, credentials that you provided while creating cloud account and click Create.
      2. On the Create environment page, specify the admin email and click Create.
        Note: Ensure that you don’t select the Update option.

        A page containing the environment information is displayed.

      3. Click the environment name to view the environment details.
      4. Copy the Service console URL from the Environment information tab and other links you need from the Additional links tab.
    You or the administrator will receive an email with the subject: Action Required: Your new Data as a Service instance in Cloud Account is ready.
    1. In the email, click Access Your New Service.
    2. On the Oracle Cloud Console, click the Data application to see the Address, Email, and Phone Verification API URL.
  2. Create accounts for your users and assign them appropriate roles. The following roles are created during provisioning.
    • DATASERVICE_ADMINISTRATOR (administrator access)

    • DATASERVICE_USER (user access)

    Perform the following steps to assign users:
    1. Go to Navigator > Identity & Security > Domains.
    2. Click the current domain name.
    3. Click the Oracle cloud services tab.
    4. Drill down on the cloud service name.
    5. Click the Application roles tab.
    6. Click the … icon and click Manage users.

      You can view and assign user on the Manage user assignments page.

    To create users, see Create Users topic.

  3. Create the OAuth client credentials as follows:
    1. Follow the instructions mentioned on this page to add Confidential Application. When you reach the step to click the OAuth configuration tab and click Edit OAuth configuration, perform the following steps:

      1. Select Configure the application as a client now.
      2. Select the following Allowed grant types in the Authorization section:
        • Resource owner
        • Client credentials
        • Refresh token
      3. Click Submit.
        Note: For any integration or using Oracle Cloud service with Address, Email, and Phone Verification APIs, you require the client credentials. Use these steps:
        1. Copy the Client ID in the General Information section.
        2. Copy the Show secret information in the Client secret section.
      4. Click Actions > Activate.
Note:

To associate another Oracle Cloud service with Address, Email, and Phone Verification as well as Account and Contact Enrichment, both services must be part of the same subscription order. For instance, if you order Account Enrichment first, then add Address Verification later, then you must upgrade your Account Enrichment subscription to include Address Verification or vice versa.

When associated with the same instance of another Oracle Cloud service, the Account and Contact Enrichment and Address, Email, and Phone Verification cannot exist in separate instances.

How to Update Your Subscription

You can expand or renew your subscription by contacting Oracle Sales. You'll get an activation email with the subject: Your service has been updated.