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.

Setup

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 from the main.tf file.

7. Run terraform plan and review results to understand what will be created. Customize your terraform.tfvars or main.tf file if needed.

terraform plan

8. Run terraform apply to create the resources.

terraform apply

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 sales@worklytics.co.