Skip to content

Latest commit

 

History

History
62 lines (46 loc) · 2.5 KB

installing.md

File metadata and controls

62 lines (46 loc) · 2.5 KB

Installing Splice

Requirements

  • A Go compiler to build the executables
  • A Google Cloud project
  • At least one domain joined Windows host inside the domain perimeter

Infrastructure Overview

The Splice design consists of three components, built on top of Google Cloud infrastructure services: Splice CLI, Splice App, and SpliceD.

The SpliceD native Windows service is installed inside the domain perimeter on one or more Windows servers. SpliceD is responsible for making the necessary API calls to handle the on-network portion of the join.

The Splice CLI is a standalone command line application that will run within the unjoined Windows client. It gathers the necessary information to initiate the domain join and posts a request to the Splice App.

The Splice App is a Google AppEngine application which runs on Google Cloud. The App receives join requests, performs internal request validation, and places the request in a datastore for processing. SpliceD is notified of a pending request, retrieves it from cloud storage, and performs the join. The join result propagates back out via the App to the CLI, where a final API call installs the join metadata. Following a reboot, the host is now joined to the domain.

Cloud Setup

  1. Follow the steps in the Splice App README to configure your Google Cloud project.
  2. Deploy the Splice App binary to AppEngine in your project.

SpliceD Setup

Review the SpliceD README for detailed information.

  1. Build and configure a dedicated Windows host to run SpliceD. This instance must already be domain joined.

  2. Copy the designated role account credentials from the Cloud Project to the server.

  3. Build the spliced.exe executable and install on the server.

  4. On the server, use the spliced.exe configure command line to add the daemon settings to the registry.

  5. Register spliced.exe as a system service:

    New-Service -Name SpliceD -BinaryPathName 'C:\Program Files\SpliceD\spliced_svc.exe' -Description 'The SpliceD domain joiner.' -StartupType Automatic

  6. Start the service, and confirm in the host Event Log that it is waiting for requests.

Client Setup

  1. Build the cli Go binary and copy to the Windows host, or bake into the installer.
  2. Run with the appropriate flags when ready to join.