Psoxy for Worklytics Example - AWS

This is a template repo for a Terraform configuration that deploys the Worklytics pseudonymization proxy (psoxy) on AWS.

Usage

This is a template repo. To use it, follow the instructions below.

Prereqs

You'll need:

• a Bash-like shell environment on Linux, MacOS, or WSL on Windows.
• git installed, although it is usually included on those platforms (check with git --version).
• an AWS account and credentials, as described in Psoxy's AWS - Getting Started docs
• the prerequisites for Psoxy itself, although this example will attempt to help you check those.

Getting Started

See GitHub's documentation for more details.

1. Click the 'Use this template' button in the upper right corner of this page.

   • choose a name for your copy of this repo
   • leave "Include all branches" unchecked

2. Clone the resulting repo to your machine. Example command below, just fill in your org and repo names.

git clone https://github.com/{{YOUR_ORG_ID}}/{{YOUR_REPO_NAME}}.git

3. Check your prereqs. Review versions and install anything needed.

./check-prereqs

4. Authenticate your tools as needed:

• AWS CLI - aws get-caller-identity should work and return your expected account/user
• if plan to get data from Google Workspace, auth GCloud CLI - gcloud auth login to authenticate, then gcloud auth list to verify you have expected account/user
• if plan to get data from Microsoft 365, auth Azure CLI - az login --allow-no-subscription to authenticate, then az account list to verify you have expected account/user

5. Initialize your configuration

./init

6. Review your terraform.tfvars file and main.tf; customize as needed (eg, comment out datasources you don't need).

   In particular, if you're NOT using Google Workspace as a data source, remove (delete) the .tf files named google-*.tf AND references to values from those files from the main.tf file. (Our ./init script should have removed these for you)

   Similiarly, if you're NOT using Microsoft 365 as a data source, remove (delete) the .tf files named msft-365-*.tf AND references to values from those files from the main.tf file. (Our ./init script should have removed these for you)

7. Run terraform plan and review results to understand what will be created. Customize your terraform.tfvars or main.tf file if needed. (or push to your CI/CD system, if not running locally)

terraform plan

8. Run terraform apply to create the resources. (or push to your CI/CD system to do this automatically)

terraform apply

9. The above steps have created or modified various files that you should commit a code repository or otherwise preserve. In particular terraform.tfvars, main.tf, terraform.tfstate (if you ran terraform locally) and .terraform.lock.hcl should be preserved. Please do git add for each and then git commit to save your changes.

License

The source code contained in this repo is licensed under the Apache License, Version 2.0.

Usage of terraform, psoxy, or other tooling invoked by scripts in this repo or described in the example tutorials it contains are each subject to their own license terms.

Support

This example repo is maintained by Worklytics. Paid support is available. Please contact [email protected].