Manual Verification of the Domain Ownership

When the transacting partner does not have the roles and permissions required by Microsoft for automated domain verification, the connector cannot verify the domain ownership. In these cases, the Distributor must perform a manual validation and update the connector configuration to proceed with the request.

Phase 1: Initiation (Ordering Process)

1. When a manual verification of the domain ownership is required, the Manual Ownership Validation field is displayed in the ordering process.

   

2. Set the Manual Ownership Validation field to Yes. This tells the system to skip the automated validation check and wait for manual confirmation.

   

3. Place the order. This action automatically generates a Helpdesk case in Connect.

   

Phase 2: Manual Validation

Once the order is submitted:

1. Monitor Notifications: Check your email or the Helpdesk case in Connect for the validation details.

2. Verify Ownership: Contact the customer directly to confirm they own the specified tenant domain.

3. Collect Data: From the Helpdesk case/email, copy the following required values:

   • external_id: The unique identifier for the transaction.

   • hub_id: The identifier for the specific Hub (e.g., HB-XXXX-XXXX).

   • domain: The customer's .onmicrosoft.com tenant domain.

Phase 3: Technical Configuration

When the processor cannot verify a domain automatically, you must manually bypass the automated validation by updating the ownership_validation_list parameter in the Connect Distributor Portal.

Configuration Steps

1. Open the Connect Distributor Portal and locate the ownership_validation_list parameter.

2. Configure the parameter adding an entry for each domain you wish to exclude from automated validation. For example:

{
    "exclude": [
        {
            "external_id": "1000001",
            "hub_id": "HB-0000-0001",
            "domain": "sample1.onmicrosoft.com"
        },
        {
            "external_id": "1000002",
            "hub_id": "HB-0000-0001",
            "domain": "sample2.onmicrosoft.com"
        }
    ]
}

Once the domain validation has been skipped, the object in this parameter can be removed.