Up

Overview

The Up repository is a collection of script-based tools and resources to bootstrap access to ACT3 resources. This repository is intended for users who need to authenticate and configure their macOS, Ubuntu 22.04 or higher, or WSL2 (running Ubuntu 22.04 or higher) machines for ACT3 work.

The following are contained in this repo:

• ACT3 Login script
• DoD Certs script
• ASCE Tools installers
• Smart Card Reader script

Usage

ACT3 Login

The ACT3 Login script will automatically:

• Authenticate to a user-defined GitLab instance including:
  • Prompt for and validating your GitLab Personal Access Token
  • Create an SSH key and add it to GitLab
  • Enable secure credential storage for Git and container registry authentication
  • Enable Git commit signing with your SSH key
• Add Homebrew taps for public resources ACT3 teams use
• Add the ACT3 Homebrew tap (for access to public ACT3 software packages)
• Prompt to run the DoD Certs script

Important

Check the prerequisites before running.

Run the ACT3 Login script:

curl -fsSL https://raw.githubusercontent.com/act3-ai/up/refs/heads/main/act3-login/act3-login | bash

DoD Certs

Tip

Running the ACT3 Login script will prompt you to install DoD certs.

The DoD Certs script will automatically:

• Download the latest DoD certs from DoD Cyber Exchange ↗
• Verify the downloaded certs' integrity with a checksum
• Install DoD certs

After the DoD Certs script has run, you can access the certs in /usr/local/share/ca-certificates/DoD.

Note

Additional steps may be required to configure your browser with the DoD certs. After browser configuration, users should be able to access DoD Public Key Infrastructure (PKI)-protected information or applications for web sites that require a CAC for authentication. The Snap install of Firefox is not CAC compatible (see FAQ).

Run the DoD Certs script:

curl -fsSL https://raw.githubusercontent.com/act3-ai/up/refs/heads/main/dod-certs/dod-certs | bash

Get ASCE Tools

ASCE tools uses the ACT3 Homebrew tap and other public taps for public software packages ACT3 team members use.

Add the ACT3 Homebrew Tap:

Tip

Running the ACT3 Login script will add the ACT3 Homebrew Tap.

brew tap act3-ai/tap

Then, select one of the following options for installing ASCE Tools.

Install ASCE Tools:

brew asce-tools

Install ASCE Tools and VS Code extensions:

brew asce-tools --vscode

Smart Card Reader Setup

The Smart Card Reader script will automatically:

• Install:
  • OpenSC
  • Middleware libraries and tools required to read the CAC
  • CACKey
• Enable pcscd

Run the Enable Smart Card Reader script:

curl -fsSL https://raw.githubusercontent.com/act3-ai/up/refs/heads/main/smart-card-reader/enable-smart-card-reader | bash

Support

• Troubleshooting FAQ: consult a list of troubleshooting options and frequently asked questions
• Create a Support Ticket issue: create a support ticket issue on the Up GitHub project

Distribution Statement

Approved for public release: distribution unlimited.

Case Number

Date	Release Number	Description
2024	AFRL-2024-1007	Initial release