Creating 'Office 365' Application Instance

To be able to use the Office 365 application, first you should create the new application instance.

  1. In Provider Control Panel, go to Services > Applications and click the Office 365 package that you have imported before.
  2. Open the Instances tab and click Install.

  3. Specify the following parameters:

    • Application API end-point URI – The application API endpoint URI. This URI is constructed in the following way: https://<Office_365_Gateway_Site_Hostname>/<Office_365_Gateway_Application_Name>/aps/. Example: https://office365gateway01.hosting.local/Office365GatewayApplication01/aps/.
    • Application Version – Select the required version of the application.

    Click Next.

    Important:

    1. The hostname specified in Office_365_Gateway_Site_Name must be resolved from the OA Operations Management Node into the BackNet IP address of the Office 365 Application Endpoint Host.

    2. Each Office 365 gateway site requires a separate BackNet IP address.

  4. Specify the following application global settings:

    • Instance Name – The name of the application instance.
    • URL for Microsoft Online Services Portal – The URL of the Office 365 admin center.
    • Homepage – The URL of your website. This parameter is optional. If it is specified, this URL is displayed in Customer Control Panel. For example: https://provider.com.
    • OA Billing OpenAPI URL – The OA Billing Public API URL. For example: https://BILLING_APPLICATION_SERVER_BACKNET_IP:5224/RPC2.
    • User name for connecting to OA Billing API – The name of the prepared user for connecting to the OA Billing Public API.
    • User password for connecting to OA Billing API – The password of the prepared user for connecting to the OA Billing Public API.
    • Administrator's login for connecting to Microsoft Online – The login of the admin user of your CSP account. This parameter is mandatory. For example: oa_account@<partnersubdomain>.onmicrosoft.com (for Microsoft Cloud), oa_account@<partnersubdomain>.onmicrosoft.de (for Microsoft Cloud Germany), or oa_account@<partnersubdomain>.partner.onmschina.cn (for Office 365 operated by 21Vianet in China).
    • Administrator's password for connecting to Microsoft Online – The password of the admin user of your CSP account. This parameter is mandatory. Note that the global setting is shown only when an application instance is created or global settings of an application instance are edited.
    • ID of Native Client for Partner Center SDK – Specify the prepared App ID of the native app of the Partner Center API.
    • ID of Native Client for Azure AD Graph API – Specify the prepared App ID of the native app of the Graph API.
    • Reseller tenant ID – Specify the prepared Account ID / Commerce ID.
    • Application reply URL prefix – Leave the default value of the setting.
    • Subscription Disabling Behavior – Leave the default value of the setting.

    • Customer Deactivation Behavior – Choose the way how to handle Microsoft Online accounts when the corresponding Odin Automation subscriptions are cancelled in Odin Automation. The following options are available:

      • Production Account – When an Odin Automation subscription is cancelled in Odin Automation, the corresponding Microsoft Online account and subscriptions are disabled. The corresponding Microsoft Online users are removed. Use this option for production environments. This option is selected by default.
      • TIP (Test In Production) Account – When an Odin Automation subscription is cancelled in Odin Automation, the corresponding Microsoft Online account, users, and subscriptions are removed. Use this option for test environments only.
    • Confirm Deactivation Behavior – Confirm the TIP (Test In Production) Account customer deactivation behavior by selecting the I do understand the difference between TIP and Production accounts and my account is a TIP account option.
    • Federated Credentials Provider Application Instance – Leave the default value of the setting.
    • Verification DNS Record Type – Choose the DNS record type which will be used for the verification of domains delegated to the Office 365 application. The following options are available: CNAME (deprecated), TXT (recommended). The TXT value is selected by default.
    • "Secondary E-mail" is a mandatory Service User's details field – Leave the default value. This global setting is reserved for future use.
    • Welcome Message Templates Download URL – If you need to send welcome messages to newly created Office 365 users, specify the prepared URL.
    • Lync Partner Name and Plan – Leave the default value of the setting.
    • Format Phone Numbers – Make sure it is set to No (the checkbox is clear).

    • Prefix for Naming Subscriptions – A prefix for generating names of customer default subdomains. The following options are available:

      • If this parameter is not specified, names of customer default subdomains must be manually specified in the online store or Customer Control Panel.
      • If this parameter is specified and names of customer default subdomains are not manually specified, Odin Automation automatically generates these names using the value of the parameter and subscription identifiers. For example, if the value of the parameter and a subscription identifier are companyabc and 1000000, the name of the customer default subdomain will be companyabc1000000.onmicrosoft.com (for Microsoft Cloud), companyabc1000000.onmicrosoft.de (for Microsoft Cloud Germany), or companyabc1000000.partner.onmschina.cn (for Office 365 operated by 21Vianet in China). Note that you must use only the following symbols for this parameter: a-z, A-Z, 0-9.
    • Drivers environment – Select either Direct CSP Provider or Indirect CSP Provider depending on the type of the CSP account you create the application instance for.
    • Provider can change application settings – Leave the default value of the setting.
    • Gate URL – Leave the default value of the setting.
    • T2 Client ID – Leave the default value of the setting.
    • T2 Client Secret Key – Leave the default value of the setting.
    • T2 MPN ID – Leave the default value of the setting.
    • T2 Reseller tenant ID – Leave the default value of the setting.
    • MPN ID – Leave the default value of the setting.
    • OA Operations OpenAPI URL – The OA Operations Public API URL. This URL can be obtained at System > Settings > Public API in the Integration group.
    • User name for connecting to OA Operations API – The login of the prepared user for connecting to the OA Operations Public API.
    • User password for connecting to OA Operations API – The password of the prepared user for connecting to the OA Operations Public API.

    • Automatically add domains to Office 365 organizations – Specify if the auto-linking of customer domains to Office 365 organizations is turned on. The following options are available:

      • Yes – When a customer buys Office 365 services, all of the existing domains of the customer account as well as the domains bought with the Office 365 services are automatically added to the Office 365 organization of the customer. Also, the Exchange and Lync services are enabled for these customer domains. Note that domains already having MX DNS records are excluded from auto-linking.
      • No – The auto-linking of customer domains is turned off.
    • Invitation URL – This parameter will be available after creating the application instance. The value of the parameter is based on the value of the Reseller tenant ID parameter, so you do not need to set it manually. This parameter defines the URL of the page which is used for registering customers who already have Microsoft accounts. See the Registering New Customers with Existing Microsoft Accounts section for details.

    Click Next.

  5. Validate the parameters carefully and click Finish.