12.3 Installing the Connector for Office 365

You must install the connector for Office 365 on a Windows Management Server.

To configure the server and install the connector:

  1. Obtain the credentials for an Office 365 administrative account. For more information, see the Office 365 website.

  2. Add the federated domain name to Office 365 that will be used for single sign-on with CloudAccess and Office 365, and then validate the ownership. Use the instructions at the following web page: Add your users and domain to Office 365.

    NOTE: Microsoft requires that each Office 365 federated domain be configured with a unique issuer ID. Thus, the connector for Office 365 connects to only a single unique Office 365 federated domain.

  3. Verify that the Windows server where you plan to install the connector has the prerequisite software installed. For more information, see Section 12.2, Connector Requirements.

  4. As an administrator on the Windows server, perform the following steps. For more information, see the IIS Manager help. Alternatively, you can use an imported server certificate. For more information, see Importing a Server Certificate.

    1. Create a self-signed certificate in IIS Manager.

    2. Add an HTTPS binding for the Default Web Site using the certificate you created.

    3. Restart the IIS service.

  5. As an administrator on the Windows server, download the connector for Office 365 .zip file from NetIQ Downloads. Unzip the file and run the Windows netiq-office365-connector-x.x.x.msi installer. You will need the following information:

    • DNS name of the CloudAccess appliance.

    • Administrator name and password of the CloudAccess appliance.

    • User name and password for the Office 365 Global administrator account.

    • The federated domain name specified in Step 2. If you get an error during installation, ensure that you selected the correct domain name.

    Alternatively, you can run the connector installer in “silent mode” from the command line as follows:

    msiexec /i netiq-office365-connector-x.x.x.msi /qb /L*v install-log.txt AG4CHOSTNAME="Appliance_Admin_DNS" AG4CADMIN="Appliance_Admin_Name" AG4CADMINPASS="Appliance_Admin_Password" O365ADMIN="O365_Admin" O365ADMINPASS="O365_Password" O365FEDDOMAIN="Domain_DNS" O365USAGELOCATION="US" LOCALIP="Windows_Server_IP_Address" APPPOOLNAME_NT=".NET v4.5"

    By default, CloudAccess does not generate an installation log when you install the connector for Office 365. If you want a log of the installation, you must launch the installer from the command line using the following command:

    msiexec /i netiq-office365-connector-x.x.x.msi /L*V "C:\log\example.log"

    IMPORTANT:The connector for Office 365 installation location is c:\NetIQ\Office365Connector. You cannot change this location.

After you have installed the connector, when you return to the CloudAccess administration console, the connector for Office 365 icon is automatically moved to the Applications panel. No additional configuration is required, but you can configure appmarks for different Office 365 applications, and map users to the appropriate applications to set their entitlements. For more information about configuring appmarks, see Section 12.5, Configuring Appmarks for Office 365 Applications.